Creating the Candidate List
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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