User Guide

602 Chapter 7: ActionScript for Flash
See also
MovieClip.onKeyUp
MovieClip.onKeyUp
Availability
Flash Player 6.
Usage
my_mc.onKeyUp = function() {
// your statements here
}
Parameters
None.
Returns
Nothing.
Description
Event handler; invoked when a key is released. The onKeyUp 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. You
can define the function on the Timeline or in a class file that extends the MovieClip class or is
linked to a symbol in the library.
The
onKeyUp event handler works only if the movie clip has input focus enabled and set. First,
the
MovieClip.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 after the mouse
is moved.
Example
The following example defines a function for the onKeyUp method that writes the results of a
trace() method to the log file:
my_mc.onKeyUp = function () {
trace ("onKeyUp called");
};
The following example sets input focus:
my_mc.focusEnabled = true;
Selection.setFocus(my_mc);
See Also
MovieClip.onKeyDown