Adobe acrobat forms javascript object specification User Manual

31

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.

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.

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.

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.

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.

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.