THotPDF.InsertLoadedNameTreeEntry Method
Insere um par chave/valor numa name tree carregada e mantém todas as folhas ordenadas conforme a ISO 32000-1 7.9.6
Declaração
procedure InsertLoadedNameTreeEntry(Tree: THPDFDictionaryObject;
const Key: AnsiString; Value: THPDFObject);Unidade
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
Tree | Nó raiz da name tree, tipicamente obtido de GetLoadedNameTree |
Key | Cadeia ordenada da chave da entrada |
Value | Objeto PDF guardado para a chave; a árvore só fica responsável pelo posicionamento da inserção, o objeto continua a fazer parte do grafo carregado |
Valor de retorno
Este membro não devolve qualquer valor
Notas de utilização
- Numa árvore com /Kids desce-se pelos /Limits dos nós, e os limites ao longo do caminho são alargados para cobrir a nova chave, por isso os visualizadores continuam a poder usar pesquisa binária sobre as folhas
- Inserir uma chave existente substitui o respetivo valor em vez de acrescentar um duplicado
- Cada nó no caminho de descida é marcado como dirty, por isso a alteração é escrita na próxima gravação ou incremental update