PDFium Delphi Component 文件

ReadPageObjectsSnapshot 方法

组件: TPdf  ·  单元: PDFium
读取某一页上所有页面对象的归调用方所有、无句柄的快照

语法

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

说明

ReadPageObjectsSnapshot 将某一页所有页面对象的类型、边界、变换、文本、标记和依赖事实复制到归调用方所有的 TPdfPageObjectsSnapshot 中,其中不包含任何原生 FPDF_PAGEOBJECT 句柄

PageNumber 从 1 开始计数;Status 报告返回空快照的原因,使调用方能够区分页面缺失与有界读取截断

备注

    • 由于快照拥有自己的字符串和数组,因此在文档关闭或重新加载后仍然有效
    • 重复读取由页面对象快照缓存提供服务;参见 PageObjectSnapshotCacheCapacity
    • 使用 PageObjectsSnapshot 读取当前页面的缓存快照

示例

在任何渲染回调之外检查某一页的所有对象

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

参见