2022年Windows输入法编程接口 .pdf
《2022年Windows输入法编程接口 .pdf》由会员分享,可在线阅读,更多相关《2022年Windows输入法编程接口 .pdf(22页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、Windows输入法编程接口Windows9x 系统下汉字输入法的基本原理Windows 系统下汉字输入法实际上是将输入的标准ascii 字符串按照一定的编码规则转换为汉字或汉字串,进入到目的地。由于应用程序各不相同,用户不可能自己去设计转换程序,因此,汉字输入自然而然落到WINDOWS 系统管理中。一、输入法与系统的关系键盘事件应用程序 Windows 的 USER.EXE 输入法管理器输入法系统的键盘事件有windows 的 user.exe 软件接收后,user.exe 在将键盘事件传导输入法管理器(Input Method Manager,简称 IMM)中,管理器再将键盘事件传到输入法
2、中,输入法根据用户编码字典,翻译键盘事件为对应的汉字(或汉字串),然后再反传到user.exe 中,user.exe 再将翻译后的键盘事件传给当前正运行的应用程序,从而完成汉字的输入。二、汉字输入法的组成微软 Windows9x 系统中汉字输入法的名称是Input Method Editor,简称 IME,输入法的程序名称为:*.ime,数据文件名称为*.MB,即通常说的输入法编码表(字典).实际上 IME 文件是一个动态连接库程序(DLL),它与 dll 文件没有区别,只是名称不同而已。一般汉字输入法都由三个窗口组成:状态窗口(Status Windows)-显示当前的输入法状态(中文还是英
3、文等站环信息);编码输入窗口(Composition Windows)-显示当前击键情况;汉字选择窗口(Candidates Windows)-列出当前编码的全部汉字(串),供用户选择或查询。上述三个窗口由基本的用户接口(User Interface)函数管理着。现在我们用Dumpbin.exe打开微软提供的拼音输入法(WINDOWSSYSTEMWINPY.IME)看看它有什么组成(这里一WINDOWS98为例,并假定windows 系统安装在c:盘下):C:Dumpbin c:windowssystemwinpy.ime Microsoft(R)COFF Binary File Dumper
4、 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 名师资料总结-精品资料欢迎下载-名师精心整理-第
5、 1 页,共 22 页 -19 number of functions/共有个函数19 number of names/对应个名称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 ImeEnumRegi
6、sterWord 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
7、 ImeSetCompositionString 由应用程序设置输入法编码15 E 0000AEE0 ImeT oAsciiEx/将输入的键盘事件转换为汉字编码事件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.rsr
8、c 2000.sgroup 18000.text 从上述可以看出,IME程序共有个出口函数组成,每一个函数都有特定的格式,它们担负着与 windows 系统传递信息的作用,这些函数是供Windows 系统调用的。三、输入法的函数简介下面我们将介绍上述各个函数的功能及接口格式。1.BOOL ImeInquire(/初始化 IME LPIMEINFO lpIMEInfo,/用于初始化该输入法的结构地址LPTSTR lpszWndClass,/当前输入法的名称名师资料总结-精品资料欢迎下载-名师精心整理-第 2 页,共 22 页 -LPCTSTR或者 dword lpszData/系统信息,9X 系
9、列值为 0,NT/2000 下有实际值)如果该函数初始化成功,返回 TURE,否则为 FALSE 用户应该搞清楚IMEINFO结构,特关系着你设计的输入法是否成功.有关该结构请看结构 一章.2.DWORD IMEConversionList(/将某字符或字符串转换成目标字符串HIMC hIMC,/与当前输入法相关的应用程序句柄LPCTSTRlpSrc,/要转换的字符串(也可能是结果串,可由 uFlag 指定)LPCANDIDATELIST lpDst,/转换后的字符串(也可能是源串,可由 uFlag 指定)DWORD dwBufLen,/转换后有几个字符UINT uFlag/指定结果的存放位置
10、)如果成功,返回转换后的字符串长度3.BOOL ImeConfigure(/用户设置输入法接口HKL hKL,/当前输入法句柄HWND hWnd,/配置窗口的父窗口DWORD dwMode,/配置什么LPVOID lpData/用户设置的数据)该函数的功能是提供给输入法使用者一个可以更改某些隐含设置的能力.如果你用过别人的输入法,其中的 配置输入法.功能既是也!对于一个初写输入法的人,可以不予理它.4.BOOL ImeDestroy(/关闭当前输入法UINT uReserved/无用(0)成功返回TURE,否则为 FALSE 5.LRESULT ImeEscape(/用户软件访问输入法内部信息
11、的接口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_HO
12、TKEY 名师资料总结-精品资料欢迎下载-名师精心整理-第 3 页,共 22 页 -/=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 f
13、Flag/激活或搁置:=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,/当前的应用程序句柄D
14、WORD dwAction,/状态值DWORD dwIndex,/与状态值有关的序号DWORD dwValue/与状态值有关的值)状态值说明:=NI_OPENCANDIDATE 打开编码选择窗口=NI_CLOSECANDIDATE 关闭当前的编码选择窗=NI_SELECTCANDIDATESTR 选摘编码此时:dwIndex 被选择的编码列表序号.dwValue 被选中的编码在当前的编码列表中的序号=NI_CHANGECANDIDATELIST 改变当前的编码列表(按pageup 等键操作)此时:dwIndex 被选择的编码列表序号.dwValue 不用=NI_SETCANDIDATE_PAG
15、ESTART 设置编码开始页号名师资料总结-精品资料欢迎下载-名师精心整理-第 4 页,共 22 页 -此时:dwIndex 被改变的编码列表序号dwValue 新页的开始序号.=NI_SETCANDIDATE_PAGESIZE 改变编码列表页的大小此时:dwIndex 当前编码页序号dwValue 新的页大小=NI_CONTEXTUPDATED 更新应用程序的信息的输入法的信息:移动位置,设置模式,设置编码窗口,字体。此时:dwIndex 只用于dwValue=IMC_SETCONVERSIONMODE,IMC_SETSENTENCEMODE dwValue 可取由WM_IME_CONTRO
16、L 发送的下列值: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,否则为FALSE 9、BOOL ImeSe
17、lect(/初始化输入法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
18、 ImeSetCompositionString(/将编码窗口中输入的编码保存的编码结构中,/同志发送编码完成的消息/(WM_IME_COMPOSITION)给系统,HIMC hIMC,/当前的应用程序句柄DWORD dwIndex,/设置此函数功能/=SCS_SETSTR/=SCS_CHANGEATTR 名师资料总结-精品资料欢迎下载-名师精心整理-第 5 页,共 22 页 -/=SCS_CHANGECLAUSE/=SCS_QUERYRECONVERTSTRING/=SCS_RECONVERTSTRING/=SCS_SETRECONVERTSTRING LPCVOID lpComp,/编码数
19、据区DWORD dwCompLen,/编码数据区长度LPCVOID lpRead,/读入的编码数据DWORD dwReadLen/读入的编码数据长度)11、UINT ImeToAsciiEx(/转换编码称汉字(串)UINT uVirKey,/虚键UINT uScanCode,/扫描码CONST LPBYTE lpbKeyState,/用户定义的键盘状态LPDWORD lpdwTransBuf,/转换后的数据存放区UINT fuState,/活动菜单标志HIMC hIMC/当前的应用程序句柄)返回:返回值表示有几个消息,可理解为:本编码对应的汉字串有几个汉字组成(当然,这并不相等)。12、BOO
20、L WINAPI ImeRegisterWord(LPCTSTR lpszReading,DWORD dwStyle,LPCTSTR lpszString)13、BOOL WINAPI ImeUnregisterWord(LPCTSTR lpszReading,DWORD dwStyle,LPCTSTR lpszString)14、UINT WINAPI ImeGetRegisterWordStyle(UINT nItem,LPSTYLEBUF lpStyleBuf)15、UINT WINAPI ImeEnumRegisterWord(hKL,REGISTERWORDENUMPROC lpfn
21、EnumProc,LPCTSTR lpszReading,名师资料总结-精品资料欢迎下载-名师精心整理-第 6 页,共 22 页 -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
22、VERSIONINFO 代表字符含义FILEVERSION 4,0,0,950/4.00.950 95版PRODUCTVERSION 4,0,0,950/4.00.950 95版FILEFLAGSMASK 0 x3fL FILEFLAGS 0 xaL FILEOS 0 x10004L/VOS_DOS_WINDOWS32 WIN32 软件,可在 DOS下运行FILETYPE 0 x3L/VFT_DRV 驱动程序FILESUBTYPE 0 xbL/VFT2_DRV_INPUTMETHOD 输入法驱动程序BEGIN BLOCK StringFileInfo BEGIN BLOCK 080403a8
23、BEGIN VALUE Comments,0 VALUE CompanyName,唐码软件开发工作室0 VALUE FileDes cription,唐码输入法版本 1.00 VALUE FileVersion,4.00.9500 VALUE InternalName,唐码输入法版本 1.00 VALUE LegalCopyright,Copyright(C)唐码软件开发工作室1999-19990 VALUE LegalTrademarks,0 VALUE OriginalFilename,TM.IME0 VALUE PrivateBuild,0 VALUE ProductName,唐码输入法
24、版本 1.00 VALUE ProductVersion,4.00.9500 VALUE SpecialBuild,0 名师资料总结-精品资料欢迎下载-名师精心整理-第 7 页,共 22 页 -END 第二章Windows9x 系统提供的ime 管理函数上一章,我们介绍了ime 文件中必须设计的函数,这些函数要靠我们自己来设计。要完成这些函数的设计,需用到windows 系统提供的管理函数(Input Method Manager,简称 IMM)。IMM 函数可以被IME 函数使用,也可用于应用软件直接管理IME。相关术语:(1)input method context 简称 IMC-输入法相
25、关部分,在这里解释为:相关连的应用程序(进程)(2)component of the input context 简称 IMCC-IMC 的部件,是INPUTCONTEXT 结构的成员。一、IME 中使用的IMM 函数清单ImmGetCompositionWindow/取编码窗口信息ImmSetCompositionWindow/设置编码窗口信息ImmGetCandidateWindow/取选择窗口信息ImmSetCandidateWindow/设置选择窗口信息ImmGetCompositionString/取编码窗口的某一信息ImmSetCompositionString/设置编码窗口的某一
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 2022年Windows输入法编程接口 2022 Windows 输入法 编程 接口
限制150内