User Guide

Button 363

onKeyUp (Button.onKeyUp handler)

onKeyUp = function() {}

Invoked when a button has input focus and a key is released. The onKeyUp event handler is

invoked with no parameters. You can use the

Key.getAscii() and Key.getCode() methods

to determine which key was pressed.

Availability: ActionScript 1.0; Flash Player 6

Example

In the following example, a function that sends text to the Output panel is defined for the

onKeyDown handler. Create a button called my_btn on the Stage, and enter the following

ActionScript in a frame on the Timeline:

my_btn.onKeyDown = function() {

trace("onKeyDown: "+this._name+" (Key: "+getKeyPressed()+")");

};

my_btn.onKeyUp = function() {

trace("onKeyUp: "+this._name+" (Key: "+getKeyPressed()+")");

};

function getKeyPressed():String {

var theKey:String;

switch (Key.getAscii()) {

case Key.BACKSPACE :

theKey = "BACKSPACE";

break;

case Key.SPACE :

theKey = "SPACE";

break;

default :

theKey = chr(Key.getAscii());

}

return theKey;

}

Press Control+Enter to test the SWF file. Make sure you select Control > Disable Keyboard

Shortcuts in the test environment. Then press the Tab key until the button has focus (a yellow

rectangle appears around the

my_btn instance) and start pressing keys on your keyboard.

When you press keys, they are displayed in the Output panel.