通过

ImmNotifyIME 函数 (imm.h)

  • 项目

通知输入法输入上下文的状态更改。

语法

BOOL ImmNotifyIME(
       HIMC  unnamedParam1,
  [in] DWORD dwAction,
  [in] DWORD dwIndex,
  [in] DWORD dwValue
);

parameters

unnamedParam1

[in] dwAction

通知代码： 此参数可以具有以下值之一。

值 含义
NI_CHANGECANDIDATELIST
 应用程序更改了当前所选候选项。 dwIndex 参数指定要选择的候选列表的索引，并且不使用 dwValue。
NI_CLOSECANDIDATE
 应用程序指示输入法关闭候选列表。 dwIndex 参数指定要关闭的列表的索引，不使用 dwValue。 如果应用程序关闭列表，则 IME 会向应用程序发送 IMN_CLOSECANDIDATE 命令。
NI_COMPOSITIONSTR
 应用程序指示 IME 对合成字符串执行操作。 dwIndex 参数可以是CPS_CANCEL、CPS_COMPLETE、CPS_CONVERT或CPS_REVERT。
NI_IMEMENUSELECTED
 应用程序指示 IME 以允许应用程序处理指定的菜单。 dwIndex 参数指定菜单的 ID，dwValue 是该菜单项的应用程序定义的值。
NI_OPENCANDIDATE
 应用程序指示 IME 打开候选列表。 dwIndex 参数指定要打开的列表的索引，不使用 dwValue。 如果应用程序打开列表，则 IME 会向应用程序发送 IMN_OPENCANDIDATE 命令。
NI_SELECTCANDIDATESTR
 应用程序选择了其中一个候选项。 dwIndex 参数指定要选择的候选列表的索引。 dwValue 参数指定所选候选列表中候选字符串的索引。
NI_SETCANDIDATE_PAGESIZE
 应用程序更改候选列表的页面大小。 dwIndex 参数指定要更改的候选列表，并且必须具有介于 0 到 3 之间的值。 dwValue 参数指定新的页面大小。
NI_SETCANDIDATE_PAGESTART
 应用程序更改候选列表的页面起始索引。 dwIndex 参数指定要更改的候选列表，并且必须具有介于 0 到 3 之间的值。 dwValue 参数指定新的页面开始索引。

[in] dwIndex

候选列表的索引。 或者，如果 dwAction 是NI_COMPOSITIONSTR，则此参数可以具有以下值之一。

值 含义
CPS_CANCEL
 清除组合字符串，并将状态设置为“无组合字符串”。
CPS_COMPLETE
 将组合字符串设置为结果字符串。
CPS_CONVERT
 转换组合字符串。
CPS_REVERT
 取消当前合成字符串，并将组合字符串设置为未转换的字符串。

[in] dwValue

候选字符串的索引。 应用程序可以设置或忽略此参数，具体取决于 dwAction 参数的值。

返回值

如果成功，则返回非零值，否则返回 0。

要求

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

另请参阅

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

输入法管理器

输入法管理器函数