ReadStructureElements メソッド

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

1 ページをルートとする構造ツリーの所有型スナップショットを読み取ります

構文

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

説明

ReadStructureElements は PageNumber (1 始まり) のタグ付き構造ツリーをたどり、型、タイトル、MCID、子インデックス、参照情報を含む所有型の TPdfStructureElements 配列を返します

Status は空の結果の理由を説明し、タグのないドキュメントと、有界読み取りまたは失敗を区別します

備考

ドキュメントが構造ツリーを持つかどうかの確認は、まず IsTagged で行ってください
繰り返しの読み取りは構造キャッシュから供給されます。詳細は StructureCacheCapacity と StructureElementsForPage を参照してください
非常に深いツリーでは、配列全体を具体化せずに訪問をストリーミングする VisitStructureElements を推奨します

例

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