PDFium Delphi Component Docs

Language svojstvo

Komponenta: TPdf  ·  Jedinica: PDFium
Identifikator prirodnog jezika deklariran u katalogu dokumenta.

Sintaksa

property Language: WString; // read / write

Opis

Language čita i zapisuje unos /Lang iz kataloga dokumenta (odjeljak 14.9.2 specifikacije PDF 1.7). Niz slijedi sintaksu jezičnih oznaka RFC 3066 / BCP 47 — en, en-US, zh-Hans, ja-JP itd. Čitači zaslona i alati pristupačnosti (PDF/UA, JAWS, NVDA) koriste tu oznaku za odabir ispravnog mehanizma izgovora prilikom glasovnog čitanja označenog teksta

Vraća prazan niz kada je Active False ili kada dokument ne deklarira /Lang. Dodjeljivanje nove vrijednosti odmah ažurira katalog, ali se promjena trajno zapisuje tek sljedećim pozivom SaveToFile / SaveToStream. Jezična nadjačavanja na razini raspona pojedinačnih elemenata strukture teksta (postavljena unosom /Lang u rječniku elementa strukture) ovo svojstvo ne izlaže

Language je neovisan o kodiranju sadržaja teksta — PDFium uvijek dekodira znakovne podatke u UTF-16, neovisno o jeziku. Oznaka je čisto metapodatak, uglavnom relevantan za označene / PDF-UA pristupačne dokumente i za indeksne pogone koji provode izdvojeni tekst kroz jezično specifične tokenizatore

Napomene

Primjer

if Pdf1.Language = '' then
begin
  Pdf1.Language := 'en-US';
  Pdf1.SaveToFile('tagged.pdf');
end
else
  Label1.Caption := 'Document language: ' + Pdf1.Language;

Vidi također

IsTagged, MetaText, Title, StructureElements