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