VisitStructureElements 方法

元件: TPdf · 單元: PDFium

以訪客回呼串流處理單一頁面的結構樹

Syntax

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

Description

VisitStructureElements 會走訪 PageNumber（以一為基底）的結構樹，並對每個元素呼叫 Visitor，而不是建置完整的 TPdfStructureElements 陣列

傳回值是已走訪的元素數量；Status 以與 ReadStructureElements 相同的方式回報有界或失敗的讀取

Remarks

對於會讓實體化快照溢位的深層階層，串流處理能讓記憶體用量保持平穩
訪客會收到元素資訊的擁有副本，因此原生控制代碼不會在走訪過程中外流

Example

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