on
Availability
Flash 2. Not all events are supported in Flash 2.
Usage
on(
mouseEvent
) {
statement(s);
}
Parameters
statement(s)
The instructions to execute when the mouseEvent
takes place.
A mouseEvent
is a trigger called an "event." When the event takes place, the statements following it within curly brackets 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 The mouse button is released while the pointer is outside the button after the button is pressed while the pointer is inside the button.
|
 |
rollOut The pointer rolls outside of 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 key is pressed. The key portion of the parameter is specified using any of the key codes listed in in Appendix B, Keyboard Keys and Key Code Values of Using Flash or any of the key constants listed in the Property summary for the Key object.
|
Description
Event handler; specifies the mouse event, or keypress that trigger an action.
Example
In the following script, the startDrag
action executes when the mouse is pressed and the conditional script is executed when the mouse is released and the object is dropped.
on(press) {
startDrag("rabbit");
}
on(release) {
trace(_root.rabbit._y);
trace(_root.rabbit._x);
stopDrag();
}
See also
onClipEvent