| |
Windows的USER.EXE
|
输入法管理器
|
输入法 系统的键盘事件有windows的user.exe软件接收后,user.exe在将键盘事件传导输入法管理器(Input Method Manager,简称IMM)中,管理器再将键盘事件传到输入法中,输入法根据用户编码字典,翻译键盘事件为对应的汉字(或汉字串),然后再反传到user.exe中,user.exe再将翻译后的键盘事件传给当前正运行的应用程序,从而完成汉字的输入。 二、汉字输入法的组成 微软Windows9x系统中汉字输入法的名称是"Input Method Editor" ,简称IME,输入法的程序名称为:*.ime,数据文件名称为*.MB,即通常说的输入法编码表(字典). 实际上IME文件是一个动态连接库程序(DLL),它与dll文件没有区别,只是名称不同而已。 一般汉字输入法都由三个窗口组成: 状态窗口(Status Windows)-显示当前的输入法状态(中文还是英文等站环信息); 编码输入窗口(Composition Windows)-显示当前击键情况; 汉字选择窗口(Candidates Windows)-列出当前编码的全部汉字(串),供用户选择或查询。 上述三个窗口由基本的用户接口(User Interface )函数管理着。 现在我们用Dumpbin.exe打开微软提供的拼音输入法(WINDOWS/SYSTEM/WINPY.IME)看看它有什么组成(这里一WINDOWS98为例,并假定windows系统安装在c:盘下):
C:/Dumpbin c:/windows/system/winpy.ime
Microsoft (R) COFF Binary File Dumper Version 6.00.8168
Copyright (C) Microsoft Corp 1992-1998. All rights reserved.
Dump of file WINPY.IME
File Type: DLL
//IME 实际为dll程序Section contains the following exports for WINPY.ime
0 characteristics
34A37323 time date stamp Fri Dec 26 17:04:35 1997
0.00 version
1 ordinal base
19 number of functions //
19 number of names // 对应19个名称
ordinal hint RVA name
1 0 0000A010 CandWndProc
//"选择汉字窗口"注册函数2 1 0000E750 CompWndProc //"输入编码窗口"注册函数
3 2 0000FB50 ImeConfigure //配置当前ime参数函数
4 3 0000FEC0 ImeConversionList//将字符或字符串转换成目标字符
5 4 0000FFA0 ImeDestroy //退出当前使用的IME
6 5 000030D0 ImeEnumRegisterWord
7 6 0000FFB0 ImeEscape //应用软件访问输入法的接口函数.
8 7 00003080 ImeGetRegisterWordStyle
9 8 0000E9A0 ImeInquire //启动并初始化当前IME输入法
10 9 0000A800 ImeProcessKey //IME输入键盘事件管理函数
11 A 00002C20 ImeRegisterWord //向输入法字典注册字符串
12 B 000109A0 ImeSelect //启动当前IME输入法
13 C 000109E0 ImeSetActiveContext //设置当前的输入处于活动状态.
14 D 0000C850 ImeSetCompositionString 由应用程序设置输入法编码
15 E 0000AEE0 ImeToAsciiEx //将输入的键盘事件转换为汉字编码事件
16 F 00002F40 ImeUnregisterWord //删除被注册的字符串.
17 10 0000CA90 NotifyIME //IME事件管理函数
18 11 00005160 StatusWndProc //状态窗口注册函数
19 12 00002350 UIWndProc //用户界面接口函数
Summary
5000 .ShareDa
7000 .data
2000 .idata
1000 .rdata
3000 .reloc
5000 .rsrc
2000 .sgroup
18000 .text
1. BOOL ImeInquire( //
初始化IMELPIMEINFO lpIMEInfo, //用于初始化该输入法的结构地址
LPTSTR lpszWndClass, //当前输入法的名称
LPCTSTR或者dword lpszData //系统信息,9X系列值为0,NT/2000下有实际值
) 如果该函数初始化成功,返回TURE,否则为FALSE 用户应该搞清楚IMEINFO结构,特关系着你设计的输入法是否成功.有关该结构请看"结构"一章.
2.DWORD IMEConversionList( //
将某字符或字符串转换成目标字符串HIMC hIMC, // 与当前输入法相关的应用程序句柄
LPCTSTRlpSrc, // 要转换的字符串 (也可能是结果串,可由uFlag指定)
LPCANDIDATELIST lpDst, /// 转换后的字符串(也可能是源串,可由uFlag指定)
DWORD dwBufLen, //转换后有几个字符
UINT uFlag //指定结果的存放位置
) 如果成功,返回转换后的字符串长度
3.BOOL ImeConfigure( //
用户设置输入法接口HKL hKL, //当前输入法句柄
HWND hWnd, //配置窗口的父窗口
DWORD dwMode, //配置什么
LPVOID lpData //用户设置的数据
) 该函数的功能是提供给输入法使用者一个可以更改某些隐含设置的能力. 如果你用过别人的输入法,其中的"配置输入法..."功能既是也! 对于一个初写输入法的人,可以不予理它.
4.BOOL ImeDestroy( //
关闭当前输入法UINT uReserved //无用 (0)
) 成功返回TURE,否则为FALSE
5.LRESULT ImeEscape( //
用户软件访问输入法内部信息的接口HIMC hIMC, //当前的应用程序句柄
UINT uEscape, //设置函数功能
//=IME_ESC_QUERY _SUPPORT
//=IME_ESC_RESERVED_LAST IME_ESC_RESERVED_FIRST
//=IME_ESC_PRIVATE_FIRST IME_ESC_PRIVATE_LAST
//=IME_ESC_SEQUENCE_TO_ INTERNAL
//=IME_ESC_GET_EUDC_ DICTIONARY
//=IME_ESC_SET_EUDC_ DICTIONARY
//=IME_ESC_MAX_KEY
//=IME_ESC_IME_NAME
//=IME_ESC_SYNC_HOTKEY
//=IME_ESC_HANJA_MODE
//=IME_ESC_GETHELPFILENAME(
只适应 Windows 98和Windows 2000)//=IME_ESC_PRIVATE_HOTKEY(w95
下不可用)LPVOID lpData //
当前功能所需的数据) 如果失败,返回0,否则有个功能决定 有时,人们可以用此函数怀区输入法的名称、帮助文件名称等。当然,我们可以不提供这些功能。
6
、BOOL ImeSetActiveContext( //激活或搁置当前的输入法HIMC hIMC, //当前用户程序句柄
BOOL fFlag //激活或搁置:=TRUE 激活 =FALSE 搁置
) 成功返回TRUE,否则为FALSE
7
、BOOL ImeProcessKey( //处理应用程序传入的所有击键事件,监测是否是当前输入法所需的HIMC hIMC, //应用程序句柄
UINT uVirKey, //需处理的虚键
DWORD lParam, //击键消息参数
CONST LPBYTE lpbKeyState //当前键盘状态(256字节)
) 如果此键是该输入法需要的,则返回TRUE,否则为FALSE 只有返回true的击键,IME才去处理
8
、BOOL NotifyIME( //输入法选择窗口状态管理函数:HIMC hIMC, //当前的应用程序句柄
DWORD dwAction, //状态值
DWORD dwIndex, //与状态值有关的序号
DWORD dwValue //与状态值有关的值
) 状态值说明:
=NI_OPENCANDIDATE
打开编码选择窗口=NI_CLOSECANDIDATE
关闭当前的编码选择窗=NI_SELECTCANDIDATESTR
选摘编码 此时:dwIndex 被选择的编码列表序号.dwValue
被选中的编码在当前的编码列表中的序号=NI_CHANGECANDIDATELIST
改变当前的编码列表(按pageup等键操作) 此时:dwIndex 被选择的编码列表序号.dwValue
不用=NI_SETCANDIDATE_PAGESTART
设置编码开始页号 此时: dwIndex 被改变的编码列表序号dwValue
新页的开始序号.=NI_SETCANDIDATE_PAGESIZE
改变编码列表页的大小 此时:dwIndex 当前编码页序号dwValue
新的页大小=NI_CONTEXTUPDATED
更新应用程序的信息的输入法的信息:移动位置,设置模式,设置编码窗口,字体。 此时:dwIndex 只用于 dwValue=IMC_SETCONVERSIONMODE, IMC_SETSENTENCEMODEdwValue
可取由 WM_IME_CONTROL 发送的下列值:IMC_SETCANDIDATEPOS
IMC_SETCOMPOSITIONFONT
IMC_SETCOMPOSITIONWINDOW
IMC_SETCONVERSIONMODE
IMC_SETSENTENCEMODE
IMC_SETOPENSTATUS
=NI_COMPOSITIONSTR
改变编码窗口中的编码 此时:dwIndex 取下列值:CPS_COMPLETE 完成编码转换CPS_CONVERT
转换编码CPS_REVERT
取消当前的编码CPS_CANCEL
清除编码,并关闭编码窗dwValue
不用 此函数成功,返回TRUE,否则为FALSE9
、BOOL ImeSelect( //初始化输入法HIMC hIMC, //当前应用程序句柄
BOOL fSelect //是否初始化当前输入法,TRUE表示初始化
) 返回:成功返回true,否则为FALSE
The ImeSetCompositionString function is used by an application to set the IME composition string structure with the data contained in the lpComp or lpRead parameters. The IME then generates a message.
10
、BOOL WINAPI ImeSetCompositionString( //将编码窗口中输入的编码保存的编码结构中,//
同志发送编码完成的消息//
( WM_IME_COMPOSITION)给系统,HIMC hIMC, //当前的应用程序句柄
DWORD dwIndex, //设置此函数功能
//=SCS_SETSTR
//=SCS_CHANGEATTR
//=SCS_CHANGECLAUSE
//= SCS_QUERYRECONVERTSTRING
//=SCS_RECONVERTSTRING
//=SCS_SETRECONVERTSTRING
LPCVOID lpComp, //
编码数据区DWORD dwCompLen, //编码数据区长度
LPCVOID lpRead, //读入的编码数据
DWORD dwReadLen //读入的编码数据长度
)
11
、UINT ImeToAsciiEx( //转换编码称汉字(串)UINT uVirKey, //虚键
UINT uScanCode, //扫描码
CONST LPBYTE lpbKeyState, //用户定义的键盘状态
LPDWORD lpdwTransBuf, //转换后的数据存放区
UINT fuState, //活动菜单标志
HIMC hIMC //当前的应用程序句柄
) 返回:返回值表示有几个消息,可理解为:本编码对应的汉字串有几个汉字组成(当然,这并不相等)。
12
、BOOL WINAPI ImeRegisterWord(LPCTSTR lpszReading,
DWORD dwStyle,
LPCTSTR lpszString
)
13
、BOOL WINAPI ImeUnregisterWord(LPCTSTR lpszReading,
DWORD dwStyle,
LPCTSTR lpszString
)
14
、UINT WINAPIImeGetRegisterWordStyle(
UINT nItem,
LPSTYLEBUF lpStyleBuf
)
15
、UINT WINAPI ImeEnumRegisterWord(hKL,
REGISTERWORDENUMPROC lpfnEnumProc,
LPCTSTR lpszReading,
DWORD dwStyle,
LPCTSTR lpszString,
LPVOID lpData
)
16
、DWORD WINAPI ImeGetImeMenuItems(HIMC hIMC,
DWORD dwFlags,
DWORD dwType,
LPIMEMENUITEMINFO lpImeParentMenu,
LPIMEMENUITEMINFO lpImeMenu,
DWORD dwSize
) 四.ime的版本信息(与普通DLL的区别)
VS_VERSION_INFO VERSIONINFO
代表字符含义FILEVERSION 4,0,0,950 //4.00.950 95版
PRODUCTVERSION 4,0,0,950 //4.00.950 95版
FILEFLAGSMASK 0x3fL
FILEFLAGS 0xaL
FILEOS 0x10004L //VOS_DOS_WINDOWS32 WIN32软件,可在DOS下运行
FILETYPE 0x3L //VFT_DRV 驱动程序
FILESUBTYPE 0xbL //VFT2_DRV_INPUTMETHOD 输入法驱动程序
BEGIN
BLOCK "StringFileInfo"
BEGIN
BLOCK "080403a8"
BEGIN
VALUE "Comments", "/0"
VALUE "CompanyName", "唐码软件开发工作室/0"
VALUE "FileDes cription", "唐码输入法版本1.0/0"
VALUE "FileVersion", "4.00.950/0"
VALUE "InternalName", "唐码输入法版本1.0/0"
VALUE "LegalCopyright", "Copyright (C) 唐码软件开发工作室 1999-1999/0"
VALUE "LegalTrademarks", "/0"
VALUE "OriginalFilename", "TM.IME/0"
VALUE "PrivateBuild", "/0"
VALUE "ProductName", "唐码输入法版本1.0/0"
VALUE "ProductVersion", "4.00.950/0"
VALUE "SpecialBuild", "/0"
END 第二章 Windows9x系统提供的ime管理函数 上一章,我们介绍了ime文件中必须设计的函数,这些函数要靠我们自己来设计。要完成这些函数的设计,需用到windows系统提供的管理函数(Input Method Manager,简称IMM)。
IMM
函数可以被IME函数使用,也可用于应用软件直接管理IME。 相关术语:(1)input method context
简称IMC--输入法相关部分,在这里解释为:相关连的应用程序(进程)(2)component of the input context
简称IMCC--IMC的部件,是INPUTCONTEXT 结构的成员。 一、IME中使用的IMM函数清单ImmGetCompositionWindow //
取编码窗口信息ImmSetCompositionWindow //
设置编码窗口信息ImmGetCandidateWindow //
取选择窗口信息ImmSetCandidateWindow //
设置选择窗口信息ImmGetCompositionString //
取编码窗口的某一信息ImmSetCompositionString //
设置编码窗口的某一信息ImmGetCompositionFont //
取编码字体ImmSetCompositionFont //
设置编码字体ImmGetNumCandidateList //
取选择区中编码数ImmGetCandidateList //
取选择区中编码ImmGetGuideLine
ImmGetConversionStatus //
取当前输入法的状态(ACSII,SHAPE,FULL等)ImmGetConversionList //
重新获得选择区转换表ImmGetOpenStatus //
取输入法打开属性ImmSetConversionStatus //
设置输入法状态ImmSetOpenStatus //
设置输入法打开状态ImmNotifyIME //
通报IME,输入法状态被改变ImmGenerateMessage //
将我们的汉字串法发送到与当前输入法相关联的应用软件中ImmRequestMessage //向应用程序发送WM_IME_REQUEST
ImmLockIMC //
获取当前IMC的INPUTCONTEXT结构信息,增加IMC 计数器ImmUnlockIMC //释放IMC计数器
ImmGetIMCLockCount //取计数器值
ImmCreateIMCC //创建INPUTCONTEXT结构的一个成员
ImmDestroyIMCC //删除IMC成员缓冲区
ImmLockIMCC //取IMCC缓冲地址,同时使IMCC的计数器值增加
ImmUnlockIMCC //递减IMCC计数器
ImmReSizeIMCC //重新设置IMC的成员的缓冲区大小
ImmGetIMCCSize //取IMC成员的缓冲区大小
ImmGetIMCCLockCount //返回IMC计数器值
ImmGetHotKey //取输入法状态键,该函数供控制面板使用
ImmSetHotKey //
设置输入法的热键ImmCreateSoftKeyboard //产生一个软键盘
ImmDestroySoftKeyboard //销毁软键盘
ImmShowSoftKeyboard //显示或隐藏软键盘
二、IMM函数使用格式说明
1
、BOOL WINAPI ImmGenerateMessage( //将我们的汉字串法发送到与当前输入法相关联的应用软件中HIMC hIMC //与当前输入法相关联的应用软件的句柄,
//
该结构的hMsgBuf项即为汉字串消息) 成功为TRUE,否则为FALSE
2
、LRESULT WINAPI ImmRequestMessage( //向应用程序发送WM_IME_REQUEST//
只是用于w98及w2000HIMC hIMC, //与当前输入法相关联的应用软件的句柄
WPARAM wParam, //与WM_IME_REQUEST相关的wP
LPARAM lParam