[Now Supported on Windows NT]
ImmGetProperty函数获取与指定键盘布局相关联的IME的属性和功能。
BOOL ImmGetProperty(
| HKL 【hKL】, | |
| DWORD 【fdwIndex】 | |
| ); |
参数
【hKL】
处理键盘布局。
【fdwIndex】
要检索的属性信息的类型。此参数可以是以下值之一:
| 值 | 含义 |
| IGP_PROPERTY | 物业资料。 |
| IGP_CONVERSION | 转换功能。 |
| IGP_SENTENCE | 句子模式功能。 |
| IGP_UI | 用户界面功能 |
| IGP_SETCOMPSTR | 组合字符串功能。 |
| IGP_SELECT | 选择继承能力。 |
| IGP_GETIMEVERSION | 检索创建指定IME的Windows版本号。 |
返回值
根据【dwIndex】参数的值返回属性或能力值。如果【dwIndex】为IGP_PROPERTY,则返回以下值的组合:
| 值 | 含义 |
| IME_PROP_AT_CARET | 如果清除,窗口靠近插入位置。 |
| IME_PROP_SPECIAL_UI | 如果设置,IME具有非标准的用户界面。应用程序不应该在IME窗口中绘制。 |
| IME_PROP_CANDLIST_START_FROM_1 | 如果设置,候选列表中的字符串从1开始编号。如果清除,字符串从0开始。 |
| IME_PROP_UNICODE | 如果设置,输入上下文的字符串具有Unicode字符。如果清除,则字符串具有单字节和双字节字符。 |
如果【dwIndex】为IGP_UI,则返回值为以下值的组合:
| 值 | 含义 |
| UI_CAP_2700 | 支持文本擒纵值为0或2700。 |
| UI_CAP_ROT90 | 支持文本擒纵值为0,900,1800或2700。 |
| UI_CAP_ROTANY | 支持任何文本擒纵值。 |
如果【dwIndex】为IGP_SETCOMPSTR,则返回值为以下值的组合:
| 值 | 含义 |
| SCS_CAP_COMPSTR | 可以使用ImmSetCompositionString函数的SCS_SETSTR值创建组合字符串。 |
| SCS_CAP_MAKEREAD | 在使用ImmSetCompositionString函数的SCS_SETSTR值时,可以从相应的组合字符串创建读取字符串。 |
如果【dwIndex】为IGP_SELECT,则返回值为以下值的组合:
| 值 | 含义 |
| SELECT_CAP_CONVMODE | 当选择新的IME时,继承转换模式。 |
| SELECT_CAP_SENTENCE | 当选择新的IME时继续句子模式。 |
如果【dwIndex】为IGP_GETIMEVERSION,则返回值为以下值之一:
| 值 | 含义 |
| IMEVER_0310 | IME是为Windows 3.1创建的 |
| IMEVER_0400 | IME是为Windows 95创建的。 |