Método VisitStructureElements

Componente: TPdf · Unidade: PDFium

Percorre em streaming a árvore de estrutura de uma página através de um callback de visitante

Syntax

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

Description

O VisitStructureElements percorre a árvore de estrutura de PageNumber (base 1) e chama Visitor para cada elemento, em vez de construir o array TPdfStructureElements completo

O valor de retorno é o número de elementos visitados; Status reporta leituras limitadas ou falhadas da mesma forma que ReadStructureElements

Remarks

O streaming mantém a memória contida em hierarquias profundas que transbordariam um snapshot materializado
O visitante recebe cópias geridas das informações dos elementos, pelo que nenhum handle nativo escapa ao percurso

Example

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