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