Turns the IME (Input Method Editor) window on or off or returns the current IME status.
Syntax
IMESTATUS([nExpression])
Returns
Numeric
Arguments
nExpression
Turns the IME window on or off. The following table lists the values for nExpression and the corresponding state of the IME window.
| nExpression | IME window action |
| 0 | Turns the IME window off. |
| 1 | Turns the IME window on. |
If nExpression is omitted, IMESTATUS( ) returns the current IME status. The following table lists the values returned for the IME status. Use VERSION(3) to determine the current locale.
The following table lists the values returned for the IME status in the Japanese locale.
| Return value | IME status |
| 0 | No IME installed |
| 1 | IME on |
| 2 | IME off |
| 3 | IME disabled |
| 4 | Hiragana mode (double-byte) |
| 5 | Katakana mode (double-byte) |
| 6 | Katakana mode (single-byte) |
| 7 | Alphanumeric mode (double-byte) |
| 8 | Alphanumeric mode (single-byte) |
The following table lists the values returned for the IME status in the Korean locale.
| Return value | IME status |
| 0 | No IME installed |
| 1 | Hangul mode (single-btye) |
| 2 | English mode (single-btye) |
| 11 | English mode (double-btye) |
| 15 | Hangul mode (double-btye) |
| 23 | Hanja conversion mode (Hangul + single-btye mode) |
| 31 | Hanja conversion mode (Hangul + double-btye mode) |
Remarks
For more information, see "Entering International Characters" in Chapter 18, Developing International Applications, in the Programmer's Guide.
This function is useful for manipulating double-byte character sets for languages such as Hiragana and Katakana.