imm.h) (ImmGetProperty 函数

检索与指定输入区域设置关联的 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 接口进行通信。 如果清除,则输入法使用 ANSI 接口与操作系统通信。
IME_PROP_COMPLETE_ON_UNSELECT 如果设置,则 IME 在停用 IME 时完成合成字符串。 如果清除,则输入法在停用 IME 时取消合成字符串,例如,通过键盘布局更改。
IME_PROP_ACCEPT_WIDE_VKEY 如果设置,IME 将使用 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 且不设置 lpReadImmSetCompositionString 函数时,从相应的组合字符串创建读取字符串。
SCS_CAP_SETRECONVERTSTRING: 此输入法可以支持重新转换。 使用 ImmSetCompositionString 执行重新转换。
 

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

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

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

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

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用],已安装东亚语言支持。
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imm.h (包括 Immdev.h、Windows.h)
Library Imm32.lib
DLL Imm32.dll

另请参阅

ImmSetCompositionString

输入法管理器

输入法管理器函数