EM_SETIMESTATUS

[This is preliminary documentation and subject to change.]

An application sends the EM_SETIMESTATUS message to change the edit control's behavior with the IME.

EM_SETIMESTATUS
wParam = (WPARAM) status;
lParam = (LPARAM) data;

Parameters

status

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

Value	Meaning
EMSIS_COMPOSITIONSTRING	Sets behavior for the handling composition string.

data

Data specific to the type of status to set. With the EMSIS_COMPOSITIONSTRING value for status, this parameter can be 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 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 Values

Returns the previous value of the data parameter.

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_GETIMESTATUS