THotPDF.GetLoadedNameTree Method
Devolve o dicionário de categoria de name tree do documento carregado a partir do dicionário /Names do catálogo, criando-o opcionalmente na primeira utilização
Declaração
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;Unidade
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
Category | Chave de categoria de name tree no dicionário /Names do catálogo, por exemplo Dests, JavaScript ou EmbeddedFiles |
CreateMissing | True para criar o dicionário /Names e o dicionário de categoria como novos objetos indiretos quando um deles falta; False para devolver nil |
Valor de retorno
O dicionário de categoria resolvido, ou nil quando falta e CreateMissing é False, ou quando o documento não tem catálogo carregado
Notas de utilização
- A criação substitui uma entrada /Names que não seja um dicionário em vez de falhar, e o catálogo e o dicionário /Names são marcados como dirty, por isso a alteração entra no próximo incremental update ou gravação
- O dicionário devolvido é um nó raiz de uma name tree; percorra-o ou edite-o com
InsertLoadedNameTreeEntryeRemoveLoadedNameTreeEntrypara que a ordem das chaves se mantenha válida - Use
GetLoadedNameTreeRootCountpara enumerar as categorias existentes sem criar nada