M > MovieClip.onKeyDown |
![]() ![]() ![]() |
MovieClip.onKeyDown
movieclip, movieclip.onKeyDown, onKeyDown
Availability
Flash Player 6.
Usage
myMovieClip
.onKeyDown
Parameters
None.
Returns
Nothing.
Description
Event handler; invoked when a movie clip has input focus and a key is pressed. The onKeyDown
event 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 is invoked.
The movie clip must have input focus enabled and set in order for the onKeyDown
event to work. 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 the Selection.setFocus
method or by setting the tab key to navigate to the clip.
If the Selection.setFocus
method is used, the path for the movie clip must be passed to the Selection.setFocus
method. 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 window:
myMovieClip.onKeyDown = function () { trace ("onKeyDown called"); };
The following example sets input focus:
MovieClip.focusEnabled = true; Selection.setFocus(MovieClip);
See also
![]() ![]() ![]() |