IIMCallback2::SendAlternatives2
A version of this page is also available for
4/8/2010
This method enables an input method (IM) to send information to an input method editor (IME).
Syntax
HRESULT SendAlternatives2(
LMDATA* plmd
);
Parameters
- plmd
A pointer to a LMDATA structure that contains information that is to be sent from the IM to the IME.
Return Value
An appropriate HRESULT value is returned.
Remarks
An alternatives list is a list of choices provided to the IME for integration into the candidate list. This candidate list then can be presented to the end-user to enable the end-user to make the best choice.
When the alternatives are sent to the software-based input panel, they are packaged up and the software-based input panel sends the structure in a WM_SYSCOPYDATA message to the active control with the wParam set to WMSCD_CHAR_RANKED_ALTS. If the active control does not handle the message, the message is forwarded to the IME for processing.
If an application or input method editor (IME) returns TRUE in response to a WM_SYSCOPYDATA message, this method resends the first candidate character.
Requirements
| Header | sip.h |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |