User Guide

190 Chapter 5: ActionScript Core Language Elements
on()
Availability
Flash 2. Not all events are supported in Flash 2.
Usage
on(mouseEvent) {
// your statements here
}
Parameters
statement(s)
The instructions to execute when the mouseEvent occurs.
A
mouseEvent is a trigger called an event. When the event occurs, the statements following it
within curly braces ({ }) execute. Any of the following values can be specified for the
mouseEvent parameter:
• press The mouse button is pressed while the pointer is over the button.
• release The mouse button is released while the pointer is over the button.
• releaseOutside While the pointer is over the button, the mouse button is pressed and then
rolls outside the button area just before it is released. Both the
press and the dragOut events
always precede a
releaseOutside event.
• rollOut The pointer rolls outside the button area.
• rollOver The mouse pointer rolls over the button.
• dragOut While the pointer is over the button, the mouse button is pressed and then rolls
outside the button area.
• dragOver While the pointer is over the button, the mouse button has been pressed, then
rolled outside the button, and then rolled back over the button.
• keyPress "<key>" The specified keyboard key is pressed. For the key portion of the
parameter, specify a key constant. You can use this parameter to intercept a key press, that is, to
override any built-in behavior for the specified key. The button can be anywhere in your
application. One limitation of this technique is that you can't apply the
on() handler at
runtime; you must do it at authoring time. Make sure that you select Control > Disable
Keyboard Shortcuts, or certain keys with built-in behavior won’t be overridden when you test
the application using Control > Test Movie.
For a list of key constants, see “Property summary for the Key class” on page 295. For a list of
key constants, see “Property summary for the Key class” on page 295.
Description
Event handler; specifies the mouse event or keypress that triggers an action.
CHAPTER 5
ActionScript Core Language Elements