Key

[property icon] Key

Specifies the accelerator key for the menu item

Integer property

Applies to: MenuItem

Introduced in KCML version 5.03


[property icon] Key

Specifies the accelerator key for the button

Integer property

Applies to: Button , Picture Button

Introduced in KCML version 6.00


>

Key

The Key property is used to define a short cut key for a menu item. It is more powerful than the use of '&' to denote accelerators on controls as it can be used to specify most of the keys on the keyboard, together with the Shift, Ctrl and Alt key status (at least one of these must be included. The text of the menu item is changed to reflect the short-cut key available. It can be set at design time using the menu editor or it can be set programmatically during the enter event.

The value is set using the integer form of the two byte hex string 0xkkss, where kk is the virtual-key code and ss is the shift status. This is the same format as used to specify a windows key in the KCML 5.03 enhanced $KEYBOARD statement.

A similar property is available for buttons.

To set a menu item to be accelerated by the End key a programmer might code in the Enter() event

.menu.PrintButton.key=0x2300
The following table lists most of the likely needed values.

Virtual-Key Code Definitions

The following table includes the virtual-key codes that are defined for Windows. The key code values 0x00 and 0xFF are not used.

First byte Second byte
Name Value
VK_BACK 0x08
VK_TAB 0x09
VK_CLEAR 0x0C
VK_RETURN 0x0D
VK_PAUSE 0x13
VK_ESCAPE 0x1B
VK_SPACE 0x20
VK_PRIOR Page up 0x21
VK_NEXTPage down 0x22
VK_END 0x23
VK_HOME 0x24
VK_LEFT 0x25
VK_UP 0x26
VK_RIGHT 0x27
VK_DOWN 0x28
VK_INSERT 0x2D
VK_DELETE 0x2E
VK_HELP 0x2F
VK_0 0x30
VK_1 0x31
VK_2 0x32
VK_3 0x33
VK_4 0x34
VK_5 0x35
VK_6 0x36
VK_7 0x37
VK_8 0x38
VK_9 0x39
VK_A 0x41
VK_B 0x42
VK_C 0x43
VK_D 0x44
VK_E 0x45
VK_F 0x46
VK_G 0x47
VK_H 0x48
VK_I 0x49
VK_J 0x4A
VK_K 0x4B
VK_L 0x4C
VK_M 0x4D
VK_N 0x4E
VK_O 0x4F
VK_P 0x50
VK_Q 0x51
VK_R 0x52
VK_S 0x53
VK_T 0x54
VK_U 0x55
VK_V 0x56
VK_W 0x57
VK_X 0x58
VK_Y 0x59
VK_Z 0x5A
VK_NUMPAD0 0x60
VK_NUMPAD1 0x61
VK_NUMPAD2 0x62
VK_NUMPAD3 0x63
VK_NUMPAD4 0x64
VK_NUMPAD5 0x65
VK_NUMPAD6 0x66
VK_NUMPAD7 0x67
VK_NUMPAD8 0x68
VK_NUMPAD9 0x69
VK_MULTIPLY 0x6A
VK_ADD 0x6B
VK_SUBTRACT 0x6D
VK_DECIMAL 0x6E
VK_DIVIDE 0x6F
VK_F1 0x70
VK_F2 0x71
VK_F3 0x72
VK_F4 0x73
VK_F5 0x74
VK_F6 0x75
VK_F7 0x76
VK_F8 0x77
VK_F9 0x78
VK_F10 0x79
VK_F11 0x7A
VK_F12 0x7B
VK_F13 0x7C
VK_F14 0x7D
VK_F15 0x7E
VK_F16 0x7F
VK_F17 0x80
VK_F18 0x81
VK_F19 0x82
VK_F20 0x83
VK_F21 0x84
VK_F22 0x85
VK_F23 0x86
VK_F24 0x87
VK_ATTN 0xF6
Shift keys Value
  0x00
Shift 0x01
Ctrl 0x02
Shift-Ctrl 0x03
Alt 0x04
Shift-Alt 0x05
Ctrl-Alt 0x06
Shift-Ctrl-Alt 0x07

Button

The Key property is used to define a short cut key for a button.

This example shows how the shift F6 key may be used as an accelerator for a button

Form1.ActionIt.key = 0x7501

See also

Button methods, properties and events. MenuItem methods, properties and events. Picture Button methods, properties and events.