Table of Contents

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. For example:

// Code on a movie clip instance
onClipEvent (keyUp) {
  trace("A key was pressed!");
}

As of Flash 6, the Key.onKeyUp( ) listener event is generally preferred over MovieClip.onKeyUp( ); see the Key object for much more information.

Usage

In Flash 6, the updateAfterEvent( ) function (which refreshes the screen between frames) works with MovieClip.onKeyUp( ), but not with Key.onKeyUp( ).

The onKeyUp( ) handler does not work with main movie timelines (e.g., _root, _level1, _level2) because main timelines cannot receive input focus.

See Also

Key.onKeyDown( ), Key.onKeyUp( ), MovieClip.focusEnabled, MovieClip.onKeyDown( ), MovieClip.tabEnabled

Table of Contents