Export (0) Print
Expand All

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.

ValueMeaning
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 codeDescription
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

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_SETIMESTATUS

 

 

Community Additions

ADD
Show:
© 2014 Microsoft