property Language: WString; // read / write
Language odczytuje i zapisuje wpis /Lang katalogu dokumentu (sekcja 14.9.2 specyfikacji PDF 1.7). Łańcuch stosuje składnię tagów językowych RFC 3066 / BCP 47 — en, en-US, zh-Hans, ja-JP itd. Czytniki ekranu i narzędzia dostępności (PDF/UA, JAWS, NVDA) używają tego tagu, aby wybrać właściwy silnik wymowy przy głośnym czytaniu oznaczonego tekstu
Zwraca pusty łańcuch, gdy Active ma wartość False albo gdy dokument nie deklaruje /Lang Nadanie nowej wartości aktualizuje katalog natychmiast, ale zmiana zostaje utrwalona dopiero przez następne wywołanie SaveToFile / SaveToStream Nadpisania języka na poziomie fragmentu w poszczególnych elementach struktury tekstowej (ustawiane przez wpis /Lang na elemencie struktury dictionary) nie są ujawniane przez tę właściwość
Language jest niezależny od kodowania użytego dla treści tekstowej — PDFium zawsze dekoduje dane znakowe do UTF-16, niezależnie od języka. Ten tag to czyste metadane, istotne głównie dla otagowanych dokumentów dostępnych PDF/UA oraz dla silników indeksujących, które kierują wyekstrahowany tekst przez tokenizery zależne od języka
/Lang. Ustawienie Language to poprawka w jednym wierszu podczas walidacji otagowanego PDFIsTagged, aby wykryć, czy dokument w ogóle deklaruje drzewo dostępnościen-US, a nie EN-us). PDFiumPas zachowuje wielkość liter bez zmian
if Pdf1.Language = '' then
begin
Pdf1.Language := 'en-US';
Pdf1.SaveToFile('tagged.pdf');
end
else
Label1.Caption := 'Document language: ' + Pdf1.Language;