The VkKeyScan function translates a character to the corresponding virtual-key code and shift state for the current keyboard.
SHORT VkKeyScan(
| TCHAR ch | // character to translate |
| ); |
Parameters
ch
Specifies the character to be translated into a virtual-key code.
Return Values
If the function succeeds, the low-order byte of the return value contains the virtual-key code and the high-order byte contains the shift state, which can be a combination of the following flag bits:
| Bit | Meaning |
| 1 | Either SHIFT key is pressed. |
| 2 | Either CTRL key is pressed. |
| 4 | Either ALT key is pressed. |
If the function finds no key that translates to the passed character code, both the low-order and high-order bytes contain -1.
Remarks
For keyboard layouts that use the right-hand ALT key as a shift key (for example, the French keyboard layout), the shift state is represented by the value 6, because the right-hand ALT key is converted internally into CTRL+ALT.
Translations for the numeric keypad (VK_NUMPAD0 through VK_DIVIDE) are ignored. This function is intended to translate characters into keystrokes from the main keyboard section only. For example, the character "7" is translated into VK_7, not VK_NUMPAD7.
VkKeyScan is used by applications that send characters by using the WM_KEYUP and WM_KEYDOWN messages.
See Also
GetAsyncKeyState, GetKeyboardState, GetKeyNameText, GetKeyState, SetKeyboardState, WM_KEYDOWN, WM_KEYUP