[Now Supported on Windows NT]
ImmNotifyIME功能通知IME有关输入上下文状态的更改。
BOOL ImmNotifyIME(
| HIMC 【hIMC】, | |
| DWORD 【dwAction】, | |
| DWORD 【dwIndex】, | |
| DWORD 【dwValue】 | |
| ); |
参数
【hIMC】
处理输入上下文。
【dwAction】
通知代码。此参数可以是以下值之一：
| 值 | 含义 |
| NI_CHANGECANDIDATELIST | 申请更改了当前选定的候选人; 【dwIndex】是要选择的候选列表的索引，并且不使用【dwValue】. |
| NI_CLOSECANDIDATE | 应用程序指示IME关闭候选列表; 【dwIndex】是要关闭的列表的索引; 【dwValue】未使用。如果关闭列表，IME会向应用程序发送IMN_CLOSECANDIDATE消息。 |
| NI_COMPOSITIONSTR | 应用程序指示IME对组合字符串执行操作; 【dwValue】未被使用，【dwIndex】可以是CPS_CANCEL，CPS_COMPLETE，CPS_CONVERT或CPS_REVERT。 |
| NI_OPENCANDIDATE | 应用程序指示IME打开候选列表; 【dwIndex】是要打开的列表的索引; 【dwValue】未使用。如果打开列表，IME会向应用程序发送IMN_OPENCANDIDATE消息。 |
| NI_SELECTCANDIDATESTR | 应用程序选择候选人之一; 【dwIndex】是要选择的候选列表的索引，并且【dwValue】是所选候选列表中候选字符串的索引。 |
| NI_SETCANDIDATE_PAGESIZE | 【dwIndex】参数指定要更改的候选列表，并且其值的范围为0到31。 |
| NI_SETCANDIDATE_PAGESTART | 【dwIndex】参数指定要更改的候选列表，并且其值的范围为0到31。 |
【dwIndex】
候选人列表的索引，如果【dwAction】为NI_COMPOSITIONSTR，则为以下值之一：
| 值 | 含义 |
| CPS_CANCEL | 清除组合字符串，并将状态设置为无组合字符串。 |
| CPS_COMPLETE | 将组合字符串设置为结果字符串。 |
| CPS_CONVERT | 转换组合字符串。 |
| CPS_REVERT | 取消当前的组合字符串，并恢复为未转换的字符串。 |
【dwValue】
候选字符串的索引或未使用的索引，具体取决于【dwAction】参数的值。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。
