VisitStructureElements Método

Componente: TPdf · Unidade: PDFium

Transmite a árvore de estrutura de uma página por um callback de visitante

Syntax

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

Description

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

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

Remarks

O streaming mantém a memória plana para hierarquias profundas que transbordariam um snapshot materializado
O visitante recebe cópias de propriedade dos fatos dos elementos, de modo que nenhum handle nativo escapa da passagem

Example

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