AIT_IMEGetConversionStatus
Description
Acquires the current status of IME conversion.
Format
bool AIT_IMEGetConversionStatus (
integer nWndHandle, // Window handle
integer nConvMode, // Conversion mode
integer nSentenceMode // Statement mode
);
Parameters
nWndHandle (input)
Specify a window handle whose status you want to acquire.
With 0 set, the window with an input focus is used.
nConvMode (output)
Specify a variable to receive conversion status. When the function returns, the variable stores a combination of the following values.
Value | Description |
---|---|
IME_CMODE_CHARCODE | With this value on, the IME is in character code input mode. |
IME_CMODE_EUDC | With this value on, the IME is in EUDC conversion mode. |
IME_CMODE_FULLSHAPE | With this value on, the IME is in two-byte mode. With this value off, it is in one-byte mode. |
IME_CMODE_HANJACONVERT | With this value on, the IME is in HANJA conversion mode. |
IME_CMODE_KATAKANA | With this value on, katakana mode is set. With this value off, kana mode is set. |
IME_CMODE_NATIVE | With this value on, NATIVE mode is set. With this value off, ALPHANUMERIC mode is set. |
IME_CMODE_NOCONVERSION | With this value on, the IME does not carry out conversion. This is the same as if IME were closed. |
IME_CMODE_ROMAN | With this value on, the IME is in alphabetic input mode. |
IME_CMODE_SOFTKBD | With this value on, the IME is in soft keyboard mode. |
IME_CMODE_SYMBOL | With this value on, the IME is in SYMBOL conversion mode. |
nSentenceMode (output)
Specify a variable to receive character mode. When the function returns, the variable stores a combination of the following values.
Value | Description |
---|---|
IME_SMODE_AUTOMATIC | The IME is set in automatic conversion mode. |
IME_SMODE_NONE | No sentence information. |
IME_SMODE_PHRASEPREDICT | The IME uses phrase information to predict the next character. (Continuous clause) |
IME_SMODE_PLURALCLAUSE | The IME uses multiple-clause information for conversion processing. (Complex words are prioritized.) |
IME_SMODE_SINGLECONVERT | The IME is set in single conversion mode. |
IME_SMODE_CONVERSATION | The IME uses conversion mode. |
Return values
The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:
Extended error number | Error code |
---|---|
87 | ERROR_INVALID_PARAMETER |
1400 | ERROR_INVALID_WINDOW_HANDLE |