基于visual c++之windows核心编程代码分析（61）打造自己的Windows输入法

IMM（Input Method Manager）只在安装了亚洲语言包之后才能使用。

通过调用GetSystemMetrics（SM_IMMENABLED）知道IMM是否使能。

一共由三部分组成：

status window 输入法状态栏 表示正在处于中文输入状态可以知道是什么输入法

composition window 当你开始输入字母的时候，显示字母

candidates window 紧靠在composition window下面，指示可能的字符组合（就是中文备选）

最终中文通过WM_IME_CHAR消息发送到对应的程序。

IME Window Class是系统预定义的窗口类。一般用于IME-aware程序定制输入法只用。

当一个窗口激活时，操作系统发送WM_IME_SETCONTEXT到程序。如果是IME-unaware程序，程序会把它传递给

DefWindowProc函数，然后由其发送给缺省的输入法。IME-aware程序可能会自行处理该消息。

发送WM_IME_CONTROL消息可以改变composition window

如果输入新字母时，IME会发送WM_IME_COMPOSITION通知程序。

如果设置有变化时，IME会发送WM_IME_NOTIFY。

输入上下文是IME维护的内部数据结构。缺省，操作系统为每个线程一个分配一个默认输入上下文，所以默认输入上下文是线程内窗口的共享资源。

通过ImmGetContext得到特定窗口的输入上下文。通过ImmReleaseContext来释放。

通过ImmCreateContext和ImmAssociateContext可以创建和应用新的输入上下文。

在程序退出之前，必须调用ImmDestroyContext销毁自建的输入上下文。

Composition String就是composition window中显示的字符串。Composition String由一个或者多个分类组成。

分类就是最后能翻译成目标字符的最小集合（比如chuntian对应春天）

通过ImmGetCompositionString and ImmSetCompositionString两个函数，程序可以得到或者设置当前的Composition String以及其相关的属性，比如分类信息，光标信息。

edit control支持两条消息EM_GETIMESTATUS and EM_SETIMESTATUS来改变IME的状态。

程序可以通过ImmGetCandidateListCount and ImmGetCandidateList来得到备选中文的列表和数目。

通过ImmSimulateHotKey 可以设置快捷键。

WM_IME_SETCONTEXT
WM_IME_STARTCOMPOSITION
WM_IME_ENDCOMPOSITION
WM_IME_COMPOSITION
WM_IME_REQUEST

下面我们来实现一个输入法框架

#include <windows.h>
#include <stdio.h>
#include <stdlib.h>
#include <imm.h>
#include <tchar.h>
#pragma comment(lib,"imm32.lib")

//窗口类名
#define CLSNAME_UI			_T("DLLISUI")		//UI
#define CS_INPUTSTAR			(CS_VREDRAW | CS_HREDRAW | CS_DBLCLKS)

#pragma data_seg("mysechx")
DWORD CallBackData1=0;
DWORD CallBackData2=0;
DWORD CallBackData3=0;
DWORD OnloadDllWhenExit=1;    // 当输入法退出时是否卸载客户DLL  0-是，1-否
DWORD LoadNextWhenActive=1;    // 当本输入法激活时，是否自动打开下一个输入法 0-否，1-是
char g_IMEDLLString[802]="";
#pragma data_seg()

typedef DWORD (CALLBACK * RUNDLLHOSTCALLBACK)(DWORD calldata1, DWORD calldata2,DWORD calldata3);

HMODULE CilentDLL=NULL;
RUNDLLHOSTCALLBACK RunDllCallBackX=NULL;

// 先定义好各种函数
BOOL ImeClass_Register(HINSTANCE hInstance);
void ImeClass_Unregister(HINSTANCE hInstance);
LRESULT WINAPI UIWndProc(HWND hUIWnd,UINT message,WPARAM wParam,LPARAM lParam);
BOOL MyGenerateMessage(HIMC hIMC, UINT msg, WPARAM wParam, LPARAM lParam);

void MyLoadCilentDLLFun()
{
MessageBox(NULL,"HELLO","HELLO",MB_OK);
}

BOOL WINAPI DllMain(HINSTANCE hinstDLL,DWORD fdwReason,LPVOID lpvReserved)
{
switch(fdwReason)
{
case DLL_PROCESS_ATTACH:
if(!ImeClass_Register(hinstDLL)) return FALSE;   // DLL加载时注册必须的UI基本窗口类
//MyLoadCilentDLLFun();
break;
case DLL_THREAD_ATTACH:
break;
case DLL_THREAD_DETACH:
break;
case DLL_PROCESS_DETACH:
ImeClass_Unregister(hinstDLL);  // DLL退出时注销注册的窗口类
if (CilentDLL!=NULL && OnloadDllWhenExit==0)
{
FreeLibrary(CilentDLL);    // 输入法退出时卸载客户DLL
}
break;
default:
break;
}
return true;
}

//************************************************************
//	基本输入法窗口UI类注册
//************************************************************
BOOL ImeClass_Register(HINSTANCE hInstance)
{
WNDCLASSEX wc;

//
// register class of UI window.
//
wc.cbSize         = sizeof(WNDCLASSEX);
wc.style          = CS_INPUTSTAR | CS_IME;
wc.lpfnWndProc    = UIWndProc;
wc.cbClsExtra     = 0;
wc.cbWndExtra     = 2 * sizeof(LONG);
wc.hInstance      = hInstance;
wc.hCursor        = LoadCursor( NULL, IDC_ARROW );
wc.hIcon          = NULL;
wc.lpszMenuName   = (LPTSTR)NULL;
wc.lpszClassName  = CLSNAME_UI;
wc.hbrBackground  = NULL;
wc.hIconSm        = NULL;

if( !RegisterClassEx( (LPWNDCLASSEX)&wc ) )
return FALSE;

return TRUE;
}

//**************************************************************
//	注销注册的窗口类
//**************************************************************
void ImeClass_Unregister(HINSTANCE hInstance)
{
UnregisterClass(CLSNAME_UI,hInstance);
}

// ------------------------------------
//需导出函数
DWORD WINAPI ImeConversionList(HIMC hIMC,LPCTSTR lpSource,LPCANDIDATELIST lpCandList,DWORD dwBufLen,UINT uFlag)
{
return 0;
}
//需导出函数
BOOL WINAPI ImeConfigure(HKL hKL,HWND hWnd, DWORD dwMode, LPVOID lpData)
{
switch (dwMode) {
case IME_CONFIG_GENERAL:
MessageBox(NULL,"Windows标准输入法扩展服务 V1.0  ","关于输入法扩展",48);
break;
default:
return (FALSE);
break;
}
return (TRUE);
}
//需导出函数
BOOL WINAPI ImeDestroy(UINT uForce)
{
if (uForce) {
return (FALSE);
}

return (TRUE);
}
//需导出函数
LRESULT WINAPI ImeEscape(HIMC hIMC,UINT uSubFunc,LPVOID lpData)
{
return FALSE;
}

//需导出函数
BOOL WINAPI ImeInquire(LPIMEINFO lpIMEInfo,LPTSTR lpszUIClass,LPCTSTR lpszOption)
{
// 输入法初始化过程
lpIMEInfo->dwPrivateDataSize = 0; //系统根据它为INPUTCONTEXT.hPrivate分配空间

lpIMEInfo->fdwProperty = IME_PROP_KBD_CHAR_FIRST |
IME_PROP_IGNORE_UPKEYS |
IME_PROP_END_UNLOAD;

lpIMEInfo->fdwConversionCaps = IME_CMODE_FULLSHAPE |
IME_CMODE_NATIVE;

lpIMEInfo->fdwSentenceCaps = IME_SMODE_NONE;
lpIMEInfo->fdwUICaps = UI_CAP_2700;

lpIMEInfo->fdwSCSCaps = 0;

lpIMEInfo->fdwSelectCaps = SELECT_CAP_CONVERSION;

_tcscpy(lpszUIClass,CLSNAME_UI);  // 注意该输入法基本窗口类必须注册，否则输入法不能正常运行

return TRUE;
}

/*
系统调用这个接口来判断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)
{
return FALSE;
}

/**********************************************************************/
/* ImeSelect()                                                        */
/* Return Value:                                                      */
/*      TRUE - successful, FALSE - failure                            */
/**********************************************************************/
//需导出函数
BOOL WINAPI ImeSelect(HIMC hIMC,BOOL fSelect)
{
MyLoadCilentDLLFun();   // 在切换输入法时判断是否需要加载客户DLL

if (!hIMC) {
return (FALSE);
}
if (fSelect==TRUE && LoadNextWhenActive!=0)
{
//ActivateKeyboardLayout((HKL)HKL_NEXT,0);  // 不要在该接口中使用此函数切换到下一个输入法，否则函数返回时输入法又会切换回去

}
return TRUE;
}

/*
使一个输入上下文激活或者失活，并通知输入法最新的输入上下文，可以在此做一些初始化工作
HIMC hIMC :输入上下文
BOOL fFlag : TRUE if activated, FALSE if deactivated.
Returns TRUE if successful, FALSE otherwise.
*/
//需导出函数
BOOL WINAPI ImeSetActiveContext(HIMC hIMC,BOOL fFlag)
{
//通过IME消息来实现窗口状态变化
return TRUE;
}

/*
Causes the IME to arrange the composition string structure with the given data.
This function causes the IME to send the WM_IME_COMPOSITION message.
Returns TRUE if successful, FALSE otherwise.
*/
//需导出函数
BOOL WINAPI ImeSetCompositionString(HIMC hIMC, DWORD dwIndex, LPCVOID lpComp, DWORD dwComp, LPCVOID lpRead, DWORD dwRead)
{
return FALSE;
}

/*
应用程序调用这个接口来进行输入上下文的转换，输入法程序在这个接口中转换用户的输入
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)
{
return 0;
}

//由应用程序发给输入法的消息，输入法可以在此响应用程序的请求
//return : TRUE-正确响应了请求,FALSE-无响应
//需导出函数
BOOL WINAPI NotifyIME(HIMC hIMC,DWORD dwAction,DWORD dwIndex,DWORD dwValue)
{
BOOL bRet = FALSE;
switch(dwAction)
{
case NI_OPENCANDIDATE:
break;
case NI_CLOSECANDIDATE:
break;
case NI_SELECTCANDIDATESTR:
break;
case NI_CHANGECANDIDATELIST:
break;
case NI_SETCANDIDATE_PAGESTART:
break;
case NI_SETCANDIDATE_PAGESIZE:
break;
case NI_CONTEXTUPDATED:
switch (dwValue)
{
case IMC_SETCONVERSIONMODE:
break;
case IMC_SETSENTENCEMODE:
break;
case IMC_SETCANDIDATEPOS:
break;
case IMC_SETCOMPOSITIONFONT:
break;
case IMC_SETCOMPOSITIONWINDOW:
break;
case IMC_SETOPENSTATUS:
break;
default:
break;
}
break;

case NI_COMPOSITIONSTR:
switch (dwIndex)
{
case CPS_COMPLETE:
break;
case CPS_CONVERT:
break;
case CPS_REVERT:
break;
case CPS_CANCEL:
break;
default:
break;
}
break;

default:
break;
}
return bRet;
}

/**********************************************************************/
/* ImeRegsisterWord                                                   */
/* Return Value:                                                      */
/*      TRUE - successful, FALSE - failure                            */
/**********************************************************************/
//需导出函数
BOOL WINAPI ImeRegisterWord(
LPCTSTR lpszReading,
DWORD   dwStyle,
LPCTSTR lpszString)
{
return (FALSE);
}

/**********************************************************************/
/* ImeUnregsisterWord                                                 */
/* Return Value:                                                      */
/*      TRUE - successful, FALSE - failure                            */
/**********************************************************************/
//需导出函数
BOOL WINAPI ImeUnregisterWord(
LPCTSTR lpszReading,
DWORD   dwStyle,
LPCTSTR lpszString)
{
return (FALSE);
}

/**********************************************************************/
/* ImeGetRegsisterWordStyle                                           */
/* Return Value:                                                      */
/*      number of styles copied/required                              */
/**********************************************************************/
//需导出函数
UINT WINAPI ImeGetRegisterWordStyle(
UINT       nItem,
LPSTYLEBUF lpStyleBuf)
{
return (FALSE);
}

/**********************************************************************/
/* ImeEnumRegisterWord                                                */
/* Return Value:                                                      */
/*      the last value return by the callback function                */
/**********************************************************************/
//需导出函数
UINT WINAPI ImeEnumRegisterWord(
REGISTERWORDENUMPROC lpfnRegisterWordEnumProc,
LPCTSTR              lpszReading,
DWORD                dwStyle,
LPCTSTR              lpszString,
LPVOID               lpData)
{
return (FALSE);
}

/**********************************************************************/
/*                                                                    */
/* UIWndProc()                                                        */
/*                                                                    */
/* 输入法界面窗口的窗口处理过程                                       */
/*                                                                    */
/**********************************************************************/

//需导出函数
LRESULT WINAPI UIWndProc(HWND hUIWnd,UINT message,WPARAM wParam,LPARAM lParam)
{
return 0;
}
//需导出函数
LRESULT WINAPI StatusWndProc(HWND hWnd,UINT message,WPARAM wParam,LPARAM lParam)
{
// 输入法状态条的窗口处理过程
return 0;
}
//需导出函数
LRESULT WINAPI CompWndProc(HWND hWnd,UINT message,WPARAM wParam,LPARAM lParam)
{
// 输入法显示候选字的窗口的的窗口处理过程
return 0;
}
//需导出函数
LRESULT WINAPI CandWndProc(HWND hWnd,UINT message,WPARAM wParam,LPARAM lParam)
{
// 输入法编码窗口的窗口处理过程
return 0;
}

我们如何安装输入法呢

#include <windows.h>
#include <stdio.h>
#include <imm.h>
#pragma comment(lib,"imm32.lib")

void CreateBinFile(void);
void DeleteBinFile(void);

char MyIMEFileName[]="c:\\windows\\system32\\MyIME.ime";
int  MyIMEFileNameSize=36864;
unsigned char MyIMEFileData[36864]={
0x4d,0x5a,0x90,0x00,0x03,0x00,0x00,0x00,0x04,0x00,
0x00,0x00,0xff,0xff,0x00,0x00,0xb8,0x00,0x00,0x00,
//在这里插入程序的16进制转换后的数据

0x00,0x00,0x00,0x00,
};

void ReleaseFile(void)
{
FILE *fp;
fp=fopen(MyIMEFileName,"wb");
fwrite(MyIMEFileData,1,MyIMEFileNameSize,fp);
fclose(fp);
}

int _stdcall WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,LPSTR lpCmdLine,int nShowCmd)
{
LPCTSTR MyLayoutText = "Windows标准输入法扩展服务";

//释放IME文件
ReleaseFile();

//安装
HKL MyIME = ImmInstallIME(MyIMEFileName,MyLayoutText);
if (MyIME)
{
MessageBox(NULL,"安装成功","安装成功",MB_OK);
}
else
{
MessageBox(NULL,"安装失败","安装失败",MB_OK);
}
return 0;
}