THotPDF.GetLoadedNameTree Method
Devuelve el diccionario de categoría del name tree del documento cargado desde el diccionario /Names del catálogo, creándolo opcionalmente al primer uso
Declaración
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;Unidad
HPDFDoc
Parámetros
| Nombre | Propósito |
|---|---|
Category | Clave de categoría del name tree en el diccionario /Names del catálogo, por ejemplo Dests, JavaScript o EmbeddedFiles |
CreateMissing | True para crear el diccionario /Names y el diccionario de categoría como nuevos objetos indirectos cuando falta alguno; False para devolver nil en su lugar |
Valor de retorno
El diccionario de categoría resuelto, o nil cuando falta y CreateMissing es False, o cuando el documento no tiene catálogo cargado
Notas de uso
- La creación reemplaza una entrada de /Names que no sea un diccionario en lugar de fallar, y tanto el catálogo como el diccionario /Names se marcan como dirty, así que el cambio aterriza en la siguiente actualización incremental o guardado
- El diccionario devuelto es un nodo raíz de un name tree; recórrelo o edítalo con
InsertLoadedNameTreeEntryyRemoveLoadedNameTreeEntrypara que el orden de las claves siga siendo válido - Usa
GetLoadedNameTreeRootCountpara enumerar qué categorías existen sin crear nada