IME Messages

IME Messages

IME Messages are the messages which IME gets/sends, related to the user event or application control.

WM_IMENOTIFY

This message is sent to the application for the notification of the IME related events. IME needs to call ImRequestEvent with the parameter WM_IMENOTIFY/IMN_STARTCONVERSION when IME is about to display its conversion window, and WM_IMENOTIFY/IMN_ENDCONVERSION just after closing conversion window and sending result part string to the application. During the conversion, if no space is available to show the conversion window, IME needs to send WM_IMENOTIFY/IMN_CONVERSIONFULL message from IME's conversion part window procedure using WinSendMsg call.

WM_IMEREQUEST

This message is sent to the IME Window for the notification of the events. Typically as the result of ImRequestEvent call. Refer to IM Interface section for more detail.

WM_QUERYIMEWINDOWCAPS

This message is sent to the IME Window by the system to query the capability of Part windows.

Parameters:

mparam 1 ulIndex(input) :

   Index to query window capability as follows.
   IME Window should fill the value corresponding
   to this index in the area pointed by mparam 2.

   IWC_CONVERSIONANGLE 

      mparam 2 contains one of the following value
      which represents the conversion window angle capability.

           UIC_270
           UIC_ANGLE90
           UIC_ANGLEANY

   IWC_CONVERSIONMARGIN 

      mparam2 contains the margin value in pels between the
      border of the conversion window and actual text box of
      the conversion text.

   IWC_FORCEPOSITION 

      mparam2 contains the bool value that indicates that
      the conversion window supports the CPS_FORCE bit in
      CONVERSIONPOS structure.

mparam 2 pulValue(output) :

   pointer to the ULONG value corresponding to ulIndex in mparam 1.

Returns:

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