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.

Value Meaning
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.

Value Meaning
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

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Winuser.h (include Windows.h)

See also

EM_GETIMESTATUS