MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Page 521

MovieClip.onKeyDown 521
MovieClip.onKeyDown
Availability
Flash Player 6.
Usage
my_mc.onKeyDown = function() {
// your statements here
}
Parameters
None.
Returns
Nothing.
Description
Event handler; invoked when a movie clip has input focus and a key is pressed. The onKeyDown
event handler is invoked with no parameters. You can use the
Key.getAscii() and
Key.getCode() methods to determine which key was pressed. You must define a function that
executes when the event handler is invoked.
The
onKeyDown event handler works only if the movie clip has input focus enabled and set. First,
the
focusEnabled property must be set to true for the movie clip. Then, the clip must be given
focus. This can be done either by using
Selection.setFocus() or by setting the tab key to
navigate to the clip.
If
Selection.setFocus() is used, the path for the movie clip must be passed to
Selection.setFocus(). It is very easy for other elements to take the focus back once the mouse
is moved.
Example
The following example defines a function for the onKeyDown() method that sends a trace()
action to the Output panel.
my_mc.onKeyDown = function () {
trace ("onKeyDown called");
};
The following example sets input focus.
MovieClip.focusEnabled = true;
Selection.setFocus(MovieClip);
See also
MovieClip.onKeyUp