Share via


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

Other Resources

Using the IImeIPoint2 Interface