SetAutoTagMode

Структурированный PDF

Описание

Turns on structure tagging that ordinary drawing calls carry by themselves.

Синтаксис

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Параметры

Возвращаемые значения

Примечания

При включенном тегировании текста текст тегируется как абзац, а текст, нарисованный сразу после RegisterHeading, — как заголовок этого уровня. При включенной пометке оформления бегущие колонтитулы помечаются артефактами, чтобы читатель их пропускал, а не озвучивал одну и ту же строку на каждой странице

При включенном тегировании фигур нарисованное изображение становится фигурой с описанием, оставленным RegisterFigure, либо рисуется внутри макетного артефакта, когда RegisterDecoration сказал, что смысла оно не несет

При включенном тегировании таблиц DrawTableRows переносит таблицу, ее строки и ячейки в дерево структуры. Строки, названные в SetTableHeaderRowCount, становятся ячейками заголовков

Включение режима также помечает документ как тегированный; без этой пометки читалка считает структуру отсутствующей, поэтому тегированный без неё документ выглядит как вовсе без структуры

Автотегирование не вмешивается в тег, открытый через BeginTag: пока вызывающий сам описывает структуру, внутрь открытого им ничего не вкладывается. Оно также никогда не тегирует внутри артефакта, где структурный элемент сделал бы файл некорректным, и никогда не открывает элемент для пустого текста, который читатель озвучил бы как пробел

Режим принадлежит экземпляру библиотеки, а не документу

Пример

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

См. также

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount