ActionScript for Flash MX: The Definitive Guide, Second Edition

MovieClip.onKeyUp () Event Handler

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

682

|

ActionScript Language Reference

MovieClip.onKeyUp () Event Handler

handler executed when a key is released while the clip has focus

Flash 5; callback form introduced in Flash 6

mc.onKeyUp()

onClipEvent (keyUp) {

statements

}

Description

The onKeyUp() event handler is the callback form (and more modern analogue) of the

legacy onClipEvent(keyUp) event handler. However, its behavior changes depending on the

form it takes. When implemented as a callback function, onKeyUp() executes only when a

key is released while the clip specified by

mc has keyboard focus. A clip can be focused via

the Tab key or Selection.setFocus(), but only when it either defines at least one button

handler or when its

tabEnabled or focusEnabled properties are true. For example:

// Specify the onKeyUp() callback

theClip_mc.onKeyUp = function () {

this._xscale++; // Make the clip wider when a key is released.

}

// Allow focusing

theClip_mc.focusEnabled = true;

// Focus the clip

Selection.setFocus(mc);

Take heed that keyboard focus on a movie clip is lost the instant mouse movement over the

Flash Player is detected. For details, see MovieClip.onKeyDown().

The onClipEvent(keyUp) form of onKeyUp() executes whenever any key is released. It

requires only that the Flash Player itself be focused. ...