The ImmGetProperty function gets the property and capabilities of the IME associated with the specified keyboard layout.
BOOL ImmGetProperty(
|
HKL hKL, | |
|
DWORD fdwIndex | |
|
); |
|
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 Windows version number for which the specified IME was created. |
Returns the property or capability value, depending on the value of the dwIndex parameter. If dwIndex is IGP_PROPERTY, returns a combination of the following values:
|
Value |
Meaning |
|
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 0. |
|
IME_PROP_UNICODE |
If set, strings for the input context have Unicode characters. If clear, strings have single and double-byte characters. |
If dwIndex is IGP_UI, the return value is a combination of the following values:
|
Value |
Meaning |
|
UI_CAP_2700 |
Supports text escapement values of 0 or 2700. |
|
UI_CAP_ROT90 |
Supports text escapement values of 0, 900, 1800, or 2700. |
|
UI_CAP_ROTANY |
Supports any text escapement value. |
If dwIndex is IGP_SETCOMPSTR, the return value is a combination of the following values:
|
Value |
Meaning |
|
SCS_CAP_COMPSTR |
Can create the composition string by using the SCS_SETSTR value of the ImmSetCompositionString function. |
|
SCS_CAP_MAKEREAD |
Can create the reading string from corresponding composition string when using the SCS_SETSTR value of the ImmSetCompositionString function. |
If dwIndex is IGP_SELECT, the return value is a combination of the following values:
|
Value |
Meaning |
|
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 dwIndex is IGP_GETIMEVERSION, the return value is one of the following values:
|
Value |
Meaning |
|
IMEVER_0310 |
The IME was created for Windows 3.1 |
|
IMEVER_0400 |
The IME was created for Windows 95. |