Método THotPDF.InsertLoadedNameTreeEntry
Insere um par key/value em uma name tree carregada e mantém cada folha ordenada conforme a ISO 32000-1 7.9.6
Declaração
procedure InsertLoadedNameTreeEntry(Tree: THPDFDictionaryObject;
const Key: AnsiString; Value: THPDFObject);Unit
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
Tree | Nó raiz da name tree, normalmente obtido de GetLoadedNameTree |
Key | String de key ordenada da entrada |
Value | Objeto PDF guardado para a key; a árvore só fica responsável pelo posicionamento da inserção, o objeto continua parte do grafo carregado |
Valor de retorno
Este membro não retorna um valor
Notas de uso
- Uma árvore com /Kids é descida pelos /Limits dos nós, e os limits no caminho são alargados para cobrir a nova key, então viewers continuam usando busca binária sobre as folhas
- Inserir uma key existente substitui o valor dela em vez de adicionar uma duplicata
- Todo nó no caminho de descida é marcado como dirty, então a mudança é gravada de volta no próximo save ou incremental update