VisitStructureElements メソッド

コンポーネント: TPdf · ユニット: PDFium

1 つのページの構造ツリーをビジターコールバックへストリーミングします

構文

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

説明

VisitStructureElements は PageNumber (1 起点) の構造ツリーをたどり、完全な TPdfStructureElements 配列を組み立てる代わりに、要素ごとに Visitor を呼び出します

戻り値は訪問した要素の数です。Status は上限に達した読み取りや失敗した読み取りを、ReadStructureElements と同じ方法で報告します

備考

ストリーミングにより、実体化されたスナップショットでは溢れてしまう深い階層でもメモリ使用量が一定に保たれます
ビジターは要素の事実の所有権付きコピーを受け取るため、ネイティブハンドルが走査の外へ漏れることはありません

例

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