User Guide

296 Chapter 6: ActionScript Core Classes
Listener summary for the Key class
Key.addListener()
Availability
Flash Player 6.
Usage
Key.addListener (newListener:Object) : Void
Parameters
newListener
An object with methods onKeyDown and onKeyUp.
Returns
Nothing.
Description
Method; registers an object to receive onKeyDown and onKeyUp notification. When a key is
pressed or released, regardless of the input focus, all listening objects registered with
addListener() have either their onKeyDown method or onKeyUp method invoked. Multiple
objects can listen for keyboard notifications. If the listener
newListener is already registered, no
change occurs.
Example
The following example creates a new listener object and defines a function for onKeyDown and
onKeyUp. The last line uses addListener() to register the listener with the Key object so that it
can receive notification from the key down and key up events.
var myListener:Object = new Object();
myListener.onKeyDown = function () {
trace ("You pressed a key.");
}
Key.PGUP
The key code value for the Page Up key. 33
Key.RIGHT
The key code value for the Right Arrow key. 39
Key.SHIFT
The key code value for the Shift key. 16
Key.SPACE
The key code value for the Spacebar. 32
Key.TAB
The key code value for the Tab key. 9
Key.UP
The key code value for the Up Arrow key. 38
Method Description
Key.onKeyDown
Notified when a key is pressed.
Key.onKeyUp
Notified when a key is released.
Property Description Key code