THotPDF.InsertLoadedNameTreeEntry Method
向已加载名称树插入一个键/值对,并让每个叶子按 ISO 32000-1 7.9.6 保持有序
声明
procedure InsertLoadedNameTreeEntry(Tree: THPDFDictionaryObject;
const Key: AnsiString; Value: THPDFObject);
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
Tree | 名称树根节点,通常取自 GetLoadedNameTree |
Key | 条目的排序键字符串 |
Value | 为该键存储的 PDF 对象;树只负责插入定位,对象仍留在已加载对象图里 |
返回值
该成员不返回值
使用说明
- 带 /Kids 的树会沿各节点的 /Limits 下行,沿途的 limits 会加宽以覆盖新键,查看器因此仍能对叶子做二分查找
- 插入既有键会替换其值,而不是追加重复条目
- 下行路径上的每个节点都标记为脏,改动由下一次保存或增量更新写回