R3vo/Sandbox – User

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Add last base 10 codes)
m (Wipe)
Tag: Blanking
Line 1: Line 1:
{{SideTOC}}
Each key on any keyboard has a unique Direct Input Keyboard (DIK) code. They are '''not''' character symbols. They refer to the '''position of the key''' on the keyboard. In other words, depending on the keyboard layout, the actual key can change, but its position is always identical. This is useful to '''fulfill ergonomic needs'''.


'''In addition to that, using DIK codes has more advantages:'''
* Recognize keys that can not be represented in character equivalents. Function keys for example have no character set code.
* Using the defines below, makes using key codes easier in configs, since the actual code is replaced by a memorable string e.g., DIK_K instead of 0x25.
* Unique DIK codes exist for numeric pad '9' versus standard key '9'. These are key-codes, not, characters.
{{Informative|Specific keys cannot be detected with DIK codes, since the position of the keys changes with the Keyboard layout (Qwerty, [http://en.wikipedia.org/wiki/Dvorak_Simplified_Keyboard Dvorak]).}}
== Usage in scripts ==
DIK codes are '''always''' accompanied by the state of the SHIFT, ALT, and CTRL keys. Any script can differentiate between 'Q' and ALT-Q.
{{Informative|For parameters passed to key event handlers see [[User_Interface_Event_Handlers#onKeyDown|onKeyDown]] EH.}}
=== Example Script ===
<code>[[params]] ["_ctrl","_button","_BtnShift","_BtnCtrl","_BtnAlt"];<br>
[[private]] _buttonDisabled = [[false]]; {{cc|[[true]]: block the original comand, [[false]]: Execute the normal command of that button}}
[[private]] _blockInput = { _ButtonDisabled = [[true]]; };<br>
[[if]] (_button [[isEqualTo]] 17) [[then]] {{cc|17 {{=}} 0x11 {{=}} "W"}}
{
{{cc|For now, button W is just registered, but won't block the original command for now (player can move forward).}}<br>
{{cc|If SHIFT is pressed, block "W" (walk forward) and show the systemchat message}}
[[if]] (_BtnShift) [[then]]
{
[[systemChat]] "Shift+W pressed";
[[call]] _blockInput; {{cc|call to disable the original command}}
};
};<br>
_buttonDisabled</code>
== Defines ==
=== Header ===
'''Personal Tools'''
<syntaxhighlight lang="cpp">#include "\bin\dikCodes.h"</syntaxhighlight>
'''{{arma3}}'''
<syntaxhighlight lang="cpp">#include "\a3\ui_f\hpp\definedikcodes.inc"</syntaxhighlight>
=== DIK Codes for QWERTY ===
{| class="wikitable sortable"
! Key
! Type
! DIK ID
! Hexadecimal
! Integer
! Note
|- <!-- F1..F15 -->
| F1 || F1..F15 || DIK_F1 || 0x3B || 59 || {{n/a}}
|-
| F2 || F1..F15 || DIK_F2 || 0x3C || 60 || {{n/a}}
|-
| F3 || F1..F15 || DIK_F3 || 0x3D || 61 || {{n/a}}
|-
| F4 || F1..F15 || DIK_F4 || 0x3E || 62 || {{n/a}}
|-
| F5 || F1..F15 || DIK_F5 || 0x3F || 63 || {{n/a}}
|-
| F6 || F1..F15 || DIK_F6 || 0x40 || 64 || {{n/a}}
|-
| F7 || F1..F15 || DIK_F7 || 0x41 || 65 || {{n/a}}
|-
| F8 || F1..F15 || DIK_F8 || 0x42 || 66 || {{n/a}}
|-
| F9 || F1..F15 || DIK_F9 || 0x43 || 67 || {{n/a}}
|-
| F10 || F1..F15 || DIK_F10 || 0x44 || 68 || {{n/a}}
|-
| F11 || F1..F15 || DIK_F11 || 0x57 || 87 || {{n/a}}
|-
| F12 || F1..F15 || DIK_F12 || 0x58 || 88 || {{n/a}}
|-
| F13 || F1..F15 || DIK_F13 || 0x64 || 100 || NEC PC98
|-
| F14 || F1..F15 || DIK_F14 || 0x65 || 101 || NEC PC98
|-
| F15 || F1..F15 || DIK_F15 || 0x66 || 102 ||NEC PC98
|- <!-- NUMERICAL -->
| 0 || 0..9 || DIK_0 || 0x0B || 11 || {{n/a}}
|-
| 1 || 0..9 || DIK_1 || 0x02 || 2 || {{n/a}}
|-
| 2 || 0..9 || DIK_2 || 0x03 || 3 || {{n/a}}
|-
| 3 || 0..9 || DIK_3 || 0x04 || 4 || {{n/a}}
|-
| 4 || 0..9 || DIK_4 || 0x05 || 5 || {{n/a}}
|-
| 5 || 0..9 || DIK_5 || 0x06 || 6 || {{n/a}}
|-
| 6 || 0..9 || DIK_6 || 0x07 || 7 || {{n/a}}
|-
| 7 || 0..9 || DIK_7 || 0x08 || 8 || {{n/a}}
|-
| 8 || 0..9 || DIK_8 || 0x09 || 9 || {{n/a}}
|-
| 9 || 0..9 || DIK_9 || 0x0A || 10 || {{n/a}}
|- <!-- NUMPAD -->
| 0 || Numpad || DIK_NUMPAD0 || 0x52 || 82 || {{n/a}}
|-
| 1 || Numpad || DIK_NUMPAD1 || 0x4F || 79 || {{n/a}}
|-
| 2 || Numpad || DIK_NUMPAD2 || 0x50 || 80 || {{n/a}}
|-
| 3 || Numpad || DIK_NUMPAD3 || 0x51 || 81 || {{n/a}}
|-
| 4 || Numpad || DIK_NUMPAD4 || 0x4B || 75 || {{n/a}}
|-
| 5 || Numpad || DIK_NUMPAD5 || 0x4C || 76 || {{n/a}}
|-
| 6 || Numpad || DIK_NUMPAD6 || 0x4D || 77 || {{n/a}}
|-
| 7 || Numpad || DIK_NUMPAD7 || 0x47 || 71 || {{n/a}}
|-
| 8 || Numpad || DIK_NUMPAD8 || 0x48 || 72 || {{n/a}}
|-
| 9 || Numpad || DIK_NUMPAD9 || 0x49 || 73 || {{n/a}}
|- <!-- Alphabet -->
| A || A..Z || DIK_A || 0x1E || 30 || {{n/a}}
|-
| B || A..Z || DIK_B || 0x30 || 48 || {{n/a}}
|-
| C || A..Z || DIK_C || 0x2E || 46 || {{n/a}}
|-
| D || A..Z || DIK_D || 0x20 || 32 || {{n/a}}
|-
| E || A..Z || DIK_E || 0x12 || 18 || {{n/a}}
|-
| F || A..Z || DIK_F || 0x21 || 33 || {{n/a}}
|-
| G || A..Z || DIK_G || 0x22 || 34 || {{n/a}}
|-
| H || A..Z || DIK_H || 0x23 || 35 || {{n/a}}
|-
| I || A..Z || DIK_I || 0x17 || 17 || {{n/a}}
|-
| J || A..Z || DIK_J || 0x24 || 36 || {{n/a}}
|-
| K || A..Z || DIK_K || 0x25 || 37 || {{n/a}}
|-
| L || A..Z || DIK_L || 0x26 || 38 || {{n/a}}
|-
| M || A..Z || DIK_M || 0x32 || 50 || {{n/a}}
|-
| N || A..Z || DIK_N || 0x31 || 49 || {{n/a}}
|-
| O || A..Z || DIK_O || 0x18 || 24 || {{n/a}}
|-
| P || A..Z || DIK_P || 0x19 || 25 || {{n/a}}
|-
| Q || A..Z || DIK_Q || 0x10 || 16 || {{n/a}}
|-
| R || A..Z || DIK_R || 0x13 || 19 || {{n/a}}
|-
| S || A..Z || DIK_S || 0x1F || 31 || {{n/a}}
|-
| T || A..Z || DIK_T || 0x14 || 20 || {{n/a}}
|-
| U || A..Z || DIK_U || 0x16 || 22 || {{n/a}}
|-
| V || A..Z || DIK_V || 0x2F || 47 || {{n/a}}
|-
| W || A..Z || DIK_W || 0x11 || 11 || {{n/a}}
|-
| X || A..Z || DIK_X || 0x2D || 45 || {{n/a}}
|-
| Y || A..Z || DIK_Y || 0x15 || 15 || {{n/a}}
|-
| Z || A..Z || DIK_Z || 0x2C || 44 || {{n/a}}
|- <!-- Control keys -->
| Escape || Control key || DIK_ESCAPE || 0x01 || 1 || {{n/a}}
|-
| Tab || Control key || DIK_TAB || 0x0F || 15 || {{n/a}}
|-
| Shift (left) || Control key || DIK_LSHIFT || 0x2A || 42 || {{n/a}}
|-
| Shift (right) || Control key || DIK_RSHIFT || 0x36 || 54 || {{n/a}}
|-
| Control (left) || Control key || DIK_LCONTROL || 0x1D || 29 || {{n/a}}
|-
| Control (right) || Control key || DIK_RCONTROL || 0x9D || 157 ||  {{n/a}}
|-
| Backspace || Control key || DIK_BACK || 0x0E || 14 || {{n/a}}
|-
|  || Control key || DIK_BACKSPACE || colspan="2" | DIK_BACK || {{n/a}}
|-
| Enter (main) || Control key || DIK_RETURN || 0x1C || 28 || {{n/a}}
|-
| Enter (numpad) || Control key || DIK_NUMPADENTER || 0x9C || 156 || {{n/a}}
|-
| Alt (left) || Control key || DIK_LMENU || 0x38 || 56 || {{n/a}}
|-
|  || Control key || DIK_LALT || colspan="2" | DIK_LMENU || {{n/a}}
|-
|  || Control key || DIK_SPACE || 0x39 || 57 || {{n/a}}
|-
| Caps lock || Control key || DIK_CAPITAL || 0x3A || 58 || {{n/a}}
|-
| Caps lock || Control key || DIK_CAPSLOCK || colspan="2" | DIK_CAPITAL || {{n/a}}
|-
| Num lock (numpad) || Control key || DIK_NUMLOCK || 0x45 || 69 || {{n/a}}
|-
| Scroll lock || Control key || DIK_SCROLL || 0x46 || 70 || {{n/a}}
|-
| Menu button || Control key || DIK_RMENU || 0xB8 || 184 || {{n/a}}
|-
| Alt (right) || Control key || DIK_RALT || colspan="2" | DIK_RMENU || {{n/a}}
|- <!-- Graphics ? -->
|  || Graphics || DIK_AT || 0x91 || 145 || NEC PC98
|-
|  || Graphics || DIK_COLON || 0x92 || 146 || NEC PC98
|-
|  || Graphics || DIK_UNDERLINE || 0x93 || 147 || NEC PC98
|-
| Minus (on main keyboard) || Graphics || DIK_MINUS || 0x0C || 12 || {{n/a}}
|-
|  || Graphics || DIK_EQUALS || 0x0D || 13 || {{n/a}}
|-
|  || Graphics || DIK_LBRACKET || 0x1A || 26 || {{n/a}}
|-
|  || Graphics || DIK_RBRACKET || 0x1B || 27 || {{n/a}}
|-
| Semicolon || Graphics || DIK_SEMICOLON || 0x27 || 39 || {{n/a}}
|-
| Apostrophe || Graphics || DIK_APOSTROPHE || 0x28 || 40 || {{n/a}}
|-
| Accent grave || Graphics || DIK_GRAVE || 0x29 || 41 || {{n/a}}
|-
| Backslash || Graphics || DIK_BACKSLASH || 0x2B || 43 || {{n/a}}
|-
| Comma || Graphics || DIK_COMMA || 0x33 || 51 || {{n/a}}
|-
| Period (main) || Graphics || DIK_PERIOD || 0x34 || 52 || {{n/a}}
|-
| Slash (main) || Graphics || DIK_SLASH || 0x35 || 53 || {{n/a}}
|-
| * (numpad) || Graphics || DIK_MULTIPLY || 0x37 || 55 || {{n/a}}
|-
| * (numpad) || Graphics || DIK_NUMPADSTAR || colspan="2" | DIK_MULTIPLY || {{n/a}}
|-
| - (numpad) || Graphics || DIK_SUBTRACT || 0x4A || 74 || {{n/a}}
|-
| + (numpad) || Graphics || DIK_ADD || 0x4E || 78 || {{n/a}}
|-
| . (numpad) || Graphics || DIK_DECIMAL || 0x53 || 83 || {{n/a}}
|-
| {{=}} (numpad) || Graphics || DIK_NUMPADEQUALS || 0x8D || 141 || NEC PC98
|-
| - (numpad) || Graphics || DIK_NUMPADMINUS || colspan="2" | DIK_SUBTRACT || {{n/a}}
|-
| + (numpad) || Graphics || DIK_NUMPADPLUS || colspan="2" | DIK_ADD || {{n/a}}
|-
| . (numpad) || Graphics || DIK_NUMPADPERIOD || colspan="2" | DIK_DECIMAL || {{n/a}}
|-
| / (numpad) || Graphics || DIK_NUMPADSLASH || colspan="2" | DIK_DIVIDE || {{n/a}}
|- <!-- KataKana -->
|  || KataKana || DIK_KANA || 0x70 || 112 || Japanese keyboard
|-
|  || KataKana || DIK_ABNT_C1 || 0x73 ||  115 || / ? on Portugese (Brazilian) keyboards
|-
|  || KataKana || DIK_CONVERT || 0x79 || 121 || Japanese keyboard
|-
|  || KataKana || DIK_NOCONVERT || 0x7B || 123 || Japanese keyboard
|-
|  || KataKana || DIK_YEN || 0x7D || 125 || Japanese keyboard
|-
|  || KataKana || DIK_OEM_102 || 0x56 || 86 || < > | on UK/Germany keyboards
|-
|  || KataKana || DIK_ABNT_C2 || 0x7E || 126 || Numpad . on Portugese (Brazilian) keyboards
|-
|  || KataKana || DIK_PREVTRACK || 0x90 || 144 || Previous Track (DIK_CIRCUMFLEX on Japanese keyboard)
|-
|  || KataKana || DIK_KANJI || 0x94 || 148 || Japanese keyboard
|-
|  || KataKana || DIK_STOP || 0x95 || 149 || NEC PC98
|-
|  || KataKana || DIK_AX || 0x96 || 150 || Japan AX
|-
|  || KataKana || DIK_UNLABELED || 0x97 || 151 || J3100
|-
|  || KataKana || DIK_NUMPADCOMMA || 0xB3 || 179 || , on numeric keypad - NEC PC98
|-
|  || KataKana || DIK_CIRCUMFLEX || colspan="2" | DIK_PREVTRACK || Japanese keyboard
|- <!-- Apps -->
|  || Apps || DIK_NEXTTRACK || 0x99 || 153 || Next Track
|-
|  || Apps || DIK_MUTE || 0xA0 || 160 || Mute
|-
|  || Apps || DIK_CALCULATOR || 0xA1 || 161 || Calculator
|-
|  || Apps || DIK_PLAYPAUSE || 0xA2 || 162 || Play / Pause
|-
|  || Apps || DIK_MEDIASTOP || 0xA4 || 164 || Media Stop
|-
|  || Apps || DIK_VOLUMEDOWN || 0xAE || 174 || Volume -
|-
|  || Apps || DIK_VOLUMEUP || 0xB0 || 176 || Volume +
|-
|  || Apps || DIK_WEBHOME || 0xB2 || 178 || Web home
|-
|  || Apps || DIK_SYSRQ || 0xB7 || 183 || {{n/a}}
|-
|  || Apps || DIK_PAUSE || 0xC5 || 197 || Pause
|-
|  || Apps || DIK_APPS || 0xDD || 221 || AppMenu key
|-
|  || Apps || DIK_POWER || 0xDE || 222 || System Power
|-
|  || Apps || DIK_SLEEP || 0xDF || 223 || System Sleep
|-
|  || Apps || DIK_WAKE || 0xE3 || 227 || System Wake
|-
|  || Apps || DIK_WEBSEARCH || 0xE5 || 229 || Web Search
|-
|  || Apps || DIK_WEBFAVORITES || 0xE6 || 230 || Web Favorites
|-
|  || Apps || DIK_WEBREFRESH || 0xE7 || 231 || Web Refresh
|-
|  || Apps || DIK_WEBSTOP || 0xE8 || 232 || Web Stop
|-
|  || Apps || DIK_WEBFORWARD || 0xE9 || 233 || Web Forward
|-
|  || Apps || DIK_WEBBACK || 0xEA || 234 || Web Back
|-
|  || Apps || DIK_MYCOMPUTER || 0xEB || 235 || My Computer
|-
|  || Apps || DIK_MAIL || 0xEC || 236 || Mail
|-
|  || Apps || DIK_MEDIASELECT || 0xED || 237 || Media Select
|- <!-- ArrowKeypad -->
|  || ArrowKeypad || DIK_HOME || 0xC7 || 199 || Home on arrow keypad
|-
|  || ArrowKeypad || DIK_UP || 0xC8 || 200 || UpArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_PRIOR || 0xC9 || 201 || PgUp on arrow keypad
|-
|  || ArrowKeypad || DIK_LEFT || 0xCB || 203 || LeftArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_RIGHT || 0xCD || 205 || RightArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_END || 0xCF || 207 || End on arrow keypad
|-
|  || ArrowKeypad || DIK_DOWN || 0xD0 || 208 || DownArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_NEXT || 0xD1 || 209 || PgDn on arrow keypad
|-
|  || ArrowKeypad || DIK_INSERT || 0xD2 || 210 || Insert on arrow keypad
|-
|  || ArrowKeypad || DIK_DELETE || 0xD3 || 211 || Delete on arrow keypad
|-
|  || ArrowKeypad || DIK_UPARROW || colspan="2" | DIK_UP || UpArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_PGUP || colspan="2" | DIK_PRIOR || PgUp on arrow keypad
|-
|  || ArrowKeypad || DIK_LEFTARROW || colspan="2" | DIK_LEFT || LeftArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_RIGHTARROW || colspan="2" | DIK_RIGHT || RightArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_DOWNARROW || colspan="2" | DIK_DOWN || DownArrow on arrow keypad
|-
|  || ArrowKeypad || DIK_PGDN || colspan="2" | DIK_NEXT || PgDn on arrow keypad
|- <!-- Others -->
| OS key (left) || Other || DIK_LWIN || 0xDB || 219 || Left Windows key
|-
| OS key (right) || Other || DIK_RWIN || 0xDC || 220 || Right Windows key
|}
== German keyboard ==
{| class="wikitable sortable" style="text-align: center"
! Number
! Key Name
! Number
! Key Name
! Number
! Key Name
|-
| 1 || ESC || 11 || 0 || 21 || Z
|-
| 2 || 1 || 12 || ß || 22 || U
|-
| 3 || 2 || 13 || ´ || 23 || I
|-
| 4 || 3 || 14 || BACKSPACE || 24 || O
|-
| 5 || 4 || 15 || TAB || 25 || P
|-
| 6 || 5 || 16 || Q || 26 || Ü
|-
| 7 || 6 || 17 || W || ||
|-
| 8 || 7 || 18 || E || 28 || ENTER
|-
| 9 || 8 || 19 || R || 29 || STRGL
|-
| 10 || 9 || 20 || T || 30 || A
|-
| 31 || S || 41 || ^ || 51 || ,
|-
| 32 || D || 42 || SHIFTL || 52 || .
|-
| 33 || F || 43 || # || 53 || -
|-
| 34 || G || 44 || Y || 54 || SHIFTR
|-
| 35 || H || 45 || X || 55 || NUM_*
|-
| 36 || J || 46 || C || 56 || ALT
|-
| 37 || K || 47 || V || 57 || SPACE
|-
| 38 || L || 48 || B || 58 || CAPS
|-
| 39 || Ö || 49 || N || 59 || F1
|-
| 40 || Ä || 50 || M || 60 || F2
|-
| 61 || F3 || 71 || NUM_7 || 81 || NUM_3
|-
| 62 || F4 || 72 || NUM_8 || 82 || NUM_0
|-
| 63 || F5 || 73 || NUM_9 || 83 || NUM_,
|-
| 64 || F6 || 74 || NUM_- ||  ||
|-
| 65 || F7 || 75 || NUM_4 ||  ||
|-
| 66 || F8 || 76 || NUM_5 || 86 || <
|-
| 67 || F9 || 77 || NUM_6 || 87 || F11
|-
| 68 || F10 || 78 || NUM_+ || 88 || F12
|-
| 69 || NUM || 79 || NUM_1 ||  ||
|-
| 70 || SCROLL || 80 || NUM_2 ||  ||
|-
| 156 || NUM_ENTER || 200 || UP || 211 || DELETE
|-
| 157 || STRGR || 201 || PAGEUP || 219 || WINR
|-
|  ||  || 220 || WINL || ||
|-
| 181 || NUM_/ || 203 || LEFT || 221 || APP
|-
| 183 || PRINT ||  ||  || ||
|-
| 184 || ALTGR || 205 || RIGHT || NOT DEFINED || +
|-
| 197 || PAUSE || 207 || END ||  ||
|-
| 199 || POS1 || 208 || DOWN ||  ||
|-
|  ||  || 209 || PAGEDOWN ||  ||
|-
|  ||  || 210 || INSERT ||  ||
|}
== French keyboard ==
{| class="wikitable" style="text-align: center"
! Number
! Key Name
! Number
! Key Name
! Number
! Key Name
|-
| 1 || ESC || 11 || 0 || 21 || Y
|-
| 2 || 1 || 12 || ) || 22 || U
|-
| 3 || 2 || 13 || = || 23 || I
|-
| 4 || 3 || 14 || BACKSPACE || 24 || O
|-
| 5 || 4 || 15 || TAB || 25 || P
|-
| 6 || 5 || 16 || A || 26 || ^
|-
| 7 || 6 || 17 || Z || 27 || $
|-
| 8 || 7 || 18 || E || 28 || ENTER
|-
| 9 || 8 || 19 || R || 29 || CTRLG
|-
| 10 || 9 || 20 || T || 30 || Q
|-
|-
| 31 || S || 41 || ² || 51 || ;
|-
| 32 || D || 42 || SHIFTL || 52 || :
|-
| 33 || F || 43 || * || 53 || !
|-
| 34 || G || 44 || W || 54 || SHIFTR
|-
| 35 || H || 45 || X || 55 || NUM_*
|-
| 36 || J || 46 || C || 56 || ALT
|-
| 37 || K || 47 || V || 57 || SPACE
|-
| 38 || L || 48 || B || 58 || CAPS
|-
| 39 || M || 49 || N || 59 || F1
|-
| 40 || ù || 50 || , || 60 || F2
|-
| 61 || F3 || 71 || NUM_7 || 81 || NUM_3
|-
| 62 || F4 || 72 || NUM_8 || 82 || NUM_0
|-
| 63 || F5 || 73 || NUM_9 || 83 || NUM_.
|-
| 64 || F6 || 74 || NUM_- ||  ||
|-
| 65 || F7 || 75 || NUM_4 ||  ||
|-
| 66 || F8 || 76 || NUM_5 || 86 || <
|-
| 67 || F9 || 77 || NUM_6 || 87 || F11
|-
| 68 || F10 || 78 || NUM_+ || 88 || F12
|-
| 69 || NUM || 79 || NUM_1 ||  ||
|-
| 70 || SCROLL || 80 || NUM_2 ||  ||
|-
| 156 || NUM_ENTER || 200 || UP || 211 || DELETE
|-
| 157 || CTRLR || 201 || PAGEUP || 219 || WINR
|-
|  ||  || 220 || WINL || ||
|-
| 181 || NUM_/ || 203 || LEFT || 221 || APP
|-
| 183 || PRINT ||  ||  || ||
|-
| 184 || ALTGR || 205 || RIGHT || NOT DEFINED || +
|-
| 197 || PAUSE || 207 || END ||  ||
|-
| 199 || POS1 || 208 || DOWN ||  ||
|-
|  ||  || 209 || PAGEDOWN ||  ||
|-
|  ||  || 210 || INSERT ||  ||
|}
[[Category:Reference Lists]]
[[Category:Scripting Topics]]

Revision as of 14:15, 27 March 2020