THotPDF.GetLoadedNameTree Method
Visszaadja a betöltött dokumentum adott névfa-kategóriájának szótárát a katalógus /Names szótárából, első használatkor szükség esetén létrehozva azt
Deklaráció
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;
Egység
HPDFDoc
Paraméterek
| Név | Cél |
|---|---|
Category | Névfa-kategória kulcs a katalógus /Names szótárában, például Dests, JavaScript vagy EmbeddedFiles |
CreateMissing | True esetén a /Names szótár és a kategóriaszótár új közvetett objektumként jön létre, ha valamelyik hiányzik; False esetén ilyenkor nil-lel tér vissza |
Visszatérési érték
A feloldott kategóriaszótár, vagy nil, ha az hiányzik és a CreateMissing értéke False, vagy ha a dokumentumhoz nincs betöltött katalógus
Használati megjegyzések
- A létrehozás egy nem szótár típusú /Names bejegyzést felülír ahelyett hogy hibázna, és mind a katalógus, mind a /Names szótár dirty jelölést kap, így a változás a következő inkrementális frissítésbe vagy mentésbe bekerül
- A visszaadott szótár egy névfa gyökércsomópontja; bejárni vagy szerkeszteni a
InsertLoadedNameTreeEntryés aRemoveLoadedNameTreeEntrymetódusokkal érdemes, hogy a kulcsok rendezettsége érvényes maradjon - A
GetLoadedNameTreeRootCountsegítségével listázhatók ki a létező kategóriák, bármi létrehozása nélkül