PDFiumPas 文件

IsTagged 屬性

此 API 條目保留識別符號、簽名、程式碼塊和 PDF 術語的原始形式
元件: TPdf  ·  單元: PDFium
文件是否宣告了無障礙用的結構樹

語法

property IsTagged: Boolean; // 唯讀

說明

IsTagged 在文件 catalog 參照 /StructTreeRoot 時回傳 True — 這是 PDF 邏輯結構樹的根（PDF 1.7 規範第 14.7 節）。標記 PDF 會記錄文件的閱讀順序、標題層級、表格結構、清單、影像替代文字，以及螢幕閱讀器、重排引擎與內容擷取器所依賴的其他語意標記。PDF/UA-1 與 PDF/A-2a/3a 的相容性都要求標記 PDF

當 Active 為 False、未宣告結構樹，或結構樹存在但為空時，這個屬性為 False。實務上的許多 PDF 並不是標記的 — 尤其是掃描文件、列印驅動程式輸出，以及 2010 年以前工具匯出的檔案。作者工具對標記 PDF 的支援正在改善，但仍不一致

IsTagged 是便宜的標頭檢查，適合用來做路由判斷：對未標記檔案略過結構樹擷取（它只會回傳空陣列），或向操作員顯示無障礙警告。詳細樹狀結構可透過 StructureElements 取得，它會把樹具體化為平面陣列的 TPdfStructureElement record，包含層級、父項索引、型別名稱與角色

備註

範例

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

另請參閱

StructureElements, Language, FormType