property Language: WString; // read / write
Language liest und schreibt den /Lang-Eintrag des Dokumentkatalogs
(PDF 1.7 spec section 14.9.2). Die Zeichenkette folgt der Syntax für Sprach-Tags nach
RFC 3066 / BCP 47 — en, en-US, zh-Hans,
ja-JP usw. Bildschirmleser und Barrierefreiheitswerkzeuge (PDF/UA, JAWS,
NVDA) verwenden dieses Tag, um beim Vorlesen von getaggtem Text die richtige
Aussprache-Engine zu wählen.
Gibt eine leere Zeichenkette zurück, wenn Active False ist
oder das Dokument /Lang nicht deklariert. Das Zuweisen eines neuen Werts
aktualisiert den Katalog sofort, aber die Änderung wird erst durch den nächsten
SaveToFile / SaveToStream-Aufruf dauerhaft gespeichert.
Sprachüberschreibungen auf Span-Ebene bei einzelnen Textstruktur-Elementen (gesetzt
über den /Lang-Eintrag eines Struktur-Element-Wörterbuchs) werden von
dieser Eigenschaft nicht offengelegt.
Language ist unabhängig von der für Textinhalt verwendeten Kodierung — PDFium dekodiert Zeichendaten immer zu UTF-16, unabhängig von der Sprache. Das Tag ist rein Metadaten und vor allem für getaggte / PDF-UA-barrierefreie Dokumente sowie für Indexierungs-Engines relevant, die extrahierten Text über sprachspezifische Tokenizer routen.
/Lang-Eintrag deklarieren. Das Setzen von Language ist eine
Einzeilen-Korrektur beim Validieren eines getaggten PDFsIsTagged, um festzustellen, ob das Dokument
überhaupt einen Barrierefreiheitsbaum ankündigten-US, nicht EN-us)
PDFiumPas bewahrt die Schreibweise unverändert
if Pdf1.Language = '' then
begin
Pdf1.Language := 'en-US';
Pdf1.SaveToFile('tagged.pdf');
end
else
Label1.Caption := 'Document language: ' + Pdf1.Language;