ReadPageObjectsSnapshot 方法

元件: TPdf · 單元: PDFium

讀取單一頁面上每個頁面物件的自主快照，其中不含任何控制代碼

Syntax

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

Description

ReadPageObjectsSnapshot 會將一頁所有頁面物件的類型、邊界、轉換、文字、標記與相依性資訊，複製到自主擁有的 TPdfPageObjectsSnapshot，其中不含任何原生 FPDF_PAGEOBJECT 控制代碼

PageNumber 以一為基底；Status 會回報傳回空快照的原因，讓呼叫端能夠區分頁面不存在與有界讀取

Remarks

由於快照擁有自己的字串與陣列，即使在文件關閉或重新載入後仍然有效
重複讀取會由頁面物件快照快取提供服務；請參閱 PageObjectSnapshotCacheCapacity
使用 PageObjectsSnapshot 讀取目前頁面的快取快照

Example

在任何算繪回呼之外檢查頁面的所有物件

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