PDFium Delphi Component Docs

Language property

Component: TPdf  ·  Unit: PDFium
Identifikator prirodnog jezika deklarisan u katalogu dokumenta

Syntax

property Language: WString; // read / write

Description

Language čita i piše unos /Lang kataloga dokumenta (PDF 1.7 specifikacija, odeljak 14.9.2). String prati sintaksu jezičke oznake RFC 3066 / BCP 47 — en, en-US, zh-Hans, ja-JP itd. Čitači ekrana i alati pristupačnosti (PDF/UA, JAWS, NVDA) koriste ovu oznaku da izaberu ispravan motor izgovora pri naglasnom čitanju tagovanog teksta

Vraća prazan string kada je Active False ili kada dokument ne deklariše /Lang. Dodeljivanje nove vrednosti odmah ažurira katalog ali se promena trajno čuva tek sledećim pozivom SaveToFile / SaveToStream. Jezička prepisivanja na nivou spana za pojedinačne elemente strukture teksta (postavljena kroz unos /Lang u rečniku elementa strukture) ovo svojstvo ne izlaže

Language je nezavisno od kodiranja korišćenog za tekstualni sadržaj — PDFium uvek dekodira znakovne podatke u UTF-16, bez obzira na jezik. Oznaka je čisti metapodatak, glavno relevantna za tagovane / PDF-UA pristupačne dokumente i za indeksne motore koji usmeravaju izdvojeni tekst kroz jezički specifične tokenizatore

Remarks

Example

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

See Also

IsTagged, MetaText, Title, StructureElements