THotPDF.GetLoadedNameTree Method
Liefert das Name-Tree-Kategorie-Wörterbuch des geladenen Dokuments aus dem /Names-Wörterbuch des Katalogs und erzeugt es auf Wunsch beim ersten Einsatz
Deklaration
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;Unit
HPDFDoc
Parameter
| Name | Zweck |
|---|---|
Category | Name-Tree-Kategorie-Schlüssel im /Names-Wörterbuch des Katalogs, etwa Dests, JavaScript oder EmbeddedFiles |
CreateMissing | True, um das /Names-Wörterbuch und das Kategorie-Wörterbuch als neue indirekte Objekte zu erzeugen, wenn eines davon fehlt; False, um stattdessen nil zurückzugeben |
Rückgabewert
Das aufgelöste Kategorie-Wörterbuch, oder nil, wenn es fehlt und CreateMissing False ist, oder wenn das Dokument keinen geladenen Katalog hat
Verwendungshinweise
- Ein /Names-Eintrag, der kein Wörterbuch ist, wird beim Erzeugen ersetzt, statt einen Fehler auszulösen; Katalog und /Names-Wörterbuch werden als dirty markiert, damit die Änderung im nächsten inkrementellen Update oder beim nächsten Speichern ankommt
- Das zurückgegebene Wörterbuch ist ein Wurzelknoten eines Name-Trees; durchlaufen oder bearbeiten Sie es mit
InsertLoadedNameTreeEntryundRemoveLoadedNameTreeEntry, damit die Schlüsselsortierung gültig bleibt - Mit
GetLoadedNameTreeRootCountzählen Sie ab, welche Kategorien existieren, ohne etwas zu erzeugen