THotPDF.GetLoadedNameTree Method
カタログの /Names ディクショナリーから、読み込み済みドキュメントのネームツリーカテゴリーのディクショナリーを返します。初めて使うときに作成することもできます
宣言
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;ユニット
HPDFDoc
パラメータ
| 名前 | 目的 |
|---|---|
Category | カタログの /Names ディクショナリーにおけるネームツリーカテゴリーのキー。たとえば Dests、JavaScript、EmbeddedFiles などです |
CreateMissing | True で、/Names ディクショナリーとカテゴリーディクショナリーのどちらかが存在しないときに、新しい間接オブジェクトとして作成します。False で、代わりに nil を返します |
戻り値
解決済みのカテゴリーディクショナリーを返します。存在せず CreateMissing が False のとき、およびドキュメントに読み込み済みカタログがないときは nil を返します
使用上の注意
- 作成の際は、ディクショナリー以外の /Names エントリーを失敗ではなく置き換えで処理し、カタログと /Names ディクショナリーの両方を dirty としてマークするので、変更が次のインクリメンタル更新や保存で反映されます
- 返されるディクショナリーはネームツリーのルートノードです。キー順序を正しく保つため、ツリーの走査や編集には
InsertLoadedNameTreeEntryとRemoveLoadedNameTreeEntryを使ってください - 何も作成せずにどのカテゴリーが存在するかを列挙するには、
GetLoadedNameTreeRootCountを使います