PDFium Delphi Component Docs

IsTagged Свойство

Компонент: TPdf  ·  Модуль: PDFium
Указывает, объявляет ли документ дерево структуры для доступности

Syntax

property IsTagged: Boolean; // read only

Description

IsTagged возвращает True, когда каталог документа ссылается на /StructTreeRoot — корень дерева логической структуры PDF (раздел 14.7 спецификации PDF 1.7). Tagged PDF кодируют порядок чтения документа, уровни заголовков, структуру таблиц, списки, alt-text у изображений и прочую семантическую разметку, на которую опираются скринридеры, reflow-движки и извлекатели контента. Соответствие 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