keyUp

Sent when the user releases a pressed key.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

keyUp pKeyName

# Params

- pKeyName : The actual character of the pressed key.

# Examples

on keyUp -- play a keyclick sound -- in this example, the parameter is not needed or used play audioClip "click" end keyUp

# Description

Handle the keyUp message if you want to do something special when the user releases any key (or a particular key you check for in the handler).

The message is sent to the active (focused) control, or to the current card if no control is focused.

If the key pressed is the Return, Tab, Backspace, Delete, or Enter key, an arrow key, or a function key, no keyUp message is sent.

>*Cross-platform note:* On Mac OS, the keyUp > message is sent after any keyDown handlers finish > execute, whether or not the key has been released. On > Unix and Windows, the keyUp message is sent > when the key is released, after the typed character has been added to > the current field. To test whether a key is actually being pressed, > use the keysDown function.

# Tags

ui,

# See

- **keyword:** field - **message:** keyDown - **command:** focus - **function:** keysDown - **control structure:** function - **glossary:** handler, Unix, message, Windows, Mac OS, execute