Processing User Input with Alternatives

  • Article

Some input methods, such as handwriting recognition, generate alternatives for each character that is entered by the user. To process a character with its alternatives, the IME UI first fills out an IPCANDIDATE structure with the character and alternatives and then calls the IImeIPoint2::InsertImeItem method.

To display the updated composition string, the IME UI calls the IImeIPoint2::UpdateContext method to request the conversion service to send back the composition buffer contents through the IImeIPointNotifySink callback function.

The IME UI can retrieve the alternatives of a character through a call to the IImeIPointNotifySink::SetCandidateStr method. To retrieve alternatives of a specific character, the IME UI must move the insertion point to the character and then call the IImeIPoint2::UpdateContext method. If the character string has already been converted, the conversion service will send the candidates of the target clause instead of the alternatives of the character. You can obtain the alternatives of the character when the string is not converted; for example, the attribute of the character is ATTR_INPUT or ATTR_TARGET_NOTCONVERTED.

See Also

Using the IImeIPoint2 Interface | Accessing the Conversion Service | Creating a Notification Sink | Processing User Input from the Keyboard | Editing the Composition String | Converting a Composition String | Creating the Candidate List | Determining the Composition String

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.