PDFium Delphi Component Docs

ReadStructureElements Methode

Komponente: TPdf  ·  Unit: PDFium
Liest einen eigenständigen Snapshot des Strukturbaums, der an einer Seite wurzelt

Syntax

function ReadStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; out Status: TPdfStructureReadStatus): TPdfStructureElements;

Beschreibung

ReadStructureElements durchläuft den Tagged-PDF-Strukturbaum für PageNumber (1-basiert) und gibt ein eigenständiges TPdfStructureElements-Array mit Typen, Titeln, MCIDs, Kindindizes und Referenzfakten zurück

Status erklärt ein leeres Ergebnis und trennt ein nicht getaggtes Dokument von einer begrenzten oder fehlgeschlagenen Lesung

Hinweise

    • Prüfen Sie zunächst mit IsTagged, ob das Dokument überhaupt einen Strukturbaum trägt
    • Wiederholte Lesevorgänge werden aus dem Struktur-Cache bedient; siehe StructureCacheCapacity und StructureElementsForPage
    • Für sehr tiefe Bäume ziehen Sie VisitStructureElements vor, das Besuche streamt, statt das gesamte Array zu materialisieren

Beispiel

var St: TPdfStructureReadStatus;
Elements := Pdf1.ReadStructureElements(1, Default(TPdfStructureReadOptions), St);

Siehe auch