THotPDF.GetLoadedNameTree Method
从 catalog /Names 字典取出已加载文档的名称树类别字典,首次使用时可选自动创建
声明
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
Category | catalog /Names 字典里的名称树类别键,例如 Dests、JavaScript 或 EmbeddedFiles |
CreateMissing | 两者有缺失时,True 把 /Names 字典和类别字典创建为新的间接对象;False 则返回 nil |
返回值
解析得到的类别字典;类别缺失且 CreateMissing 为 False 时返回 nil,文档没有已加载 catalog 时同样返回 nil
使用说明
- 创建时若 /Names 条目不是字典,会直接替换而不是失败,catalog 和 /Names 字典都会标记为脏,改动随下一次增量更新或保存落盘
- 返回的字典是名称树的根节点;遍历或编辑请走
InsertLoadedNameTreeEntry和RemoveLoadedNameTreeEntry,键序才能保持有效 - 只想枚举现有类别而不创建任何东西时,用
GetLoadedNameTreeRootCount