EM_GETIMESTATUS

[This is preliminary documentation and subject to change.]

An application sends the EM_GETIMESTATUS message to retrieve status for the edit control's behavior with the IME.

EM_GETIMESTATUS
wParam = (WPARAM) status; // status value to get
lParam = 0;               // must be zero

Parameters

status
Indicates the type of status to retrieve. This parameter can be the following value.
Value Meaning
EMSIS_COMPOSITIONSTRING Sets behavior for handling the composition string.

Return Values

Data specific to the type of status to retrieve. With the EMSIS_COMPOSITIONSTRING value for status, this return value is a combination of the following values.

Value Meaning
EIMES_GETCOMPSTRATONCE If this flag is set, the edit control hooks the WM_IME_COMPOSITION message 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.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.

See Also

Edit Controls Overview, Edit Control Messages, EM_SETIMESTATUS