[Now Supported on Windows NT]
The ImmGetProperty function gets the property and capabilities of the IME associated with the specified keyboard layout.
BOOL ImmGetProperty(
| HKL hKL, | |
| DWORD fdwIndex | |
| ); |
Parameters
hKL
Handle to the keyboard layout.
fdwIndex
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 Windows version number for which the specified IME was created. |
Return Values
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. |