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. For more information, see "Assigning a class to a movie clip symbol" in Using ActionScript in Flash.

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 sends a trace() action to the Output panel:

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

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/mx2004/main_7_2/00001532.html

Add Comment