This function is called by the IME control panel application to set the value of the input method editor (IME) hot key.
At a Glance
Header file: | Imm.h |
Windows CE versions: | 2.10 and later |
Syntax
BOOL WINAPI ImmSetHotKey( DWORD dwHotKeyID, UINT uModifiers, UINT uVKey, HKL hKL );
Parameters
dwHotKeyID
[in] Specifies the hot key identifier.
uModifiers
[in] Pointer to the combination keys used with the hot key. Keys include MOD_ALT, MOD_CONTROL, MOD_SHIFT, MOD_LEFT, and MOD_RIGHT. The key up flag, MOD_ON_KEYUP, indicates the hot key is effective when the key is up. The modifier ignore flag, MOD_IGNORE_ALL_MODIFIER, indicates the combination of modifiers are ignored in hot key matching.
uVKey
[in] Virtual key code of the hot key.
hKL
[in] Handle to the keyboard layout of the IME. If this parameter is specified, the hot key can switch to the IME with this keyboard layout handle.
Windows CE does not support true keyboard layouts. In this instance, however, Windows CE uses the keyboard handle to associate hot keys with a specific IME and locale.
Return Values
TRUE indicates success. FALSE indicates failure.
Remarks
For a key that is not on each side of the keyboard, uModifiers should specify both sides, MOD_LEFT|MODE_RIGHT.
Windows CE supports the following hot key identifiers:
Hot Key Identifier | Description |
IME_CHOTKEY_SHAPE_TOGGLE | For simplified Chinese, toggles the shape conversion mode of IME. |
IME_CHOTKEY_SYMBOL_TOGGLE | For simplified Chinese, toggles the symbol conversion mode of IME. Symbol mode indicates that the user can input Chinese punctuation and symbols by mapping to the punctuation and symbols on the keyboard. |
IME_JHOTKEY_CLOSE_OPEN | For Japanese, alternately opens and closes the IME. |
IME_KHOTKEY_ENGLISH | Switches to from Korean to English. |
IME_KHOTKEY_SHAPE_TOGGLE | For Korean, toggles the shape conversion mode of IME. |
IME_KHOTKEY_HANJACONVERT | For Korean, switches to Hanja conversion. |
IME_THOTKEY_SHAPE_TOGGLE | For traditional Chinese, toggles the shape conversion mode of IME. |
IME_THOTKEY_SYMBOL_TOGGLE | For traditional Chinese, toggles the symbol conversion mode of IME. |
IME_HOTKEY_DSWITCH_FIRST through IME_HOTKEY_DSWITCH_LAST | Enables a IME to be switched. |