THotPDF.FindStructureElementForMCID Method
ページの /StructParents キーを読み、ドキュメントの ParentTree へ定数時間でインデックスすることで、指定された (ページ, MCID) のマークコンテンツシーケンスを所有する StructElem 辞書を解決します
宣言
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;ユニット
HPDFDoc
パラメータと戻り値
| 値 | 目的 |
|---|---|
PageIndex | 解決対象のマークコンテンツがあるページの 0 基点インデックス |
MCID | ページ上で出力され、AddStructureElement によって ParentTree へ接続されたマークコンテンツ識別子 |
| Result | 所有する間接 StructElem 辞書。ページがタグ付けされていない、スロットが空、いずれかの引数が範囲外の場合は nil |
動作
- ページの
/StructParents整数を読み、FParentTree[key][MCID]を直接返します。そのため検索は構造要素の数に依存しません - 間接 StructElem 参照は ParentTree 内ではリンクで包まれて保存されるため、このメソッドは戻る前にリンクをターゲット辞書へ解決します
- このメソッドは決して例外を投げません。タグなしページ、未割り当ての MCID、
/nullプレースホルダスロット、範囲外の引数はすべてnilになります - 戻り値の要素は
AddStructureElementが生成したものと同じ間接辞書で、AddStructureDestinationLinkの/SDターゲットとしてそのまま使えます