THotPDF.GetLoadedNameTree Method
Връща речника на категорията name tree на заредения документ от каталожния речник /Names, като по избор го създава при първото използване
Декларация
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;
Unit
HPDFDoc
Параметри
| Име | Предназначение |
|---|---|
Category | Ключ на категория name tree в каталожния речник /Names, например Dests, JavaScript или EmbeddedFiles |
CreateMissing | True за създаване на речника /Names и речника на категорията като нови indirect objects, когато някой от тях липсва; False вместо това да върне nil |
Върната стойност
Разрешеният речник на категорията, или nil, когато той липсва и CreateMissing е False, или когато документът няма зареден каталог
Бележки за употреба
- Създаването замества запис в /Names, който не е речник, вместо да се провали, а и каталогът, и речникът /Names се отбелязват като променени, така че промяната попада в следващата инкрементална актуализация или запис
- Върнатият речник е коренов възел на name tree; обхождайте или редактирайте го с
InsertLoadedNameTreeEntryиRemoveLoadedNameTreeEntry, за да остане подредбата на ключовете валидна - Използвайте
GetLoadedNameTreeRootCount, за да изброите кои категории съществуват, без да създавате нищо