THotPDF.FindStructureElementForMCID Method
讀取頁面的 /StructParents 鍵值並以常數時間索引文件 ParentTree,找出擁有指定 (page, MCID) marked-content 序列的 StructElem 字典
宣告
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;
單元
HPDFDoc
參數與結果
| 值 | 用途 |
|---|---|
PageIndex | 要解析 marked content 的頁面索引(從零起算) |
MCID | 頁面上發出的 marked-content 識別碼,由 AddStructureElement 接入 ParentTree |
| Result | 擁有該 MCID 的間接 StructElem 字典;頁面未加標籤、插槽為空或任一引數超出範圍時傳回 nil |
行為
- 讀取頁面的
/StructParents整數後直接傳回FParentTree[key][MCID],查詢成本與結構元素數量無關 - 間接 StructElem 參照在 ParentTree 中以 link 包裹存放;本方法會在傳回前把 link 解析到目標字典
- 本方法不會拋出例外:未加標籤的頁面、未配置的 MCID、
/null佔位插槽或超出範圍的引數,一律歸結為nil - 傳回的元素就是
AddStructureElement產生的同一個間接字典,適合作為AddStructureDestinationLink的/SD目標