这个函数肯定是最重要的, 一个DLL没有这个入口函数的话就不是DLL了. 在DDK的 区位输入法代码里有一个sources的文件, 里面有一行:

DLLENTRY=ImeDllInit

你如果用别的build系统, 比如Visual Studio或者mingw, 你就应该自己配置你的入口函数是哪个.

这个函数在dll load的时候需要初始化你的输入法里要用到的全局变量, 以及注 册win32的几个窗口类. 在区位输入法里注册了四个窗口类, UI, Status, Comp, Cand. 其中UI窗口是一个纯消息窗口, 也是win32 IME必须要求的一个窗口. 这个 窗口的类名会在ImeInquire里传给win32 IME以便让win32 IME知道它应该去跟谁 通讯. 我的影舞笔输入法把Comp和Cand的窗口合并为一个了.

如果这个函数返回false的话那这个DLL就会load失败, 当前尝试load你的输入法 的这个程序就没法用你的输入法了. 所以在这个函数里你可以干一些很``酷''的 事情, 比如, 在测试阶段, 你可以指定只有notepad才能成功load你的输入法, 通 过GetModuleFileName你可以得到当前调用的程序的路径, 如果不是notepad, 那 就不让它用你的输入法. 然后呢, 你在win32的控制面板->区域设置里指定你当前 正在测试开发的输入法为默认的输入法, 这样你一打开notepad, 就可以开始测试 你的输入法了, 而不需要按一下输入法切换键才能开始测. 虽然只是省下按一个 键, 但是也是值得的, 因为相信你会按很多次的. 而这时候其他的程序不会受影 响, 你可以随便杀死notepad.exe, 做下一轮的开发, 测试迭代.

(win32下一个DLL被load了的话, 是不允许替换这个dll文件的. 所以当你发现一 个bug, 做了修正, 你没法把build出来的这个新的dll拷到系统路径里, 必须先把 所有的load了这个dll的程序杀死. 如果你的输入法不是默认的, 那你每次都要按 一下切换键才能开始测试; 如果它是默认的但是你不把除了notepad的其他程序排 除的话, 你每次都要杀死很多程序, 比如explorer.exe等. 尤其是如果你只能手 工一个一个的删的话, 很快你会疯掉的. 你甚至都不知道哪个程序load了你的输 入法. 只能一个一个的猜? 如果你知道sysinternal的process explorer的话, 那 你还可以用一下它的查找功能).

还有一个特别有用的功能是, 即使你的输入法还有bug, 但是如果这个bug只是针 对某个程序的话(或者说某个程序有bug, 但只针对你的输入法:-), 你可以把这个 程序排除在外. 比如, Cygwin下的X窗口程序都是由xwin.exe来画窗口的, 这些窗 口都不能处理win32的输入法, 但是win32的输入法切换键又能把输入法的状态栏 给切出来, 很明显没什么意义, 我就把xwin.exe在我的输入法里排除了. 又比如, 所有的DOS窗口的输入法处理都是由一个叫conime.exe的程序处理的, 这个程序好 像会对我的输入法提很非分的要求, 我干脆就把它也拒之门外:-) 以后我就打定 主意在终端窗口里再也不用输入法了, 呵呵! (造成这个的原因是前面提到的 conime是个``懂''输入法的应用, 它太``懂''了, 它要求你必须设置comp串 /cands告诉它知道, 你还不能自己显示! 我怀疑这个应用的imm是不是压根就不会 帮你创建那个ime消息窗口. 一句话, 它太霸道了).

做这样的选择, 我的生活会更简单.

这个函数是除了DllMain后第一个会被win32 IMM调用的函数. IMM通过调用这个函 数知道你的输入法有什么特性. 比如, 除了按键消息外, 你是不是还想处理键放 开的消息. 以下是我的影舞笔的此函数代码(注释版)

BOOL WINAPI
ImeInquire(LPIMEINFO lpImeInfo, LPTSTR lpszWndCls, DWORD dwSystemInfoFlags)
{
        if (!lpImeInfo) { //简单出错处理
                return FALSE;
        }

        lpImeInfo->dwPrivateDataSize = 0; //IMM会根据这个值自动为你的输
                                          //入法分配一块内存, 你可以用
                                          //它来保存一些你的context数据.
                                          //我嫌这玩意儿太"聪明"了, 不
                                          //用之.

        lpImeInfo->fdwProperty = IME_PROP_KBD_CHAR_FIRST | IME_PROP_UNICODE | IME_PROP_IGNORE_UPKEYS | IME_PROP_SPECIAL_UI;

        // IME_PROP_KBD_CHAR_FIRST 是说IMM调用你的ImeProcessKey和
        // ImeToAsciiEx函数之前是不是把按键消息的char值算出来, 在第一个
        // 整型参数的前两个字节里传给你, 其实你也可以自己算的如果你不设
        // 这个标志的话那第一个参数就只有低位的两个字节有意义 (好像是所
        // 按的键的虚拟键值).

        // IME_PROP_UNICODE, 意义应该很明显了, 一般肯定得设上

        // IME_PROP_IGNORE_UPKEYS, 就是上文说的要不要处理键放开的消息.
        // 不设这个标志就是要处理, 设了就是不处理(IMM针对键放开的消息就
        // 不会来调你的ImeProcessKey和ImeToAsciiEx了).

        // IME_PROP_SPECIAL_UI, 不记得什么意思了, 可以上google查一下.

        lpImeInfo->fdwConversionCaps =
                IME_CMODE_NATIVE | IME_CMODE_NOCONVERSION;
        lpImeInfo->fdwSentenceCaps = 0;
        lpImeInfo->fdwUICaps = UI_CAP_ROT90;
        lpImeInfo->fdwSCSCaps = SCS_CAP_COMPSTR | SCS_CAP_MAKEREAD;
        lpImeInfo->fdwSelectCaps = (DWORD) 0;

        // 这之上的这段代码是什么意思我也不明白, 但是这样写对我的影舞笔
        // 就够用了, 所以我也懒得去弄明白.

        lstrcpy(lpszWndCls, get_ui_class_name().c_str());

        // 这里你要把你的UI窗口的类名拷到IMM传给你的输出参数里.

        return (TRUE);

        // 一定要返回true, 没试过这里返回false会怎样. 
}

LPIMEINFO的定义可以在ddk的immdev.h里查到.

win32 IMM在收到一个键盘消息之后, 会先问一下这个函数, 你的IME是不是想处 理这个键, 如果你在这个函数里返回true, 意思就是你想处理, 那么imm就会接着 调下一个函数ImeToAsciiEx, 否则它就会自己处理这个键盘消息.

这个函数的返回值有点意思. 返回值应该是你这个函数的这次调用一共给win32产 生的多少个消息. 比如用户输入了一个完整的五笔编码, 希望提交他/她选中的候 选词了, 你就把要提交的数据(一个unicode字符串)写到输入法上下文的提交字串 的内存句柄中, 再把 ( WM_IME_COMPOSITION, 0, GCS_COMP|GCS_RESULT|GCS_RESULTREAD ) 这样一个消息添加到输入法上下文的 消息内存中, 把要返回多少个消息加一.

以下是输入法上下文结构的定义:

typedef struct tagINPUTCONTEXT {
    HWND                hWnd;
    BOOL                fOpen;
    POINT               ptStatusWndPos;
    POINT               ptSoftKbdPos;
    DWORD               fdwConversion;
    DWORD               fdwSentence;
    union   {
        LOGFONTA        A;
        LOGFONTW        W;
    } lfFont;
    COMPOSITIONFORM     cfCompForm;
    CANDIDATEFORM       cfCandForm[4];
    HIMCC               hCompStr;
    HIMCC               hCandInfo;
    HIMCC               hGuideLine;
    HIMCC               hPrivate;
    DWORD               dwNumMsgBuf;
    HIMCC               hMsgBuf;
    DWORD               fdwInit;
    DWORD               dwReserve[3];
} INPUTCONTEXT

这个函数里要处理IME消息. 其实UI窗口根本没有UI, 没有图形! 这个窗口是一个 纯消息窗口, 你不会收到 wm_paint 的消息. 所以我直接把区位输入法里处理 wm_paint 的回调函数删了. 我觉得把这个窗口命名为ImePureMsgWnd更合适一些.

话说回来, 这个IME第一重要的窗口是谁创建的呢? 答案是IMM. 你在区位输入法 的代码里不会看到这个窗口被CreateWindowEx. 在DllMain里你会注册这个窗口的 类, 在ImeInquire里你会把这个窗口的类名传给IMM. 之后你就会收到这个窗口的 创建消息了. 说明肯定是IMM负责创建了这个窗口.

这个函数根据收到的消息要负责创建Comp, Status等窗口, 移动这些窗口的位置, 等等.

这两个窗口函数最重要的当然是负责画窗口了.

• ImeConfigure 这个函数就是按理你应该弹一个对话框给用户配置你的输入法 的地方了, 像我们这种高级电脑用户, 对这种功能直接无视.
• ImeConversionList 这个函数是让另一个输入法来反查一个汉字在你的这个 输入法里是怎么打出来的. 比如区位输入法可以指定用微软拼音来反查一个 汉字的拼音. 在区位输入法的unicode模式下按``9999'';输入``香'', 输入 完后还会继续显示编辑窗, 内容是``xiang''. 这么无厘头的功能, 无视!
• ImeDestroy 没什么好说的,
• ImeEscape 也没什么好说的, 没什么鸟用. 以下是我的代码:
• ImeSelect Google出来的文档是说在这个函数里初始化或析构你的私有数据, 好吧, 我前面已经说了, 我没什么私有数据, 所以这个函数也可以简化了.
• ImeSetActiveContext
• ImeRegisterWord
• ImeUnregisterWord
• ImeGetRegisterWordStyle
• ImeEnumRegisterWord
• ImeSetCompositionString
• NotifyIME

可以上 这儿 去看文档. 这些函数都没有什么用.