Creating the Candidate List (Windows CE 5.0)
After converting a composition string, you can create a candidate list for the target clause. To generate the candidate list, the IME UI calls the IImeIPoint2::ControlIME method with the IPCTRL_MAKECANDIDATE function identifier. If you want to obtain a candidate list for another clause, you first need to change the target clause by calling the IImeIPoint2::ControlIME method with an IPCTRL_CARETLEFT or IPCTRL_CARETRIGHT function identifier.
To receive the candidate list items, the IME UI calls the IImeIPoint2::UpdateContext method. The conversion service sends back the candidate items through a call to the IImeIPointNotifySink::SetCandidateStr method.
The following code sample shows how to generate a candidate list:
// Generate a candidate list
pIP->ControlIME(IPCTRL_MAKECANDIDATE, IPCTRLPARAM_DEFAULT);
pIP->UpdateContext(TRUE);
To change the selection of the candidate, the IME UI calls the IImeIPoint2::ControlIME method with the IPCTRL_SELECTCANDIDATE function identifier.
See Also
Using the IImeIPoint2 Interface | Accessing the Conversion Service | Creating a Notification Sink | Processing User Input from the Keyboard | Editing the Composition String | Processing User Input with Alternatives | Converting a Composition String | Determining the Composition String
Send Feedback on this topic to the authors