AddArticleThread

Навигация по страницам, свойства документа

Описание

Создаёт одну PDF-цепочку статьи (article thread), чьи bead задают логический порядок чтения по одному или нескольким прямоугольникам страниц

Метод записывает массив /Threads каталога, запись /F нити, круговые ссылки бусин /N и /V, ссылки на страницы, прямоугольники и массив /B каждой страницы, как требует ISO 32000-1 §12.4.3

Синтаксис

Function TPDFlib.AddArticleThread(Const Info: TPDFlibArticleThreadInfo; Const Beads: Array Of TPDFlibArticleBead): Integer;

Параметры

Info	Необязательные метаданные: название, автор, тема, ключевые слова и дата создания PDF; `BeadCount` при записи игнорируется
Beads	Один или несколько прямоугольников страниц в порядке чтения статьи

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

Возвращает новый индекс цепочки статьи, начиная с 1, либо 0, если недопустимы документ, номер страницы, прямоугольник или существующий контейнер статьи

Примечания

Каждый прямоугольник использует немасштабированные координаты пользовательского пространства PDF в порядке лево, низ, право, верх

Входные данные проверяются до добавления объектов, повторные страницы переиспользуют стабильные ссылки на страницы, а выбранная страница сохраняется

DeletePages удаляет пустые нити и восстанавливает круговые ссылки выживших нитей

Пример

Info.Title := 'Feature story';
Info.Author := 'Editorial desk';
SetLength(Beads, 2);
Beads[0].Page := 1;
Beads[0].Left := 72;
Beads[0].Bottom := 360;
Beads[0].Right := 288;
Beads[0].Top := 720;
Beads[1].Page := 3;
Beads[1].Left := 72;
Beads[1].Bottom := 360;
Beads[1].Right := 288;
Beads[1].Top := 720;
ThreadIndex := PDF.AddArticleThread(Info, Beads);

См. также

AddLinkToArticleThread, SetOutlineArticleThread, ArticleThreadCount, GetArticleThreadInfo, GetArticleThreadBead, TPDFlibArticleThreadInfo, TPDFlibArticleBead