IIMCallback2::SendAlternatives2 (Windows CE 5.0)

Send Feedback

This method enables an input method (IM) to send information to an input method editor (IME).

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 Values

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

OS Versions: Windows CE 2.12 and later.
Header: Sip.h.
Link Library: Uuid.lib.

See Also

WM_SYSCOPYDATA | LMDATA

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.