on handler

on(mouseEvent:Object) {
// your statements here
}

Specifies the mouse event or keypress that triggers an action.

Availability: ActionScript 1.0; Flash Player 2 - Flash 2. Not all events are supported in Flash 2.

Parameters

mouseEvent:Object - 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, as shown in the code hinting in the Actions Panel. 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, on or off the Stage. 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 the Key class.

Example

In the following script, the startDrag() function 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(this);
}
on (release) {
 trace("X:"+this._x);
 trace("Y:"+this._y);
 stopDrag();
}

Comments

Fumio Nonaka said on Dec 29, 2005 at 6:07 PM :

"For a list of key constants, see the Key class."

Key constants of the 'on (keyPress)' handler are different from key codes,
which the Key class's constants property returns. You should specify a
key constant shown in the code hinting or the character which you would
like to inspect.

The following statement yields syntax error:

on (keyPress Key.SPACE) {}

To inspect "a":
// on (keyPress 65) {} // syntax error
on (keyPress "a") {}

Current page: http://livedocs.adobe.com/flash/8/main/00001752.html

on handler

Parameters

Example

See also

Comments