PDFium Delphi Component Docs

IsTagged Propriété

Composant: TPdf  ·  Unit: PDFium
Si le document déclare un arbre de structure pour l’accessibilité

Syntax

property IsTagged: Boolean; // read only

Description

IsTagged renvoie True quand le catalogue du document référence un /StructTreeRoot — la racine de l’arbre de structure logique du PDF (spécification PDF 1.7, section 14.7). Les PDF balisés encodent l’ordre de lecture du document, les niveaux de titres, la structure des tableaux, les listes, le texte de remplacement des images et d’autres balisages sémantiques dont dépendent les lecteurs d’écran, les moteurs de reflow et les extracteurs de contenu. La conformité PDF/UA-1 et PDF/A-2a/3a exige toutes deux un PDF balisé

La propriété vaut False quand Active vaut False, lorsqu’aucun arbre de structure n’est déclaré, ou lorsque l’arbre de structure est présent mais vide. Beaucoup de PDF réels ne sont pas balisés — en particulier les documents numérisés, les sorties de pilotes d’impression et les exports d’outils d’avant 2010. La prise en charge du PDF balisé dans les outils de création progresse mais reste inégale

IsTagged est une vérification d’en-tête peu coûteuse, adaptée aux décisions de routage : sautez l’extraction de l’arbre de structure sur les fichiers non balisés (cela renverra simplement des tableaux vides), ou affichez un avertissement d’accessibilité à l’opérateur. L’arbre détaillé est disponible via StructureElements, qui matérialise l’arbre en un tableau plat d’enregistrements TPdfStructureElement avec niveau, index parent, nom de type et rôle

Remarks

Example

if not Pdf1.IsTagged then
  Log.Add('Warning: PDF is not tagged. Screen-reader output will be unreliable.');
if Pdf1.IsTagged and (Pdf1.Language = '') then
  Log.Add('Tagged PDF without /Lang - fails PDF/UA.');

See Also

StructureElements, Language, FormType