TXFAEventAction

Unit: HPDFXFAEventScript

Declaration

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

Behavior

Repräsentiert eine geparste literale Operation oder validierte Mutation, die der allgemeine Event-Host emittiert

Kind wählt Presence, Raw-Wert, Zugriff oder eine Instanzoperation; Argumente tragen Indizes und Instanzeinstellungen

Der allgemeine Host nutzt Target als Bindings-Referenz und VirtualPath als validierte Position eines Knotens, der im selben Event erzeugt wurde

Action-Werte nutzen UTF-8-Text; ungültiges Unicode, Action-Felder oder Budgets weisen das Event vor der Dokumentveröffentlichung zurück

Nutzen Sie TXFAWidgetRuntime.DispatchEvent für validiertes Replay und Rollback, statt Records direkt auf ein gemeinsames Dokument anzuwenden

Identity-Bindings und Skriptergebnisse nutzen Value für ihren validierten Text und werden von der Runtime interpretiert, nicht als gewöhnliche Formularmutationen

Host-Zustandsaktionen tragen name|value-Text in Value; Fokusaktionen tragen focus oder clear, und Reset-Editing-Aktionen haben ein leeres Value mit dem ausgewählten Feldziel

PropertyPath adressiert eine Property unter dem von Target gewählten Formularbesitzer, mit Klassen-Occurrences wie font[0]/fill[0]/color[0]; er lässt sich mit VirtualPath kombinieren, wenn der Besitzer während des aktuellen Events eingefügt wurde

Ein leerer PropertyPath bewahrt das bestehende direkte Binding-Ziel; die Runtime validiert Pfadtiefe, Schema-Kardinalität, Choice-Gruppen und native Knotenbudgets, bevor sie Anlegen oder nachfolgende Schreibvorgänge anwendet

DataPath identifiziert einen frischen Data-DOM-Nachfahren, der per XML-Import unter der von Target gewählten Datenbindung erzeugt wurde, mit nullbasierten Element-Kind-Positionen wie 0/1; Text, Kommentare und Processing Instructions zählen nicht als Elementpositionen

DataPath kann VirtualPath begleiten, wenn die besitzende Datengruppe von einem Form-Instance-Manager während des aktuellen Events erzeugt wurde

xeakLoadDataXML trägt das eingehende UTF-8-XML in Value, wobei Argument ignoreRoot und Argument2 overwrite wählt; die native Runtime parst die Quelle, bevor sie das ausgewählte Ziel ändert

Die Runtime löst frische Nachfahren-Schreibvorgänge und Identity-Veröffentlichung gegen den tatsächlich importierten nativen Graphen auf und wendet dann dieselbe Event-Transaktion und dasselbe Rollback an wie bei gewöhnlichen Feldmutationen

Verwandte APIs

Interactive Dynamic XFA Widget Runtime, FormCalc Functions und XFA Packet DOM