TXFAEventAction

Unit: HPDFXFAEventScript

Declaração

TXFAEventAction= record
  Kind: TXFAEventActionKind;
  Target, Presence, Value: AnsiString;
  Argument, Argument2: Integer;
  VirtualPath: AnsiString;
  PropertyPath: AnsiString;
  DataPath: AnsiString;
end;

Comportamento

Representa uma operação literal parseada ou mutação validada emitida pelo event host geral

Kind seleciona presence, raw value, access ou uma operação de instância; arguments carregam índices e configurações de instância

O host geral usa Target como referência de binding e VirtualPath como a localização validada de um nó criado durante o mesmo evento

Os valores de actions usam texto UTF-8; Unicode inválido, campos de actions ou orçamentos rejeitam o evento antes da publicação do documento

Use TXFAWidgetRuntime.DispatchEvent para replay e rollback validados, em vez de aplicar records diretamente num documento compartilhado

Identity bindings e resultados de script usam Value para seu texto validado e são interpretados pelo runtime, e não como mutações comuns de formulário

Actions de estado do host carregam texto name|value em Value; actions de focus carregam focus ou clear, e actions de reset de edição têm Value vazio com o alvo do campo selecionado

PropertyPath endereça uma propriedade sob o dono do formulário selecionado por Target, usando ocorrências de classes como font[0]/fill[0]/color[0]; pode ser combinado com VirtualPath quando o dono foi inserido durante o evento atual

Um PropertyPath vazio preserva o alvo de binding direto existente; o runtime valida profundidade do path, cardinalidade do schema, grupos de choice e orçamentos nativos de nós antes de aplicar criação ou escritas subsequentes

DataPath identifica um descendente fresco do Data DOM criado por import XML sob o data binding selecionado por Target, usando posições de filhos elementos com base zero como 0/1; texto, comentários e processing instructions não contam como posições de elementos

DataPath pode acompanhar VirtualPath quando o grupo de dados dono foi criado por um form instance manager durante o evento atual

xeakLoadDataXML carrega o XML UTF-8 de entrada em Value, com Argument selecionando ignoreRoot e Argument2 selecionando overwrite; o runtime nativo parseia a origem antes de alterar o alvo selecionado

O runtime resolve escritas frescas de descendentes e publicação de identidades contra o grafo nativo realmente importado, e depois aplica a mesma transação e rollback de eventos que as mutações comuns de campos

APIs relacionadas

Runtime interativo de widgets XFA dinâmicos, Funções FormCalc e XFA Packet DOM