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.

ValueDescription
IME_CMODE_CHARCODEWith this value on, the IME is in character code input mode.
IME_CMODE_EUDCWith this value on, the IME is in EUDC conversion mode.
IME_CMODE_FULLSHAPEWith this value on, the IME is in two-byte mode. With this value off, it is in one-byte mode.
IME_CMODE_HANJACONVERTWith this value on, the IME is in HANJA conversion mode.
IME_CMODE_KATAKANAWith this value on, katakana mode is set. With this value off, kana mode is set.
IME_CMODE_NATIVEWith this value on, NATIVE mode is set. With this value off, ALPHANUMERIC mode is set.
IME_CMODE_NOCONVERSIONWith this value on, the IME does not carry out conversion. This is the same as if IME were closed.
IME_CMODE_ROMANWith this value on, the IME is in alphabetic input mode.
IME_CMODE_SOFTKBDWith this value on, the IME is in soft keyboard mode.
IME_CMODE_SYMBOLWith 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.

ValueDescription
IME_SMODE_AUTOMATICThe IME is set in automatic conversion mode.
IME_SMODE_NONENo sentence information.
IME_SMODE_PHRASEPREDICTThe IME uses phrase information to predict the next character. (Continuous clause)
IME_SMODE_PLURALCLAUSEThe IME uses multiple-clause information for conversion processing. (Complex words are prioritized.)
IME_SMODE_SINGLECONVERTThe IME is set in single conversion mode.
IME_SMODE_CONVERSATIONThe 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 numberError code
87ERROR_INVALID_PARAMETER
1400ERROR_INVALID_WINDOW_HANDLE