Event Object
All JavaScripts are executed as the result of a particular event (also referred to as a trigger).
Acrobat Forms accepts the following events and executes any scripts that are specified for
these events:
mouse enter, mouse down, mouse up, mouse exit, keystroke, format, validate,
and
calculate.
It is important to JavaScript writers to know what these events are and when and
what order they are processed.
Event Processing
Mouse Enter
The
mouse enter
event is triggered when a user moves the mouse pointer inside the rectangle
of a field. This is the typical place to open a text field to display help text, etc.
Mouse Down
The
mouse down
event is triggered when a user starts to click on a form field and the mouse
button is still down. It is advised that you perform very little processing (i.e. play a short
sound) during this event. A mouse down event will not occur unless a
mouse enter
event has
already occurred.
Mouse Up
The
mouse up
event is triggered when the user clicks on a form field and releases the mouse
button. This is the typical place to attach routines such as the submit action if a form. A
mouse
up
event will not occur unless a
mouse down
event has already occurred.
Mouse Exit
The
mouse exit
event is the opposite of the
mouse enter
event and occurs when a user moves
the mouse pointer outside of the rectangle of a field. A
mouse exit
event will not occur unless a
mouse enter
event has already occurred.
Keystroke
The
keystroke
event occurs whenever a user types a keystroke into a
text box
or
combo box
(this includes cut and paste operations), or selects an item in a
combo box
drop down or
listbox
field. A keystroke script may want to limit the type of keys allowed. For example, a numeric
field might only allow numeric characters.
Acrobat Forms - JavaScript Object Specification
31