VisitStructureElements Metoda

Component: TPdf · Unit: PDFium

Przepuszcza drzewo struktury jednej strony przez wywołanie zwrotne odwiedzającego

Syntax

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

Description

VisitStructureElements przechodzi przez drzewo struktury strony PageNumber (numeracja od 1) i wywołuje Visitor dla każdego elementu, zamiast budować pełną tablicę TPdfStructureElements

Wartością zwrotną jest liczba odwiedzonych elementów; Status raportuje odczyty ograniczone lub nieudane tak samo, jak robi to ReadStructureElements

Remarks

Strumieniowanie utrzymuje pamięć na stałym poziomie przy głębokich hierarchiach, które przepełniłyby zmaterializowaną migawkę
Odwiedzający otrzymuje należące do niego kopie faktów elementów, więc żadne natywne uchwyty nie umykają z przechodzenia

Example

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