User Guide

304 Chapter 6: ActionScript Core Classes
Example
The following example calls the getCode() method any time a key is pressed. The example
creates a listener object named
keyListener and defines a function that responds to the
onKeyDown event by calling Key.getCode(). The keyListener object is then registered to the
Key object, which broadcasts the onKeyDown message whenever a key is pressed while the SWF
file plays.
var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
// compare return value of getCode() to constant
if (Key.getCode() == Key.ENTER) {
trace ("Virtual key code: "+Key.getCode()+" (ENTER key)");
}
else {
trace("Virtual key code: "+Key.getCode());
}
};
Key.addListener(keyListener);
The following example adds a call to Key.getAscii() to show how the two methods differ. The
main difference is that
Key.getAscii() differentiates between uppercase and lowercase letters,
and
Key.getCode() does not.
var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
trace("For the last key typed:");
trace("\tThe Key code is: "+Key.getCode());
trace("\tThe ASCII value is: "+Key.getAscii());
trace("");
};
Key.addListener(keyListener);
See also
Key.getAscii()
Key.HOME
Availability
Flash Player 5.
Usage
Key.HOME:Number
Description
Property; constant associated with the key code value for the Home key (36).
Example
The following example attaches a draggable movie clip called car_mc at the x and y coordinates of
0,0. When you press the Home key, car_mc returns to 0,0. Create a movie clipthat has a linkage
ID
car_id, and add the following ActionScript: