浅谈输入法编程

核心提示：lpIMEInfo->fdwProperty告诉Windows系统您编写的输入法的一些特征，注意一下IME_PROP_END_UNLOAD这个标志，浅谈输入法编程(2)，有了它您编写的输入法会随着启动您的输入法的应用程序（如NotePad)的退出而退出，否则它将长驻于系统中，在使用时可以参见示例工程，BOOL W

lpIMEInfo->fdwProperty告诉Windows系统您编写的输入法的一些特征，注意一下IME_PROP_END_UNLOAD这个标志，有了它您编写的输入法会随着启动您的输入法的应用程序（如NotePad)的退出而退出，否则它将长驻于系统中，这也是为什么很多输入法在升级安装时需要首先重新启动电脑的原因。

在这个接口中还有一点需要特别注意，那就是lpIMEInfo->dwPrivateDataSize，至少我是经过很多次测试才基本证实Windows根据该值为INPUTCONTEXT.hPrivate分配空间。此外如果您修改了这个接口，按照我个人的经验是需要重新调用ImmInstallIME来安装。

在安装完成后，在输入法列表中应该已经有了您自己的输入法。点击调试，由于它是一个DLL，您需要先选择一个宿主程序，一般选择“记事本”，以调试方式启动“记事本”后，在这个“记事本”中打开您的输入法，您就可以在源代码中设置断点了。需要说明的是，VC6.0调试DLL不太好用，首先需要打上SP5或者SP6,这样也不能够在DLL启动的时候就设置断点，推荐使用.net来调试。

输入法上下文（HIMC）：HIMC是什么？在输入法编程时必然要接触到输入法上下文这个术语，刚接触时听起来实在是半懂不懂。由于输入法是一个插件，它需要和调用它的应用程序通讯，在输入法中生成的编码及重码信息保存在哪里应用程序才能正确的读取呢？答案就在于输入法上下文。输入法上下文是由User.exe(一个系统进程)为应用程序分配的内存句柄，在应用程序中启动的输入法在这块内存中写入数据，User.exe再将数据传递到应用程序。

UIWnd：在IME中需要导出一个接口，原型如LRESULT WINAPI UIWndProc(HWND hUIWnd, UINT message,WPARAM wParam, LPARAM lParam)，hUIWnd是由User.exe传过来的窗口句柄，它是输入法中创建的窗口如编码窗口，重码窗口，状态栏窗口的宿主（Owner)，初学输入法编程的人可能会问这个窗口显示在哪里呢？其实它并不是一个普通的窗口，它只是一个用来传递Windows消息的窗口（Message Only)，在使用时，您不需要关心它在哪里，只需要使用它就好了。

一个IME需要导出19个（Win98版本）接口，但是对于一个只需要实现一般意义的文字输入的软件，您只需要实现几个基本的接口就可以让输入法正常工作了。下面逐一介绍一下这几个接口。

/**********************************************************************/
/* ImeSelect() */
/* Return Value: */
/* TRUE - successful, FALSE - failure */
/**********************************************************************/
BOOL WINAPI ImeSelect(HIMC hIMC,BOOL fSelect)在这个接口中，系统通知输入法当前是否打开了输入法输入。一般输入法启动时会调用一次，在一些软件（如EmEditor)中提供打开与关闭输入法的功能就是通过这个接口实现的。如果打开输入法，一般会在这个接口中做一些数据的初始化工作。/***********************************************************************/
/*系统调用这个接口来判断IME是否处理当前键盘输入 */
/*HIMC hIMC:输入上下文 */
/*UINT uKey:键值 */
/*LPARAM lKeyData: unknown */
/*CONST LPBYTE lpbKeyState:键盘状态,包含256键的状态 */
/*return : TRUE-IME处理,FALSE-系统处理 */
/*系统则调用ImeToAsciiEx，否则直接将键盘消息发到应用程序 */
/**********************************************************************/
BOOL WINAPI ImeProcessKey(HIMC hIMC,UINT uKey,LPARAM lKeyData,CONST LPBYTE lpbKeyState)

观察注释您可以看到在个接口是用来判断用户敲击的哪个键需要处理，哪个键又应该交给系统自己处理，如果输入法需要自己处理用户输入的键，则在这个接口中返回true,否则返回false。/****************************************************************************************************************/
/* function:应用程序调用这个接口来进行输入上下文的转换，输入法程序在这个接口中转换用户的输入 */
/* UINT uVKey:键值,如果在ImeInquire接口中为fdwProperty设置了属性IME_PROP_KBD_CHAR_FIRST,则高字节是输入键值*/
/* UINT uScanCode:按键的扫描码，有时两个键有同样的键值，这时需要使用uScanCode来区分 */
/* CONST LPBYTE lpbKeyState:键盘状态,包含256键的状态 */
/* LPDWORD lpdwTransKey:消息缓冲区，用来保存IME要发给应用程序的消息，第一个双字是缓冲区可以容纳的最大消息条数 */
/* UINT fuState:Active menu flag(come from msdn) */
/* HIMC hIMC:输入上下文 */
/* return : 返回保存在消息缓冲区lpdwTransKey中的消息个数 */
/****************************************************************************************************************/
UINT WINAPI ImeToAsciiEx (UINT uVKey,UINT uScanCode,CONST LPBYTE lpbKeyState,LPDWORD lpdwTransKey,UINT fuState,HIMC hIMC)这个接口可以说是输入法最重要的部分，程序员需要在这个接口中实现编码与重码的转换，转换完成或者显示在编码窗口及重码窗口，或者发送到应用程序。由于在这个接口中没有传入窗口句柄，如果通知输入法程序的窗口更新显示呢？当然我们可以使用全局变量，在此我个人推荐的方法是使用IME消息（没有什么道理），您将消息类型、参数保存到lpdwTransKey指示的缓冲区中，User.exe会根据消息类型做相应的处理并传递到UIWnd这个窗口中。

那么如何输入文字呢？要输入文字需要3个消息配合使用，分别是WM_IME_STARTCOMPOSITION、WM_IME_COMPOSITION和WM_IME_ENDCOMPOSITION，它们分别指示开始输入编码，输入编码或者结果（视参数而异）及编码输入完成。在开始编写输入法的时候，为了省事，我的输入法在用户确定要输入一个重码时才连续调用这3个消息以向编码器中输入文字。由于WM_IME_STARTCOMPOSITION和WM_IME_ENDCOMPOSITION需要成对使用，这种方法可以确保它们配对。最初这种方式工作得很好，但是后来发现在一些软件中出现兼容性问题。如“智能五笔”在“遨游”中就存在这个问题，在“遨游”中的地址栏中打开“智能五笔”，当需要使用回退键来删除错误输入的编码时，会发现删除的不是编码窗口中的编码而是编辑器中的文字。这是因为类似“遨游”这类软件主动接管了按键输入如处理一些控制键，当它发现这些控制键不在WM_IME_STARTCOMPOSITION和WM_IME_ENDCOMPOSITION这两个消息之间时就自己处理控制键而不是先交给User.exe了。因此正确的流程应该是在开始输入编码时发送WM_IME_STARTCOMPOSITION,输入结束后发送WM_IME_ENDCOMPOSITION消息。

/**********************************************************************/
/* UIWndProc() */
/* IME UI window procedure */
/**********************************************************************/
LRESULT WINAPI UIWndProc(HWND hUIWnd, UINT message,WPARAM wParam, LPARAM lParam)

这是一个非常重要的接口，基本上一它负责各种消息的传递。一般您需要在这个接口中根据不同的消息类型，实现输入法窗口（如编码窗口、重码窗口、状态栏窗口）的显示、隐藏及更新等操作。这个接口实现的功能可能非常复杂，视情况而异，在此就不做更加深入的说明了。在使用时可以参见示例工程。BOOL WINAPI ImeConfigure(HKL hKL,HWND hWnd, DWORD dwMode, LPVOID lpData)这是最后一个需要注意的接口，在显示输入法属性配置时会Windows会调用这个接口。