PDFium Delphi Component Docs

IsTagged властивість

Component: TPdf  ·  Unit: PDFium
Описує властивість TPdf.IsTagged у PDFium Delphi Component і пояснює, коли використовувати цей член API

Syntax

property IsTagged: Boolean; // read only

Description

IsTagged повертає True, коли каталог документа посилається на /StructTreeRoot — корінь логічного дерева структури PDF (розділ 14.7 специфікації PDF 1.7). Tagged PDF кодують порядок читання документа, рівні заголовків, структуру таблиць, списки, альтернативний текст на зображеннях та іншу семантичну розмітку, на яку спираються програми читання з екрана, рушії переформатування та засоби вилучення вмісту. Відповідність PDF/UA-1 і PDF/A-2a/3a обидві потребують tagged PDF

Властивість дорівнює False, коли Active дорівнює False, коли жодного дерева структури не оголошено або коли дерево структури наявне, але порожнє Багато PDF у світі не є tagged — особливо скановані документи, вивід драйверів друку та експорти з інструментів до 2010 року. Підтримка Tagged PDF у засобах створення документів покращується, але досі нерівномірна

IsTagged — це дешева перевірка заголовка, придатна для рішень маршрутизації: пропускайте вилучення дерева структури для файлів без тегів (воно просто поверне порожні масиви) або показуйте попередження про доступність оператору. Детальне дерево доступне через StructureElements, який матеріалізує дерево у плоский масив записів TPdfStructureElement із рівнем, індексом батьківського елемента, назвою типу та роллю

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