THotPDF.GetLoadedNameTree Method
從 catalog 的 /Names 字典取得已載入文件的 name tree 類別字典，並可在首次使用時順帶建立
宣告
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
Category | catalog /Names 字典中的 name tree 類別鍵，例如 Dests、JavaScript 或 EmbeddedFiles |
CreateMissing | True 表示兩者缺任一時，把 /Names 字典與類別字典建立為新的間接物件；False 則改為傳回 nil |
傳回值
解析後的類別字典；字典缺失且 CreateMissing 為 False 時，或文件沒有已載入的 catalog 時，傳回 nil
使用說明
- 建立時若 /Names 條目不是字典，會直接取代而不是失敗；catalog 與 /Names 字典都會標記為 dirty，變更因此會落在下一次增量更新或儲存中
- 傳回的字典是 name tree 的根節點；請用
InsertLoadedNameTreeEntry與RemoveLoadedNameTreeEntry來走訪或編輯，鍵的排序才能維持有效 - 想列舉現有哪些類別又不想建立任何東西，可用
GetLoadedNameTreeRootCount