XFA Specification
Chapter 9, Automation Objects
Events
307
Subform Events
Subform events trigger in response to changes of state which affect subforms. Some are generated in
interactive contexts and some in both interactive and non-interactive contexts.
A script binds to a subform event by expressing a
ref
property whose value is a SOM expression pointing
to the subform.
The subform events are as follows:
enter
This event triggers when some field directly or indirectly within the subform gains keyboard focus,
whether caused by a user action (tabbing into the field or clicking on it with the mouse) or by a
script programmatically setting the focus. It is not triggered by keyboard focus moving to another
field within the same subform – focus must come in from outside the subform.
exit
This event triggers when keyboard focus is yielded from a field directly or indirectly within the
subform to a field or other object outside the subform. It is not triggered by keyboard focus
moving to another field within the same subform – focus must go out from inside the subform.
initialize
This event triggers after data binding is complete. A separate event is generated for each instance
of the subform in the Form DOM.
Exclusion Group Events
Exclusion Group events trigger in response to user actions which affect exclusion groups. Some are
generated in interactive contexts and some in both interactive and non-interactive contexts.
A script binds to an exclusion group event by expressing a
ref
property whose value is a SOM expression
pointing to the exclusion group.
The exclusion group events are as follows:
enter
This event triggers when some field within the exclusion group gains keyboard focus, whether
caused by a user action (tabbing into the field or clicking on it with the mouse) or by a script
programmatically setting the focus. It is not triggered by keyboard focus moving to another field
within the same exclusion group – focus must come in from outside the exclusion group.
exit
This event triggers when keyboard focus is yielded from a field within the exclusion group to a
field or other object outside the exclusion group. It is not triggered by keyboard focus moving to
another field within the same exclusion group – focus must go out from inside the exclusion
group.
initialize
This event triggers after data binding is complete. A separate event is generated for each instance
of the exclusion group in the Form DOM.