ImmNotifyIME (Windows CE 5.0)
This function notifies the IME about changes to the status of the input context.
BOOL ImmNotifyIME(HIMChIMC,DWORDdwAction,DWORDdwIndex,DWORD dwValue);
Parameters
- hIMC
[in] Handle to the input context. - dwAction
[in] Value that specifies the notification code. The following table shows the values for this parameter.Value Description NI_CHANGECANDIDATELIST An application changed the current selected candidate; dwIndex is an index of a candidate list to be selected and dwValue is not used. NI_CLOSECANDIDATE An application directs the IME to close a candidate list; dwIndex is the index of the list to close; dwValue is not used. The IME sends a IMN_CLOSECANDIDATE message to the application if it closes the list. NI_COMPOSITIONSTR An application directs the IME to carry out an action on the composition string; dwValue is not used and dwIndex can be CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT, or CPS_REVERT. NI_IMEMENUSELECTED An application directs the IME to allow the application to handle the specified menu; dwIndex is the ID of the menu and dwValue is an application-defined value for that menu item. NI_OPENCANDIDATE An application directs the IME to open a candidate list; dwIndex is the index of the list to open; dwValue is not used. The IME sends a IMN_OPENCANDIDATE message to the application if it opens the list. NI_SELECTCANDIDATESTR An application selected one of candidates; dwIndex is an index of a candidate list to be selected and dwValue is an index of a candidate string in the selected candidate list. NI_SETCANDIDATE_PAGESIZE The dwIndex parameter specifies the candidate list to be changed and must have a value in the range zero to 31. NI_SETCANDIDATE_PAGESTART The dwIndex parameter specifies the candidate list to be changed and must have a value in the range zero to 31. - dwIndex
[in] Value that specifies the index of a candidate list or, if dwAction is NI_COMPOSITIONSTR, one of the following values. The following table shows the values this parameter can take.Value Description CPS_CANCEL Clear the composition string and set the status to no composition string. CPS_COMPLETE Set the composition string as the result string. CPS_CONVERT Convert the composition string. CPS_REVERT Cancel the current composition string and revert to the unconverted string. - dwValue
[in] Index of a candidate string or not used, depending on the value of the dwAction parameter.
Return Values
Nonzero indicates success. Zero indicates failure.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Imm.h.
Link Library: Coreimm.lib.
See Also
IMN_CLOSECANDIDATE | IMN_OPENCANDIDATE
Send Feedback on this topic to the authors