Export (0) Print
Expand All
Expand Minimize
0 out of 1 rated this helpful - Rate this topic

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.

ValueMeaning
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_CARETIf set, conversion window is at the caret position. If clear, the window is near caret position.
IME_PROP_SPECIAL_UIIf set, IME has a nonstandard user interface. The application should not draw in the IME window.
IME_PROP_CANDLIST_START_FROM_1If set, strings in the candidate list are numbered starting at 1. If clear, strings start at zero.
IME_PROP_UNICODEIf 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_UNSELECTWindows 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_VKEYWindows 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_2700Supports text escapement values of 0 or 2700. For more information, see lfEscapement.
UI_CAP_ROT90Supports text escapement values of 0, 900, 1800, or 2700. For more information, see lfEscapement.
UI_CAP_ROTANYSupports 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_COMPSTRCan create the composition string by calling the ImmSetCompositionString function with the SCS_SETSTR value.
SCS_CAP_MAKEREADCan create the reading string from corresponding composition string when using the ImmSetCompositionString function with SCS_SETSTR and without setting lpRead.
SCS_CAP_SETRECONVERTSTRINGThis 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_CONVMODEInherits conversion mode when a new IME is selected.
SELECT_CAP_SENTENCEInherits sentence mode when a new IME is selected.

 

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

IMEVER_0310The IME was created for Windows 3.1.
IMEVER_0400The 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

Minimum supported client

Windows XP with SP1 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Richedit.h

See also

Reference
EM_ISIME
Other Resources
ImmGetProperty

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.