ImmGetProperty 函数 (immdev.h)

检索与指定输入区域设置关联的 IME 的属性和功能。

语法

DWORD ImmGetProperty(
       HKL   unnamedParam1,
       DWORD unnamedParam2
);

unnamedParam1

unnamedParam2

返回属性或功能值，具体取决于 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	如果设置，则 IME 被视为 Unicode IME。操作系统和 IME 通过 Unicode IME 接口进行通信。如果清除，则 IME 使用 ANSI 接口与操作系统通信。
IME_PROP_COMPLETE_ON_UNSELECT	如果设置了，则 IME 将在停用 IME 时完成合成字符串。如果清除，则 IME 在停用 IME（例如，从键盘布局更改）时取消合成字符串。
IME_PROP_ACCEPT_WIDE_VKEY	如果已设置，则输入法使用 VK_PACKET 处理来自 SendInput 函数的注入 Unicode。如果清除，IME 可能不会处理注入的 Unicode，并且可能会将注入的 Unicode 直接发送到应用程序。

如果 dwIndex 设置为 IGP_UI，则函数将返回以下一个或多个值：

值	含义
UI_CAP_2700	支持文本转义值 0 或 2700。有关详细信息，请参阅 LOGFONT 结构的 lfEscapement 成员。
UI_CAP_ROT90	支持文本转义值 0、900、1800 或 2700。有关详细信息，请参阅 lfEscapement。
UI_CAP_ROTANY	支持任何文本转义值。有关详细信息，请参阅 lfEscapement。

如果 dwIndex 设置为 IGP_SETCOMPSTR，则函数将返回以下一个或多个值：

值	含义
SCS_CAP_COMPSTR	通过使用 SCS_SETSTR 值调用 ImmSetCompositionString 函数来创建组合字符串。
SCS_CAP_MAKEREAD	使用具有 SCS_SETSTR 且不设置 lpRead 的 ImmSetCompositionString 函数时，从相应的合成字符串创建读取字符串。
SCS_CAP_SETRECONVERTSTRING：	此 IME 可以支持重新转换。使用 ImmSetCompositionString 执行重新转换。

如果 dwIndex 设置为 IGP_SELECT，则函数将返回以下一个或多个值：

值	含义
SELECT_CAP_CONVMODE	选择新的 IME 时继承转换模式。
SELECT_CAP_SENTENCE	选择新的 IME 时继承句子模式。

如果 dwIndex 设置为 IGP_GETIMEVERSION，则函数将返回以下一个或多个值：

值	含义
IMEVER_0310	已为 Windows 3.1 创建 IME。
IMEVER_0400	IME 是为 Windows Me/98/95 创建的。