AIT_IMEGetProperty
Description
Acquires IME properties or functionalities associated with an input focus window.
Format
integer AIT_IMEGetProperty (
integer nPropertyInfo // Property information
);
Parameters
nPropertyInfo (input)
Specify property information you want to acquire. You have to set one of the following values.
Value | Description |
---|---|
IGP_PROPERTY | Property information |
IGP_CONVERSION | Conversion functionality |
IGP_SENTENCE | Sentence mode functionality |
IGP_UI | User interface functionality |
IGP_SETCOMPSTR | Composition character string functionality |
IGP_SELECT | Selection inheritance functionality |
Return values
The value returned if the function was executed normally is the property or functionality value corresponding to the nPropertyInfo value. In the other cases, the return value is -1.
The value returned if nPropertyInfo is IGP_PROPERTY is a combination of the following values.
Value | Description |
---|---|
IME_PROP_AT_CARET | With this value on, the conversion window is at the caret position. If not, it is near the caret. |
IME_PROP_SPECIAL_UI | With this value on, the IME has no standard user interface. In this case, do not use the application to draw in the IME window. |
IME_PROP_CANDLIST_START_FROM_1 | With this value on, the character strings in a candidate list are numbered in sequence beginning with 1. If not, they are numbered in sequence beginning with 0. |
IME_PROP_UNICODE | With this value on, the input context character string contains Unicode characters. If not, it contains one- and two-byte characters. |
If nPropertyInfo is IGP_UI, the return value is a combination of the following values.
Value | Description |
---|---|
UI_CAP_2700 | Supports a value of 0 or 2700 as the text printing direction. |
UI_CAP_ROT90 | Supports values of 0, 900, 1800, and 2700 as the text printing direction. |
UI_CAP_ROTANY | Supports any printing direction. |
If nPropertyInfo is IGP_SETCOMPSTR, the return value is a combination of the values below.
Value | Description |
---|---|
SCS_CAP_COMPSTR | You can use the SCS_SETSTR value of IMESetCompositionString to create a composition character string. |
SCS_CAP_MAKEREAD | You can use the SCS_SETSTR value of IMESetCompositionString to create a read character string from the appropriate composition character string. |
If nPropertyInfo is IGP_SELECT, the return value is a combination of the values below.
Value | Description |
---|---|
SELECT_CAP_CONVERSION | Inherits conversion mode if a new IME has been selected. |
SELECT_CAP_SENTENCE | Inherits sentence mode if a new IME has been selected. |
If the function has returned -1, you can use AIT_GetLastError to acquire an extended error code.
The following gives the error code that AIT_GetLastError might return:
Extended error number | Error code |
---|---|
87 | ERROR_INVALID_PARAMETER |