WM_IMEREQUEST

IMEREQUEST

This message is sent to the application window for the notification of the events.

Parameters :

mparam1 : ulRequestType(ULONG) which is one of the following value. Each value is exclusive.

IMR_INSTANCEACTIVATE :

This request is sent when the application gets focus. High word of mparam2 contains the bool value of activation(TRUE : activated, FALSE : inactivated). Low word of mparam2 contains the information that which wind It is the combination of the following bits.

IMR_IA_STATUS
IMR_IA_CONVERSION
IMR_IA_CANDIDATE
IMR_IA_INFOMSG
IMR_IA_REGWORD

IMR_STATUS :

This request is sent when the status part is changed. mparam2 contains the information that which field of the status part is changed. It is the combination of the following bits.

IMR_STATUS_SHOW
IMR_STATUS_HIDE
IMR_STATUS_INPUTMODE
IMR_STATUS_CONVERSIONMODE
IMR_STATUS_STATUSPOS
IMR_STATUS_STATUSSTRING
IMR_STATUS_STRINGATTR
IMR_STATUS_CURSORPOS
IMR_STATUS_CURSORATTR

IMR_CONVRESULT :

This request is sent when the conversion part, result part, or both are changed as a result of the keyinput or calling API. mparam2 contains the information that which field of the conversion or result part is changed. It is the c ion of the following bits.

IMR_CONV_CONVERSIONSTRING
IMR_CONV_CONVERSIONATTR
IMR_CONV_CONVERSIONCLAUSE
IMR_CONV_READINGSTRING
IMR_CONV_READINGATTR
IMR_CONV_READINGCLAUSE
IMR_CONV_CURSORPOS
IMR_CONV_CURSORATTR
IMR_CONV_CHANGESTART
IMR_CONV_INSERTCHAR
IMR_CONV_NOMOVECARET
IMR_CONV_CONVERSIONFONT
IMR_CONV_CONVERSIONPOS
IMR_RESULT_RESULTSTRING
IMR_RESULT_RESULTATTR
IMR_RESULT_RESULTCLAUSE
IMR_RESULT_READINGSTRING
IMR_RESULT_READINGATTR
IMR_RESULT_READINGCLAUSE

IMR_CANDIDATE :

This request is sent when the candidate part is changed. mparam2 contains the information that which field of the candidate part is changed. It is the combination of the following bits.

IMR_CANDIDATE_SHOW
IMR_CANDIDATE_HIDE
IMR_CANDIDATE_CHANGE
IMR_CANDIDATE_CANDIDATEPOS
IMR_CANDIDATE_SELECT

Note: IMR_CANDIDATE_SELECT is sent when just a selection in a candidate list is changed. When all contents of the candidate list is changed, IMR_CANDIDATE_CHANGE is sent.

IMR_INFOMSG :

This request is sent when the information message part is changed.

IMR_INFOMSG_ERRLEVEL
IMR_INFOMSG_ERRINDEX
IMR_INFOMSG_ERRTITLE
IMR_INFOMSG_ERRSTR
IMR_INFOMSG_PRIVATE

IMR_REGWORD :

This request is sent when the register word part is changed.

IMR_REGWORD_SHOW
IMR_REGWORD_HIDE

IMR_IMECHANGE :

This request is sent when the currentIME is changed. mparam2 contains an ImeId of a new IME.

IMR_CONFIG :

This request is sent when the configuration panel of the IME is shown or hidden.

IMR_CONFIG_SHOW
IMR_CONFIG_HIDE

IMR_DICTIONARY :

This request is sent when the dictionary setting panel is shown or hidden.

IMR_DICTIONARY_SHOW
IMR_DICTIONARY_HIDE

IMR_OTHERINFO :

This request is sent when information which doesn't belong to any part is changed.

IMR_OTHERINFO_HWND

mparam2 : depends on ulRequestType.

Returns :

Success indicator(BOOL) : TRUE : success. FALSE : failure

Remarks : In Windows95, WM_IME_COMPOSITION contains 'chDBCS' which is the latest change to the composition string. But it is always zero when IME is MSIME. So we omitted this parameter on IMR_COMVERSION and IMR_RESULT request.