[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创建的。 |