IMEStatus Function |
No
IMEStatus()
A Long representing the status of the input method editor (IME), as represented by the following constants for the Japanese, simplified Chinese, and traditional Chinese locales:
Constant | Value | Description |
---|---|---|
vbIMENoOP | 0 | IME not implemented. |
vbIMEOn | 1 | IME is on. |
vbIMEOff | 2 | IME is off. |
vbIMEDisable | 3 | IME is disabled (Japanese locale only). |
vbIMEHiragana | 4 | IME is using Hiragana double-byte characters (Japanese locale only). |
vbIMEKatakanaDbl | 5 | IME is using Katakana double-byte characters (Japanese locale only). |
vbIMEKatakanaSng | 6 | IME is using Katakana single-byte characters (Japanese locale only). |
vbIMEAlphaDbl | 7 | IME is using an alphanumeric double-byte character set (Japanese locale only). |
vbIMEAlphaSng | 8 | IME is using an alphanumeric single-byte character set (Japanese locale only). |
For a Korean locale, the status of the IME is given by the five low-order bytes of the return value:
Byte | Value | Description |
---|---|---|
0 | 0 | IME not installed |
1 | IME installed | |
1 | 0 | IME disabled |
1 | IME enabled | |
2 | 0 | IME English mode |
1 | Hangeul mode | |
3 | 0 | Banja mode (single-byte) |
1 | Junja mode (double-byte) | |
4 | 0 | Normal mode |
1 | Hanja conversion mode |
The status of any particular pair of attributes can therefore be accessed with a code fragment like the following:
If 2 And IMEStatus() Then Debug.Print "IME is enabled" Else Debug.Print "IME Is disabled" End If
Indicates the state or character set of the IME, which is used in the Far Eastern editions of Windows to handle keyboard messages and to translate them into a local character set.
In the case of non-Far Eastern versions of Windows, where IMEs aren't supported, a call to IMEStatus returns vbIMENoOP.