User Guide

378 ActionScript classes
Example
The following example calls the getAscii() 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.getAscii(). 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() {
trace("The ASCII code for the last key typed is: "+Key.getAscii());
};
Key.addListener(keyListener);
When using this example, make sure that you select Control > Disable Keyboard Shortcuts in
the test environment.
The following example adds a call to
Key.getAscii() to show how getAscii() and
getCode() 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);
When using this example, make sure that you select Control > Disable Keyboard Shortcuts in
the test environment.
getCode (Key.getCode method)
public static getCode() : Number
Returns the key code value of the last key pressed.
Note: The Flash Lite implementation of this method returns a string or a number, depending
on the key code passed in by the platform. The only valid key codes are the standard key codes
accepted by this class and the special key codes listed as properties of the ExtendedKey class.
Availability: ActionScript 1.0; Flash Lite 2.0
Returns
Number - The key code of the last key pressed. This method returns 0 if no key was pressed or
released, or if the key code is not accessible for security reasons.