THotPDF.GetLoadedNameTree Method
Devuelve el diccionario de categoría del name tree del documento cargado a partir del diccionario /Names del catálogo y, opcionalmente, lo crea al primer uso
Declaración
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;Unidad
HPDFDoc
Parámetros
| Nombre | Propósito |
|---|---|
Category | Clave de la 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 alguno de los dos falte; 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 un catálogo cargado
Notas de uso
- La creación reemplaza una entrada /Names que no sea un diccionario en lugar de fallar, y tanto el catálogo como el diccionario /Names quedan marcados como modificados para que el cambio se refleje en la próxima actualización incremental o guardado
- El diccionario devuelto es un nodo raíz de un name tree; recórralo o edítelo con
InsertLoadedNameTreeEntryyRemoveLoadedNameTreeEntrypara que el orden de las claves siga siendo válido - Use
GetLoadedNameTreeRootCountpara enumerar qué categorías existen sin crear nada