TXFAEventAction

Unidade: HPDFXFAEventScript

Declaration

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

Comportamento

Representa uma operação literal analisada ou uma mutação validada emitida pelo host geral de eventos

Kind seleciona presence, valor bruto, access ou uma operação de instâncias; argumentos transportam índices e definições de instâncias

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

Valores de ações usam texto UTF-8; Unicode inválido, campos de ações ou orçamentos rejeitam o evento antes da publicação de documentos

Use TXFAWidgetRuntime.DispatchEvent para replay e rollback validados em vez de aplicar registos diretamente a um documento partilhado

Bindings de identidades e resultados de scripts usam Value para o texto validado deles e são interpretados pelo runtime em vez de como mutações ordinárias de formulários

Ações de estados de host transportam texto name|value em Value; ações de foco transportam focus ou clear, e ações de edição de resets têm um Value vazio com o alvo selecionado de campos

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

Um PropertyPath vazio preserva o alvo existente direto de bindings; o runtime valida profundidade de caminhos, cardinalidade de schemas, grupos de escolhas e orçamentos nativos de nós antes de aplicar criações ou escritas subsequentes

DataPath identifica um descendente fresco do Data DOM criado por importação XML sob o binding de dados selecionado por Target, usando posições de filhos de 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 proprietário foi criado por um gestor de instâncias de formulários durante o evento atual

xeakLoadDataXML transporta o XML UTF-8 de entrada em Value, com Argument a selecionar ignoreRoot e Argument2 a selecionar overwrite; o runtime nativo analisa a fonte 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 mutações ordinárias de campos

APIs relacionadas

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