HPDFXFAResolveBoundDataNode
Unit: HPDFXFA
Declarações
function HPDFXFAResolveBoundDataNode(ADocument: TXFADocument;
AFieldNode, ADataNode: TXFANode; ACreate: Boolean;
out ABindingHandled: Boolean): TXFANode; overload;
function HPDFXFAResolveBoundDataNode(ADocument: TXFADocument;
AFieldNode, ADataNode: TXFANode; ACreate: Boolean;
out ABindingHandled: Boolean; var RemainingOperations: Integer;
Deadline: Int64; DeadlineCheck: TXFABindingDeadlineCheck = nil): TXFANode; overload;Parâmetros
| Parâmetro | Significado |
|---|---|
| ADocument | O documento nativo dono dos packets dataset e template |
| AFieldNode | O campo de template contendo sua declaração bind ou nome implícito |
| ADataNode | A ocorrência nativa atual de dados para bindings implícitos e relativos de compatibilidade |
| ACreate | Permite que paths ausentes determinísticos criem elementos nativos próprios com nomes XML válidos |
| ABindingHandled | Reporta um binding explícito none ou dataRef tratado pelo resolver; um binding tratado ainda pode retornar nil |
| RemainingOperations | Cota compartilhada de operações, decrementada por parsing, checagens de namespaces e traversal; zero significa esgotado, e negativo desabilita essa cota do chamador |
| Deadline | Deadline absoluto no domínio de clock do callback fornecido, ou negativo para desabilitar as checagens de tempo decorrido |
| DeadlineCheck | Método de objeto síncrono opcional; nil checa os milissegundos de GetTickCount64 |
Comportamento
O nó retornado pertence a ADocument e não deve ser liberado pelo chamador; nomes de campos implícitos são nomes XML literais, incluindo pontos
O lookup dataRef suporta raízes $data e $record, operadores de descendentes, wildcards e selectors de classe, índices explícitos de irmãos, [*] e caracteres de selectors escapados; veja Bind SOM nativo do XFA para exemplos e fronteiras
Um valor implícito ausente numa ocorrência repetida fornecida fica local àquela ocorrência; ele não faz fallback para outra ocorrência
Um path relativo dataRef de compatibilidade também fica local quando ADataNode é fornecido; o fallback de record e raiz para referências relativas se aplica apenas quando o chamador não tem contexto de ocorrência
Lookup somente leitura não aloca nós de dados; a criação se aplica a paths nomeados determinísticos, enquanto buscas ambíguas de wildcard, classe e descendentes permanecem operações de lookup
Um sufixo não resolvido ou uma exceção remove os nós intermediários alocados por esta chamada do resolver; nós previamente existentes permanecem próprios e inalterados
O traversal usa limites fixos de 64 segmentos de selectors, 64 levels de elementos e 200000 steps cobrados por traversal de path, além dos limites opcionais do chamador
Orçamentos de operações ou tempo decorrido esgotados disparam EHPDFXFAError; edições e eventos interativos restauram o snapshot transacional nativo que os contém