THotPDF.FindStructureElementForMCID Method
通过读取页面的 /StructParents 键并以常数时间索引文档的 ParentTree，解析出拥有指定（页面, MCID）marked-content 序列的 StructElem 字典
声明
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;单元
HPDFDoc
参数与结果
| 值 | 用途 |
|---|---|
PageIndex | Zero-based page index whose marked content is being resolved |
MCID | 页面上输出并由 AddStructureElement 接入 ParentTree 的 marked-content 标识符 |
| 结果 | 拥有该序列的间接 StructElem 字典；页面未加标签、槽位为空或任一参数越界时为 nil |
行为
- 读取页面的
/StructParents整数，然后直接返回FParentTree[key][MCID]，因此查找耗时与结构元素数量无关 - 间接 StructElem 引用在 ParentTree 中被包在一个 link 里存放；该方法会先把 link 解析为目标字典再返回
- 该方法绝不抛出异常：页面未加标签、MCID 未分配、槽位为
/null占位符或参数越界，都会一律返回nil - 返回的元素就是
AddStructureElement生成的同一个间接字典，可用作/SD目标，交给AddStructureDestinationLink使用