IIMCallback2::SendAlternatives2

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

At a Glance

Header file: Sip.h
Windows CE Versions: 2.12 and later

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 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 input panel, they are packaged up and the input panel sends the structure in a WM_SYSCOPY 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.