onKeyDown, onKeyUp fields

Code field

Code carried out when a key is pressed or released.

Applies to...

• audio tag
• box tag
• button tag
• checkBox tag
• choiceBox tag
• clientFrame tag
• console tag instance
• ellipse tag
• img tag
• input tag
• line tag
• span tag
• table tag
• tabRow tag
• video tag

Sample usage

• <console.onKeyDown.push <if <eq key, 32> then=<putLn {/space}>>> sends /space whenever the space bar is pressed.
• <msg:input onKeyDown=<if <eq key, 13> then=<putLn msg>, <msg.clear>>> sends the text when Enter is pressed in the input box.

Behaviour

A code field: holds code to be carried out each time the event happens. Add code after the tag is created with .push.

While the code runs, key holds a number identifying the key (not the character it types):

Key events go to the tag the user is typing in, and also to the console. Use the console's onKeyDown to respond to keys anywhere.

See also

• onKeyPress field
• onInput field
• Events in Depth (Programmer's Guide)