EM_SETIMEOPTIONS message

Sets the Input Method Editor (IME) options.

Note

This message is supported only in Asian-language versions of Microsoft Rich Edit 1.0. It is not supported in any later versions.

Parameters

wParam

Specifies one of the following values.

Value	Meaning
ECOOP_SET	Sets the options to those specified by lParam.
ECOOP_OR	Combines the specified options with the current options.
ECOOP_AND	Retains only those current options that are also specified by lParam.
ECOOP_XOR	Logically exclusive OR the current options with those specified by lParam.

lParam

Specifies one of more of the following values.

Value	Meaning
IMF_CLOSESTATUSWINDOW	Closes the IME status window when the control receives the input focus.
IMF_FORCEACTIVE	Activates the IME when the control receives the input focus.
IMF_FORCEDISABLE	Disables the IME when the control receives the input focus.
IMF_FORCEENABLE	Enables the IME when the control receives the input focus.
IMF_FORCEINACTIVE	Inactivates the IME when the control receives the input focus.
IMF_FORCENONE	Disables IME handling.
IMF_FORCEREMEMBER	Restores the previous IME status when the control receives the input focus.
IMF_MULTIPLEEDIT	Specifies that the composition string will not be canceled or determined by focus changes. This allows an application to have separate composition strings on each rich edit control.
IMF_VERTICAL	Note used in Rich Edit 2.0 and later.

If the operation succeeds, the return value is a nonzero value.

If the operation fails, the return value is zero.

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Richedit.h