Input Device Action Names Used in Cloanto Software

Abstract

This document describes the names associated to keyboard and other input device actions as implemented in scripting and configuration files used by Cloanto applications.

Overview to Keyboard Names

Keyboard names include all single-character marks that appear on keyboard keys, like "A", "@" or "5". These names are not case sensitive, i.e. "a" is the same as "A". Special attributes (e.g. UPPERCASE, or SHIFT and/or CAPS LOCK) must be used to indicate specific conditions such as upper or lower case, numeric keypad, etc. Attributes are also used to indicate certain combinations of control keys and non-control keys.

Names for Graphical Keys

All graphical keys can be represented by the single character which they are associated with, using either ISO 8859-1 or Unicode representation. In certain contexts, however, it is necessary or preferable to avoid the use of certain characters, which may be confused with control characters. For this reason, the following names are available as aliases (synonyms), of characters which may be considered special.

PLUS

MINUS

HYPHEN

PERIOD

COMMA

EURO

POUND

YEN

EQUAL

QUOTEDBL

BACKSLASH

SEMICOLON

Names for Non-Graphical Keys

The following names are used to describe keys which do not enter text, but rather are associated with some control or spacing action. Where a key name exists with the LEFT or RIGHT prefix, the key name without prefix means "either LEFT or RIGHT".

SPACEBAR

ESC

TAB

ENTER

BACKSPACE

INSERT

DELETE

HOME

END

PAGE UP

PAGE DOWN

UP ARROW

DOWN ARROW

LEFT ARROW

RIGHT ARROW

PRINT SCREEN

SYS RQ

NUM LOCK

SCROLL LOCK

PAUSE

BREAK

APPLICATION

F1 .. F24

SHIFT

LEFT SHIFT

RIGHT SHIFT

ALT

LEFT ALT

RIGHT ALT

CTRL

LEFT CTRL

RIGHT CTRL

WINDOWS

LEFT WINDOWS

RIGHT WINDOWS

CAPS LOCK

Keyboard Attributes

The following Keyboard Attributes can be combined together, and must be used in combination with a non-attribute key name. Attributes can be combined with the "+" sign. Space separators are optional. The KEYBOARD, NUMERIC KEYPAD, UPPERCASE and LOWERCASE attributes are used immediately before a key name, separated by a space, but without "+" sign.

SHIFT+

ALT+

CTRL+

WINDOWS+

LEFT SHIFT+

RIGHT SHIFT+

LEFT ALT+

RIGHT ALT+

LEFT CTRL+

RIGHT CTRL+

LEFT WINDOWS+

RIGHT WINDOWS+

CAPS LOCK+

ALT GR+

KEYBOARD

NUMERIC KEYPAD

UPPERCASE

LOWERCASE

Names for Non-Keyboard Buttons

The following names are used to describe mouse and joystick button actions. If there are multiple mice or joysticks, it is assumed that the event is related to the primary or default device. The PRIMARY mouse button is usually the left mouse button, and the SECONDARY mouse button is the right button.

MOUSE PRIMARY

MOUSE MIDDLE

MOUSE SECONDARY

JOYSTICK FORWARD

JOYSTICK BACK

JOYSTICK LEFT

JOYSTICK RIGHT

JOYSTICK FIRE

Examples

The following are example of valid key name combinations:

NUMERIC KEYPAD PLUS SIGN

NUMERIC KEYPAD +

LEFT SHIFT+NUMERIC KEYPAD 5

KEYBOARD ENTER

LEFT ALT + RIGHT ALT + SHIFT + RIGHT WINDOWS + PLUS