Upravit

Sdílet prostřednictvím


EM_GETLANGOPTIONS message

Gets a rich edit control's option settings for Input Method Editor (IME) and Asian language support.

Parameters

wParam

Not used; must be zero.

lParam

Not used; must be zero.

Return value

Returns the IME and Asian language settings, which can be zero or more of the following values.

Return code Description
IMF_AUTOFONT
If this flag is set, the control automatically changes fonts when the user explicitly changes to a different keyboard layout. It is useful to turn off IMF_AUTOFONT for universal Unicode fonts. This option is turned on by default (1).
IMF_AUTOFONTSIZEADJUST
If this flag is set, the control scales font-bound font sizes from insertion point size according to script. For example, Asian fonts are slightly larger than Western ones. This option is turned on by default (1).
IMF_AUTOKEYBOARD
If this flag is set, the control automatically changes the keyboard layout when the user explicitly changes to a different font, or when the user explicitly changes the insertion point to a new location in the text. Will be turned on automatically for bidirectional controls. For all other controls, it is turned off by default. This option is turned off by default (0).
IMF_DISABLEAUTOBIDIAUTOKEYBOARD
Windows 8: If this flag is set, the control uses language neutral logic for automatic keyboard switching. This option is turned off by default (0).
IMF_DUALFONT
If this flag is set, the control uses dual-font mode. Used for Asian language support. The control uses an English font for ASCII text and a Asian font for Asian text. This option is turned on by default (1).
IMF_IMEALWAYSSENDNOTIFY
This flag controls how the rich edit control notifies the client during IME composition:
0: No EN_CHANGE or EN_SELCHANGE notifications during undetermined state. Send notification when the final string comes in. This is the default.
1: Send EN_CHANGE 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. This option is turned off by default (0).
IMF_NOIMPLICITLANG
Windows 8: If this flag is set, disable stamping keyboard input with the keyboard language and ensuring that non-East Asian language IDss are compatible with the character repertoire. This option is turned off by default (0).
IMF_NOKBDLIDFIXUP
Windows 8: If this flag is set, the rich edit control disables stamping keyboard language on an empty control. This option is turned off by default (0).
IMF_SPELLCHECKING
Windows 8: If this flag is set, the rich edit control turns on spell checking. This option is turned off by default (0).
IMF_TKBAUTOCORRECTION
Windows 8: If this flag is set, enable touch keyboard autocorrect. This option is turned off by default (0).
IMF_TKBPREDICTION
Windows 10: Ignored.
Windows 8: If this flag is set, the rich edit control enables touch keyboard prediction. This option is turned off by default (0).
IMF_UIFONTS
Use user-interface default fonts. This option is turned off by default (0).

Remarks

The IMF_AUTOFONT flag is set by default. The IMF_AUTOKEYBOARD and IMF_IMECANCELCOMPLETE flags are cleared by default.

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

Reference

EM_SETLANGOPTIONS

EM_SETLIMITTEXT