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