PDFium Delphi Component Docs

Language Propriété

Composant: TPdf  ·  Unit: PDFium
Identifiant de langue naturelle déclaré dans le catalogue du document

Syntax

property Language: WString; // read / write

Description

Language lit et écrit l’entrée /Lang (spécification PDF 1.7, section 14.9.2). La chaîne suit la syntaxe des étiquettes de langue RFC 3066 / BCP 47 — en, en-US, zh-Hans, ja-JP, etc. Les lecteurs d’écran et les outils d’accessibilité (PDF/UA, JAWS, NVDA) utilisent cette étiquette pour choisir le moteur de prononciation correct quand ils lisent à voix haute du texte balisé

Renvoie une chaîne vide quand Active vaut False ou lorsque le document ne déclare pas /Lang. L’attribution d’une nouvelle valeur met à jour le catalogue immédiatement, mais la modification n’est persistée qu’au prochain appel de SaveToFile / SaveToStream. Les surcharges de langue au niveau des spans sur des éléments de structure de texte individuels (définies via l’entrée /Lang dans un dictionnaire d’élément de structure) ne sont pas exposées par cette propriété

Language est indépendant de l’encodage utilisé pour le contenu texte — PDFium décode toujours les données de caractères en UTF-16, quelle que soit la langue. L’étiquette est purement une métadonnée, surtout pertinente pour les documents balisés / accessibles PDF-UA et pour les moteurs d’indexation qui routent le texte extrait vers des tokeniseurs spécifiques à la langue

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