VisitStructureElements Метод

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

Передаёт дерево структуры одной страницы через обратный вызов посетителя

Syntax

function VisitStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; Visitor: TPdfStructureElementVisitor; out Status: TPdfStructureReadStatus): Integer;

Description

VisitStructureElements обходит дерево структуры страницы PageNumber (с единицы) и вызывает Visitor для каждого элемента вместо построения полного массива TPdfStructureElements

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

Remarks

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

Example

Count := Pdf1.VisitStructureElements(1, Options, procedure(const E: TPdfStructureElement)
begin
Log(E.TypeName);
end, Status);