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 は新しいキーをカバーするよう広げられます。そのためビューアはリーフへの二分探索を使い続けられます
- 既存のキーを挿入すると、重複を追加する代わりにその値を置き換えます
- 降下経路上のすべてのノードが dirty としてマークされるため、変更は次の保存またはインクリメンタル更新で書き戻されます