Creating the Candidate List (Windows Embedded CE 6.0)
1/6/2010
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
Concepts
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