PDFium Delphi Component Docs

VisitStructureElements Methode

Komponente: TPdf  ·  Unit: PDFium
Streamt den Strukturbaum einer Seite durch einen Visitor-Callback

Syntax

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

Beschreibung

VisitStructureElements durchläuft den Strukturbaum von PageNumber (auf 1 basierend) und ruft Visitor für jedes Element auf, statt das vollständige TPdfStructureElements-Array aufzubauen

Der Rückgabewert ist die Anzahl der besuchten Elemente; Status meldet begrenzte oder fehlgeschlagene Lesevorgänge auf dieselbe Weise wie ReadStructureElements

Hinweise

    • Streaming hält den Speicher flach für tiefe Hierarchien, die einen materialisierten Snapshot überlaufen lassen würden
    • Der Visitor erhält eigenständige Kopien der Elementfakten, sodass keine nativen Handles aus dem Durchlauf entkommen

Beispiel

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

Siehe auch