property Language: WString; // read / write
Language legge e scrive la voce /Lang del catalogo del documento
(sezione 14.9.2 della specifica PDF 1.7). La stringa segue la sintassi dei language tag RFC 3066 / BCP 47 — en, en-US, zh-Hans,
ja-JP ecc. Screen reader e strumenti di accessibilità (PDF/UA, JAWS, NVDA)
usano questo tag per scegliere il motore di pronuncia corretto quando leggono ad alta voce il testo taggato
Restituisce una stringa vuota quando Active è False o quando il
documento non dichiara /Lang. Assegnare un nuovo valore aggiorna il catalogo
subito ma la modifica viene persistita solo dalla successiva chiamata a SaveToFile /
SaveToStream. Le override di lingua a livello di span sui singoli elementi di
struttura (impostate tramite la voce /Lang nel dizionario dell'elemento di
struttura) non sono esposte da questa proprietà
Language è indipendente dalla codifica usata per il contenuto testuale — PDFium decodifica sempre i dati carattere in UTF-16, indipendentemente dalla lingua. Il tag è puro metadato, rilevante soprattutto per i documenti accessibili taggati / PDF-UA e per i motori di indicizzazione che instradano il testo estratto a tokenizzatori specifici per lingua
/Lang valida. Impostare Language è la correzione di una riga quando validi un
PDF taggatoIsTagged per rilevare se il documento dichiara un
albero di accessibilitàen-US, non EN-us). PDFium Delphi Component preserva il maiuscolo/minuscolo
alla lettera
if Pdf1.Language = '' then
begin
Pdf1.Language := 'en-US';
Pdf1.SaveToFile('tagged.pdf');
end
else
Label1.Caption := 'Document language: ' + Pdf1.Language;