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.

Return value

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

If the operation fails, the return value is zero.

Requirements

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

See also

EM_GETIMEOPTIONS