EM_GETIMEPROPERTY Message

An application sends a EM_GETIMEPROPERTY message to get the the property and capabilities of the Input Method Editor (IME) associated with the current input locale.

Syntax

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


lResult = SendMessage(
    // returns DWORD in lResult
   (HWND) hWndControl,
    // handle to destination control
   (UINT) EM_GETIMEPROPERTY,
    // message ID
   (WPARAM) wParam,
    // = (WPARAM) (DWORD) wParam;
   (LPARAM) lParam
    // = 0; not used, must be zero

);

Parameters

wParam
Specifies the type of property information to retrieve. This parameter can be one of the following values.
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.
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 Windows 98/Me, Windows 2000/XP: If set, conversion window is at the caret position. If clear, the window is near caret position.
IME_PROP_ACCEPT_WIDE_VKEY Windows 2000/XP: 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.
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.
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.
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.
IMEVER_0310 The IME was created for Microsoft 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.

Message Information

Minimum DLL Version msftedit.dll
Header Declared in Richedit.h
Minimum operating systems Windows XP SP1