EM_GETIMEPROPERTY message

Retrieves the property and capabilities of the Input Method Editor (IME) associated with the current input locale.

Parameters

wParam

Specifies the type of property information to retrieve. This parameter can be one of the following values.

Value Meaning
IGP_PROPERTY
Property information.
IGP_CONVERSION
Conversion capabilities.
IGP_SENTENCE
Sentence mode capabilities.
IGP_UI
User interface capabilities.
IGP_SETCOMPSTR
Composition string capabilities.
IGP_SELECT
Selection inheritance capabilities.
IGP_GETIMEVERSION
Retrieves the system version number for which the specified IME was created.

lParam

Not used; must be zero.

Return value

Returns the property or capability value, depending on the value of the lParam parameter. For more information, see the Remarks.

Remarks

If wParam is IGP_PROPERTY, it returns one or more of the following values.

Requirement Value
IME_PROP_AT_CARET If set, conversion window is at the caret position. If clear, the window is near caret position.
IME_PROP_SPECIAL_UI If set, IME has a nonstandard user interface. The application should not draw in the IME window.
IME_PROP_CANDLIST_START_FROM_1 If set, strings in the candidate list are numbered starting at 1. If clear, strings start at zero.
IME_PROP_UNICODE If set, the IME is viewed as a UnicodeIME. The system and the IME will communicate through the UnicodeIME interface. If clear, IME will use the ANSI interface to communicate with the system.
IME_PROP_COMPLETE_ON_UNSELECT If set, conversion window is at the caret position. If clear, the window is near caret position.
IME_PROP_ACCEPT_WIDE_VKEY If set, the IME processes the injected Unicode that came from the SendInput function by using VK_PACKET. If clear, the IME might not process the injected Unicode, and the injected Unicode might be sent to the application directly.

If wParam is IGP_UI, it returns one or more of the following values.

Requirement Value
UI_CAP_2700 Supports text escapement values of 0 or 2700. For more information, see lfEscapement.
UI_CAP_ROT90 Supports text escapement values of 0, 900, 1800, or 2700. For more information, see lfEscapement.
UI_CAP_ROTANY Supports any text escapement value. For more information, see lfEscapement.

If wParam is IGP_SETCOMPSTR, it returns one or more of the following values.

Requirement Value
SCS_CAP_COMPSTR Can create the composition string by calling the ImmSetCompositionString function with the SCS_SETSTR value.
SCS_CAP_MAKEREAD Can create the reading string from corresponding composition string when using the ImmSetCompositionString function with SCS_SETSTR and without setting lpRead.
SCS_CAP_SETRECONVERTSTRING This IME can support reconversion. Use ImmSetCompositionString to do the reconversion.

If wParam is IGP_SELECT, it returns one or more of the following values.

Requirement Value
SELECT_CAP_CONVMODE Inherits conversion mode when a new IME is selected.
SELECT_CAP_SENTENCE Inherits sentence mode when a new IME is selected.

If wParam is IGP_GETIMEVERSION, it returns one or more of the following values.

Requirement Value
IMEVER_0310 The IME was created for Windows 3.1.
IMEVER_0400 The IME was created for Windows 95 or later

This message is similar to ImmGetProperty, except that it uses the current input locale. The application should call EM_ISIME before calling this function.

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_ISIME

Other Resources

ImmGetProperty