XFA Specification
Chapter 9, Automation Objects
Events
311
The accompanying connection set is as follows:
<connectionSet … >
<wsdlConnection name="service1" … >
…
</wsdlConnection>
</connectionSet>
In this example the
click
events from either of two fields initiate a web service transaction. There
is a script associated with the connection's
postExecute
event, so when either field is clicked,
the outgoing data is marshalled, the web server transaction takes place, the resulting incoming
data is marshalled, then the
postExecute
script runs.
Properties
There are two general categories of events,
primary events
which correspond to a user action and
secondary events
which are triggered by an internal change of state. Primary events update some or all of
the
primary properties
of an object called
xfa.event
(more commonly known by the alias
$event
). By
contrast, secondary events do not update the primary properties of
$event
. If a secondary event results
from a primary event then the primary properties of
$event
during the secondary event have the values
set by the primary event. However, secondary events may set
secondary properties
of
$event
.
It is an error for a script to try to use a property that is not set in the current context. The following table
shows which properties are set by each primary event:
Target Type
subform
Event Name
enter
exit
Sets Primary Properties
name
target
name
modifier
reenter
shift
target
field
click
enter
mouseEnter
mouseExit
mouseDown
mouseUp
field
exit
commitKey
name
modifier
shift
target