PDFium Delphi Component Docs

ReadPageObjectsSnapshot Methode

Komponente: TPdf  ·  Unit: PDFium
Liest einen eigenständigen, handle-freien Snapshot aller Seitenobjekte einer Seite

Syntax

function ReadPageObjectsSnapshot(PageNumber: Integer; const Options: TPdfPageObjectSnapshotOptions; out Status: TPdfPageObjectSnapshotStatus): TPdfPageObjectsSnapshot;

Beschreibung

ReadPageObjectsSnapshot kopiert Typ-, Begrenzungs-, Transformations-, Text-, Marken- und Abhängigkeitsfakten aller Seitenobjekte einer Seite in einen eigenständigen TPdfPageObjectsSnapshot, der keine nativen FPDF_PAGEOBJECT-Handles enthält

PageNumber ist 1-basiert; Status meldet, warum ein leerer Snapshot zurückkam, sodass Aufrufer eine fehlende Seite von einer begrenzten Lesung unterscheiden können

Hinweise

    • Da der Snapshot seine Strings und Arrays besitzt, bleibt er gültig, nachdem das Dokument geschlossen oder neu geladen wurde
    • Wiederholte Lesevorgänge werden aus dem Seitenobjekt-Snapshot-Cache bedient; siehe PageObjectSnapshotCacheCapacity
    • Verwenden Sie PageObjectsSnapshot, um den zwischengespeicherten Snapshot der aktuellen Seite zu lesen

Beispiel

Prüfen Sie alle Objekte einer Seite außerhalb eines Rendering-Callbacks

var Snap: TPdfPageObjectsSnapshot; Status: TPdfPageObjectSnapshotStatus;
Doc := Pdf1.ReadPageObjectsSnapshot(1, Default(TPdfPageObjectSnapshotOptions), Status);

Siehe auch

PageObjectsSnapshot, PageObjectSnapshotCacheCapacity, ReadTextPageSnapshot, Seitenobjekt-Snapshots