PDFium Delphi Component Docs

Language Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Im Dokumentkatalog deklarierter natürlicher Sprachbezeichner

Syntax

property Language: WString; // read / write

Description

Language liest und schreibt den /Lang-Eintrag des Dokumentkatalogs (PDF 1.7 spec section 14.9.2). Die Zeichenkette folgt der RFC 3066 / BCP 47 Language-Tag- Syntax — en, en-US, zh-Hans, ja-JP usw. Screenreader und Accessibility-Werkzeuge (PDF/UA, JAWS, NVDA) verwenden dieses Tag, um beim Vorlesen von getaggtem Text die richtige Aussprache-Engine zu wählen

Liefert eine leere Zeichenkette, wenn Active False ist oder das Dokument kein /Lang deklariert. Eine neue Zuweisung aktualisiert den Katalog sofort, persistiert wird die Änderung aber erst beim nächsten SaveToFile- / SaveToStream-Aufruf. Sprach-Overrides auf Span-Ebene an einzelnen Text- Strukturelementen (gesetzt über den /Lang-Eintrag im Dictionary eines Strukturelements) legt diese Eigenschaft nicht offen

Language ist unabhängig von der Kodierung des Textinhalts — PDFium dekodiert Zeichendaten immer nach UTF-16, gleich welcher Sprache. Das Tag ist reine Metadaten, vor allem relevant für getaggte / PDF/UA-zugängliche Dokumente und für Indexierungs-Engines, die extrahierten Text durch sprachspezifische Tokenizer schicken

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