TXFAEventAction

Unit: HPDFXFAEventScript

Declaration

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

Behaviour

Represents a parsed literal operation or a validated mutation emitted by the general event host

Kind selects presence, raw value, access or an instance operation; arguments carry indices and instance settings

The general host treats Target as a binding reference and VirtualPath as the validated location of a node created during the same event

Action values use UTF-8 text; invalid Unicode, action fields or budgets veto the event before document publication

Use TXFAWidgetRuntime.DispatchEvent for validated replay and rollback instead of applying records directly to a shared document

Identity bindings and script results use Value for their validated text and the runtime interprets them rather than treating them as ordinary form mutations

Host state actions carry name|value text in Value; focus actions carry focus or clear, and reset editing actions have an empty Value with the selected field target

PropertyPath addresses a property beneath the form owner selected by Target, using class occurrences such as font[0]/fill[0]/color[0]; it may be combined with VirtualPath when the owner was inserted during the current event

An empty PropertyPath preserves the existing direct binding target; the runtime validates path depth, schema cardinality, choice groups and native node budgets before applying creation or subsequent writes

DataPath identifies a fresh Data DOM descendant created by XML import beneath the data binding selected by Target, using zero-based element-child positions such as 0/1; text, comments and processing instructions do not count as element positions

DataPath may accompany VirtualPath when the owning data group was created by a form instance manager during the current event

xeakLoadDataXML carries the incoming UTF-8 XML in Value, with Argument selecting ignoreRoot and Argument2 selecting overwrite; the native runtime parses the source before the selected target is changed

The runtime resolves fresh descendant writes and identity publication against the actual imported native graph, then applies the same event transaction and rollback as ordinary field mutations

Related APIs

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