Expand Minimize

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 codeDescription
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 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Richedit.h

See also

Reference
EM_SETLANGOPTIONS
EM_SETLIMITTEXT

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.