Export (0) Print
Expand All

EM_SETIMESTATUS message

Sets the status flags that determine how an edit control interacts with the Input Method Editor (IME).

Parameters

wParam

The type of status to set. This parameter can be the following value.

ValueMeaning
EMSIS_COMPOSITIONSTRING

Sets behavior for the handling composition string.

 

lParam

Data specific to the status type. If wParam is EMSIS_COMPOSITIONSTRING, this parameter can be one or more of the following values.

ValueMeaning
EIMES_GETCOMPSTRATONCE

If this flag is set, the edit control hooks the WM_IME_COMPOSITION message with lParam set to GCS_RESULTSTR and returns the result string immediately. If this flag is not set, the edit control passes the WM_IME_COMPOSITION message to the default window procedure and handles the result string from the WM_CHAR message; this is the default behavior of the edit control.

EIMES_CANCELCOMPSTRINFOCUS

If this flag is set, the edit control cancels the composition string when it receives the WM_SETFOCUS message. If this flag is not set, the edit control does not cancel the composition string; this is the default behavior of the edit control.

EIMES_COMPLETECOMPSTRKILLFOCUS

If this flag is set, the edit control completes the composition string upon receiving the WM_KILLFOCUS message. If this flag is not set, the edit control does not complete the composition string; this is the default behavior of the edit control.

 

Return value

Returns the previous value of the lParam parameter.

Remarks

Rich Edit: The EM_SETIMESTATUS message is not supported.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

See also

EM_GETIMESTATUS

 

 

Community Additions

ADD
Show:
© 2014 Microsoft