TXFAEventAction

Unità: HPDFXFAEventScript

Dichiarazione

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

Comportamento

Rappresenta un'operazione letterale analizzata o una mutazione validata emessa dall'host eventi generale

Kind seleziona presence, raw value, access o un'operazione su istanza; gli argomenti portano indici e impostazioni di istanza

L'host generale usa Target come riferimento di binding e VirtualPath come posizione validata di un nodo creato durante lo stesso evento

I valori action usano testo UTF-8; Unicode non valido, campi action o budget rifiutano l'evento prima della pubblicazione del documento

Usa TXFAWidgetRuntime.DispatchEvent per replay e rollback validati invece di applicare i record direttamente a un documento condiviso

I binding di identità e i risultati script usano Value per il loro testo validato e sono interpretati dal runtime anziché come mutazioni ordinarie del modulo

Le azioni host state portano testo name|value in Value; le azioni focus portano focus o clear e le azioni reset editing hanno Value vuoto con il target campo selezionato

PropertyPath indirizza una proprietà sotto il proprietario modulo selezionato da Target, usando occorrenze di classe come font[0]/fill[0]/color[0]; può essere combinato con VirtualPath quando il proprietario è stato inserito durante l'evento corrente

Un PropertyPath vuoto preserva il target di binding diretto esistente; il runtime valida profondità del percorso, cardinalità dello schema, gruppi choice e budget di nodi nativi prima di applicare creazione o scritture successive

DataPath identifica un discendente Data DOM fresco creato da un import XML sotto il binding dati selezionato da Target, usando posizioni figlio elemento a base zero come 0/1; testo, commenti e processing instruction non contano come posizioni elemento

DataPath può accompagnare VirtualPath quando il gruppo dati proprietario è stato creato da un form instance manager durante l'evento corrente

xeakLoadDataXML porta l'XML UTF-8 in ingresso in Value, con Argument che seleziona ignoreRoot e Argument2 che seleziona overwrite; il runtime nativo analizza la sorgente prima di cambiare il target selezionato

Il runtime risolve le scritture di discendenti freschi e la pubblicazione di identità contro il vero grafo nativo importato, poi applica la stessa transazione evento e rollback delle mutazioni ordinarie dei campi

API correlate

Runtime widget XFA dinamico interattivo, Funzioni FormCalc e Packet DOM XFA