PDFium Component Docs

IsTagged-egenskap

Komponent: TPdf  ·  Enhet: PDFium
Huruvida dokumentet deklarerar ett strukturträd för tillgänglighet

Syntax

property IsTagged: Boolean; // read only

Beskrivning

IsTagged returnerar True när dokumentkatalogen refererar till /StructTreeRoot — roten i PDF:ens logiska strukturträd (PDF 1.7 spec section 14.7). Taggade PDF:er kodar dokumentets läsordning, rubriknivåer, tabellstruktur, listor, alternativtext på bilder och annan semantisk märkning som skärmläsare, omflödesmotorer och innehållsextraherare förlitar sig på. PDF/UA-1- och PDF/A-2a/3a-överensstämmelse kräver båda taggad PDF

Egenskapen är False när Active är False, när inget strukturträd deklareras eller när strukturträdet finns men är tomt. Många PDF-filer i det vilda är inte taggade — särskilt skannade dokument, utskrifter från skrivardrivrutiner och export från verktyg före 2010. Stöd för taggad PDF i författarverktyg blir bättre men är fortfarande ojämnt

IsTagged är en billig huvudkontroll som lämpar sig för routningsbeslut: hoppa över extrahering av strukturträd för otaggade filer (den kommer helt enkelt att returnera tomma arrayer), eller visa en tillgänglighetsvarning för operatören. Det detaljerade trädet finns via StructureElements, som materialiserar trädet till en platt array av TPdfStructureElement-poster med nivå, föräldraindex, typnamn och roll

Anmärkningar

Exempel

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

Se även

StructureElements, Language, FormType