VisitStructureElements Metod

Component: TPdf · Unit: PDFium

Skickar sidans strukturträd som en ström genom ett visitor-callback

Syntax

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

Description

VisitStructureElements går igenom strukturträdet för PageNumber (ettbaserat) och anropar Visitor för varje element i stället för att bygga upp hela TPdfStructureElements-fältet

Returvärdet är antalet besökta element; Status rapporterar avgränsade eller misslyckade läsningar på samma sätt som ReadStructureElements gör

Remarks

Strömning håller minnesanvändningen platt för djupa hierarkier som skulle svämma över en materialiserad ögonblicksbild
Visitorn tar emot ägda kopior av elementfakta, så inga nativa handtag läcker ut ur genomgången

Example

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