Edit

Share via

EM_SETIMEOPTIONS message

  • Article

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