THotPDF.GetLoadedNameTree Method
Zwraca słownik kategorii drzewa nazw załadowanego dokumentu ze słownika /Names w katalogu, opcjonalnie tworząc go przy pierwszym użyciu
Deklaracja
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;
Jednostka
HPDFDoc
Parametry
| Nazwa | Przeznaczenie |
|---|---|
Category | Klucz kategorii drzewa nazw w słowniku /Names katalogu, na przykład Dests, JavaScript albo EmbeddedFiles |
CreateMissing | True tworzy słownik /Names i słownik kategorii jako nowe obiekty pośrednie, gdy któregoś z nich brakuje; False zwraca w takim wypadku nil |
Wartość zwracana
Rozwiązany słownik kategorii, albo nil, gdy go brakuje, a CreateMissing ma wartość False, albo gdy dokument nie ma załadowanego katalogu
Uwagi dotyczące użycia
- Utworzenie zastępuje wpis /Names niebędący słownikiem, zamiast kończyć się błędem, a katalog i słownik /Names są oznaczane jako zmienione, więc zmiana trafi do następnej aktualizacji przyrostowej albo zapisu
- Zwrócony słownik to węzeł główny drzewa nazw; przeglądaj go i edytuj przez
InsertLoadedNameTreeEntryiRemoveLoadedNameTreeEntry, żeby kolejność kluczy pozostała poprawna - Użyj
GetLoadedNameTreeRootCount, żeby wyliczyć, które kategorie istnieją, niczego przy tym nie tworząc