ReadPageObjectsSnapshot methode

Component: TPdf · Unit: PDFium

Leest een eigen, handle-vrije snapshot van elk paginaobject op één pagina

Syntax

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

Description

ReadPageObjectsSnapshot kopieert type-, bounds-, transform-, tekst-, mark- en dependency-kenmerken van alle paginaobjecten van één pagina naar een eigen TPdfPageObjectsSnapshot die geen native FPDF_PAGEOBJECT-handles bevat

PageNumber is ééngebaseerd; Status rapporteert waarom een lege snapshot terugkwam, zodat aanroepers een ontbrekende pagina kunnen onderscheiden van een begrensde leesactie

Remarks

Omdat de snapshot eigenaar is van zijn strings en arrays, blijft die geldig nadat het document is gesloten of opnieuw geladen
Herhaalde leesacties worden bediend vanuit de page-object-snapshotcache; zie PageObjectSnapshotCacheCapacity
Gebruik PageObjectsSnapshot om de snapshot uit de cache van de huidige pagina te lezen

Example

Inspecteer alle objecten van een pagina buiten elke rendering-callback om

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