EM_GETIMESTATUS message

Gets a set of status flags that indicate how the edit control interacts with the Input Method Editor (IME).

Parameters

wParam

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

Value Meaning
EMSIS_COMPOSITIONSTRING
Sets behavior for handling the composition string.

lParam

This parameter is not used.

Return value

Data specific to the type of status to retrieve. With the EMSIS_COMPOSITIONSTRING value for status, this return value is one or more of the following values.

Return code Description
EIMES_GETCOMPSTRATONCE
If this flag is set, the edit control hooks the WM_IME_COMPOSITION message with fFlags 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 processes 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.

Remarks

Rich Edit: The EM_GETIMESTATUS 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_SETIMESTATUS