PDFium Component Docs

IsTagged Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Unit: PDFium
Geeft aan of het document een structure tree voor accessibility declareert

Syntaxis

property IsTagged: Boolean; // read only

Beschrijving

IsTagged geeft True terug wanneer de documentcatalogus verwijst naar een /StructTreeRoot — de root van de logische PDF-structuurboom (PDF 1.7 spec section 14.7). Tagged PDFs coderen de leesvolgorde van het document, kopniveaus, tabelstructuren, lijsten, alt-tekst op afbeeldingen en andere semantische markup waar screen readers, reflow-engines en content extractors op vertrouwen. PDF/UA-1 en PDF/A-2a/3a-compliance vereisen beide tagged PDF

De property is False wanneer Active False is, wanneer geen structuurboom is gedeclareerd of wanneer de structuurboom aanwezig maar leeg is Veel PDF's in het wild zijn niet tagged — vooral gescande documenten, uitvoer van print drivers en tool-exports van vóór 2010. De ondersteuning voor tagged PDF in authoring tools verbetert, maar is nog steeds ongelijkmatig

IsTagged is een goedkope header check, geschikt voor routing decisions: sla structure-tree-extractie over op untagged bestanden, want die geeft eenvoudigweg lege arrays terug, of toon de operator een accessibility warning. De gedetailleerde tree is beschikbaar via StructureElements, die de tree materialiseert in een platte array van TPdfStructureElement-records met level, parent index, type name en role

Opmerkingen

Voorbeeld

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.');

Zie ook

StructureElements, Language, FormType