IsTagged Eigenschaft

IsTagged liefert True, wenn der Dokumentkatalog einen /StructTreeRoot referenziert — die Wurzel des logischen PDF-Strukturbaums (PDF 1.7 spec section 14.7). Tagged PDFs kodieren die Lesereihenfolge des Dokuments, Überschriftenebenen, Tabellenstruktur, Listen, Alt-Text an Bildern und anderes semantisches Markup, auf das Screenreader, Reflow-Engines und Content-Extraktoren setzen. PDF/UA-1 und PDF/A-2a/3a-Konformität verlangen beide ein tagged PDF

Die Eigenschaft ist False, wenn Active False ist, wenn kein Strukturbaum deklariert ist oder wenn der Strukturbaum vorhanden, aber leer ist Viele PDFs in freier Wildbahn sind nicht getaggt — besonders gescannte Dokumente, Druckertreiber-Ausgaben und Werkzeug-Exporte aus der Zeit vor 2010. Die Tagged-PDF-Unterstützung in Autoren-Werkzeugen wird besser, ist aber weiterhin unausgewogen

IsTagged ist ein billiger Header-Check, geeignet für Routing-Entscheidungen: Strukturbaum-Extraktion bei ungetaggten Dateien überspringen (liefert schlicht leere Arrays), oder eine Accessibility-Warnung an den Bediener ausgeben. Der detaillierte Baum ist über StructureElements verfügbar, das den Baum in ein flaches Array von TPdfStructureElement-Records mit Ebene, Elternindex, Typname und Rolle materialisiert

• Als getaggt markierte PDFs können trotzdem Alt-Text an Bildern vermissen lassen oder Überschriften- ebenen überspringen — IsTagged ist ein struktureller Test, kein Qualitätstest
• Mit Language (/Lang) kombinieren, um die beiden Mindest-PDF/UA-Prüfungen auszuführen, bevor mit einem vollständigen Konformitäts-Werkzeug validiert wird
• Das Lesen von IsTagged parst den Baum nicht selbst; es prüft den Katalog nur auf das Vorhandensein von /StructTreeRoot