HPDFXFAResolveBoundDataNode

Unidade: 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âmetroSignificado
ADocumentO documento nativo dono dos pacotes de datasets e de templates
AFieldNodeO campo do template contendo a declaração de bind dele ou o nome implícito
ADataNodeA ocorrência atual de dados nativos para bindings implícitos e relativos de compatibilidade
ACreatePermite que caminhos determinísticos em falta criem elementos nativos próprios com XML names válidos
ABindingHandledReporta um binding explícito none ou dataRef tratado pelo resolver; um binding tratado ainda pode devolver nil
RemainingOperationsQuota partilhada de operações, decrementada por parsing, verificações de namespaces e travessia; zero está esgotada e negativa desativa esta quota de quem chama
DeadlinePrazo absoluto no domínio de relógio do callback fornecido, ou negativo para desativar verificações de tempo decorrido
DeadlineCheckMétodo de objeto síncrono opcional; nil verifica os milissegundos de GetTickCount64

Comportamento

O nó devolvido pertence a ADocument e não deve ser libertado por quem chama; nomes implícitos de campos são XML names literais, incluindo pontos

A consulta dataRef suporta raízes $data e $record, operadores de descendentes, seletores de wildcards e de classes, índices explícitos de irmãos, [*] e carateres de seletores com escape; veja o Bind SOM nativo de XFA para exemplos e fronteiras

Um valor implícito em falta numa ocorrência repetida fornecida permanece local a essa ocorrência; não faz fallback para outra ocorrência

Um caminho relativo dataRef de compatibilidade também permanece local quando ADataNode é fornecido; o fallback de record e de raiz para referências relativas aplica-se apenas quando quem chama não tem contexto de ocorrências

Consulta só de leitura não aloca nós de dados; a criação aplica-se a caminhos nomeados determinísticos, enquanto pesquisas ambíguas de wildcards, classes e descendentes continuam a ser operações de consulta

Um sufixo não resolvido ou uma exceção remove os nós intermediários alocados por esta chamada ao resolver; nós previamente existentes permanecem próprios e inalterados

A travessia usa limites fixos de 64 segmentos de seletores, 64 níveis de elementos e 200000 passos cobrados por travessia de caminhos, além dos limites opcionais de quem chama

Orçamentos esgotados de operações ou de tempo decorrido levantam EHPDFXFAError; edições e eventos interativos restauram o snapshot da transação nativa envolvente

APIs relacionadas