IsTagged eigenschap

IsTagged retourneert True wanneer de documentcatalogus verwijst naar een /StructTreeRoot — de wortel van de logische structuurboom van de PDF (PDF 1.7-specificatie, sectie 14.7). Tagged PDF's coderen de leesvolgorde van het document, kopniveaus, tabelstructuur, lijsten, alt-tekst op afbeeldingen en andere semantische markeringen waarop schermlezers, reflux-engines en inhoudsextractoren vertrouwen. PDF/UA-1- en PDF/A-2a/3a-conformiteit vereisen beide tagged PDF.

De eigenschap is False wanneer Active False is, wanneer geen structuurboom is gedeclareerd, of wanneer de structuurboom aanwezig maar leeg is. Veel PDF's in de praktijk zijn niet tagged — vooral gescande documenten, print-driver-uitvoer en toolexports van vóór 2010. Ondersteuning voor tagged PDF in auteurstools verbetert, maar is nog steeds ongelijk.

IsTagged is een goedkope headercontrole, geschikt voor routeringsbeslissingen: sla structuurboomextractie over op niet-getagde bestanden (deze retourneert simpelweg lege arrays), of toon een toegankelijkheidswaarschuwing aan de bediener. De gedetailleerde boom is beschikbaar via StructureElements, dat de boom materialiseert in een platte array van TPdfStructureElement-records met niveau, bovenliggende index, typenaam en rol.

• PDF's die als tagged zijn gemarkeerd kunnen nog steeds alt-tekst op afbeeldingen missen of kopniveaus overslaan — IsTagged is een structurele test, geen kwaliteits test.
• Combineer met Language (/Lang) om de twee minimum-viable PDF/UA-controles uit te voeren voordat u met een volledig conformiteitshulpmiddel valideert.
• Het lezen van IsTagged parseert de boom zelf niet; het controleert slechts de catalogus op de aanwezigheid van /StructTreeRoot.