Share via

IMESTATUS( ) Function

  • Article

Turns the IME (Input Method Editor) window on or off or returns the current IME status.

IMESTATUS([nExpression])

Return Values

Numeric

Parameters

  • 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 Developing International Applications.

This function is useful for manipulating double-byte character sets for languages such as Hiragana and Katakana.

See Also

Entering International Data | SET BROWSEIME | IMEMode Property | ISLEADBYTE( ) Function | STRCONV( ) Function