keyDown

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
keyDown <pKeyName>
Associationscard, field
Summary

Sent when the user presses a key.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
pKeyName

The actual character of the pressed key.

Example
on keyDown theKey 
  if theKey is not a number then beep
  else pass keyDown
end keyDown
RelatedKeyword: field
Property: emacsKeyBindings, extendKey, powerKeys
Message: rawKeyDown, commandKeyDown, returnKey, enterInField, controlKeyDown, arrowKey, backspaceKey, tabKey, functionKey, enterKey, deleteKey, keyUp, optionKeyDown, escapeKey
Command: focus
Function: keysDown
Glossary: handler, character, pass, message, trap
Description

Handle the keyDown message if you want to do something special when the user presses 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 keyDown message is sent. Instead, the returnKey, tabKey, backspaceKey, deleteKey, enterKey, arrowKey, or functionKey message is sent.

If the insertion point is in a field, the entry of typed characters is triggered by the keyDown message. This means that trapping the keyDown message and not passing it prevents typing from being entered in the field.

Note: The keyDown message is sent before the character is placed in the field, so if you need to use the new content of the field, handle the keyUp message instead.

Note: The keydown message is not sent when either of the Option, Control or Command keys are down. In this case, first a rawKeyDownmessage is sent, then one of optionKeyDown, controlKeyDown or commandKeyDown is sent instead of keydown.

Tagsui