PDFium Delphi Component Docs

IsTagged Proprietà

Componente: TPdf  ·  Unità: PDFium
Indica se il documento dichiara un albero di struttura per l'accessibilità

Syntax

property IsTagged: Boolean; // read only

Description

IsTagged restituisce True quando il catalogo del documento referenzia un /StructTreeRoot — la radice dell'albero della struttura logica PDF (sezione 14.7 della specifica PDF 1.7). I PDF taggati codificano l'ordine di lettura del documento, i livelli di intestazione, la struttura delle tabelle, gli elenchi, il testo alternativo delle immagini e altro markup semantico da cui dipendono screen reader, motori di reflow ed estrattori di contenuti. La conformità PDF/UA-1 e PDF/A-2a/3a richiedono entrambe un PDF taggato

La proprietà è False quando Active è False, quando non è dichiarato alcun albero di struttura, o quando l'albero di struttura è presente ma vuoto. Molti PDF in circolazione non sono taggati — in particolare i documenti scansionati, l'output dei driver di stampa e le esportazioni di tool anteriori al 2010. Il supporto Tagged-PDF negli strumenti di creazione sta migliorando ma resta disomogeneo

IsTagged è una verifica economica dell'intestazione, adatta a decisioni di instradamento: salta l'estrazione dell'albero di struttura sui file non taggati (restituirà semplicemente array vuoti), oppure mostra un avviso di accessibilità all'operatore. L'albero dettagliato è disponibile tramite StructureElements, che materializza l'albero in un array piatto di record TPdfStructureElement con livello, indice del genitore, nome del tipo e ruolo

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