PDFium Delphi Component 文件

VisitStructureElements 方法

组件: TPdf  ·  单元: PDFium
通过访问者回调流式处理单个页面的结构树

语法

function VisitStructureElements(PageNumber: Integer; const Options: TPdfStructureReadOptions; Visitor: TPdfStructureElementVisitor; out Status: TPdfStructureReadStatus): Integer;

说明

VisitStructureElements 遍历 PageNumber（从 1 开始）的结构树，并为每个元素调用 Visitor，而不是构建完整的 TPdfStructureElements 数组

返回值是已访问元素的数量；Status 以与 ReadStructureElements 相同的方式报告有界读取或失败读取

备注

    • 对于会溢出实体化快照的深层层次结构，流式处理可以保持内存平稳
    • 访问者接收元素事实的独有副本，因此不会有本机句柄逃离遍历

示例

Count := Pdf1.VisitStructureElements(1, Options, procedure(const E: TPdfStructureElement)
begin
  Log(E.TypeName);
end, Status);

参见

ReadStructureElements, StructureElements, Structure traversal