Método THotPDF.GetLoadedNameTree
Devolve o dicionário de categoria de name tree do documento carregado a partir do dicionário /Names do catálogo, criando-o no primeiro uso se necessário
Declaração
function GetLoadedNameTree(const Category: AnsiString;
CreateMissing: boolean): THPDFDictionaryObject;Unit
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
Category | Key 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 dos dois estiver ausente; False para devolver nil em vez disso |
Valor de retorno
O dicionário de categoria resolvido, ou nil quando ele está ausente e CreateMissing é False, ou quando o documento não tem catálogo carregado
Notas de uso
- 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, assim a mudança entra no próximo incremental update ou save
- O dicionário devolvido é um nó raiz de uma name tree; percorra-o ou edite-o com
InsertLoadedNameTreeEntryeRemoveLoadedNameTreeEntrypara a ordenação das keys continuar válida - Use
GetLoadedNameTreeRootCountpara enumerar quais categorias existem sem criar nada