PDFium Delphi Component 文件

ReadStructureElements 方法

组件: TPdf  ·  单元: PDFium
读取以某一页为根的结构树的归调用方所有快照

语法

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

说明

ReadStructureElements 遍历 PageNumber（从 1 开始计数）对应的标记结构树，返回归调用方所有的 TPdfStructureElements 数组，其中包含类型、标题、MCID、子元素索引和引用事实

Status 解释空结果的成因，将未标记文档与有界截断或失败的读取区分开来

备注

    • 先用 IsTagged 检查文档是否带有结构树
    • 重复读取由结构缓存提供服务；参见 StructureCacheCapacity 和 StructureElementsForPage
    • 对于非常深的树，优先使用 VisitStructureElements，它以流式方式访问而不是具体化整个数组

示例

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

参见

VisitStructureElements, StructureElementsForPage, IsTagged, 结构遍历