ReadStructureElements Метод

Компонент: TPdf · Модуль: PDFium

Читает владеемый снимок дерева структуры с корнем на одной странице

Syntax

function ReadStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; out Status: TPdfStructureReadStatus): TPdfStructureElements;

Description

ReadStructureElements обходит тегированное дерево структуры для PageNumber (отсчитываемого от единицы) и возвращает самостоятельный массив TPdfStructureElements с типами, заголовками, MCID, индексами потомков и сведениями о ссылках

Status объясняет пустой результат, отделяя нетегированный документ от ограниченного или неудачного чтения

Remarks

Сначала используйте IsTagged, чтобы проверить, содержит ли документ дерево структуры вообще
Повторные чтения обслуживаются кэшем структуры; см. StructureCacheCapacity и StructureElementsForPage
Для очень глубоких деревьев предпочтителен VisitStructureElements, который передаёт посещения потоком вместо материализации всего массива

Example

var St: TPdfStructureReadStatus;
Elements := Pdf1.ReadStructureElements(1, Default(TPdfStructureReadOptions), St);