EM_SETLANGOPTIONS Message

An application sends an EM_SETLANGOPTIONS message to set options for Input Method Editor (IME) and Asian language support in a rich edit control.

Syntax

To send this message, call the SendMessage function as follows.


lResult = SendMessage(
    // returns LRESULT in lResult
   (HWND) hWndControl,
    // handle to destination control
   (UINT) EM_SETLANGOPTIONS,
    // message ID
   (WPARAM) wParam,
    // = (WPARAM) () wParam;
   (LPARAM) lParam
    // = (LPARAM) () lParam;

);

Parameters

wParam
This parameter is not used; it must be zero.
lParam

0: No EN_CHANGED or EN_SELCHANGE notifications during undetermined state. Send notification when final string comes in. (default)
1: Send EN_CHANGED and EN_SELCHANGE events during undetermined state.
IMF_IMECANCELCOMPLETE
This flag determines how the control uses the composition string of an IME if the user cancels it. If this flag is set, the control discards the composition string. If this flag is not set, the control uses the composition string as the result string.
IMF_UIFONTS
Use user-interface default fonts. This option is turned off by default.

Return Value

This message returns a value of 1.

Remarks

The EM_SETLANGOPTIONS message controls the following:
Automatic font binding.
Automatic keyboard switching.
Automatic font size adjustment.
Use of user-interface default fonts instead of document default fonts.
Notifications to client during IME composition.
How IME aborts composition mode.
The IMF_AUTOFONT flag is set by default. The IMF_AUTOKEYBOARD and IMF_IMECANCELCOMPLETE flags are clear by default.

Message Information

Header Declared in Richedit.h
Minimum operating systems Windows 95 with Rich Edit 2.0 , Windows 98, Windows NT 4.0