CRichEditCtx.IMEOptionsmethod
Gets/sets the current Input Method Editor (IME) options. This message is available only in Asian-language versions of the operating system.
Syntax
PRIVATE PROPERTY CRichEditCtx.IMEOptions () AS DWORD
Parameters
| Name | Description | |
|---|---|---|
fCoop | (SET) Specifies one of the following values. ECOOP_SET. Sets the options to those specified by fOptions. COOP_OR. Combines the specified options with the current options. ECOOP_AND. Retains only those current options that are also specified by fOptions. ECOOP_XOR. Logically exclusive OR the current options with those specified by fOptions. | |
fOptions | (SET) Specifies one of more of the following values. 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
(GET) Returns one or more of the IME option flag values described in the fOptions parameter of the SET property.
(SET) If the operation succeeds, the return value is a nonzero value. If the operation fails, the return value is zero. Call the (GET) ImeOptions property to check if the value has changed.
Description
Gets/sets the current Input Method Editor (IME) options. This message is available only in Asian-language versions of the operating system.
Example
(GET) PROPERTY IMEOptions () AS DWORD (SET) PROPERTY IMEOptions (BYVAL fCoop AS LONG, BYVAL fOptions AS LONG)
Reference
- Defined in AfxNova/CRichEditCtx.inc:1288
- Documented in Windows/WIndows Controls/RichEdit/CRichEditCtx Class.md
- Topic: CRichEditCtx Class