IIMCallback2::SendAlternatives2 (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

IIMCallback2
WM_SYSCOPYDATA