Windows输入法编程接口.doc

Windows输入法编程接口Windows9x系统下汉字输入法的基本原理Windows系统下汉字输入法实际上是将输入的标准ascii字符串按照一定的编码规则转换为汉字或汉字串，进入到目的地。由于应用程序各不相同，用户不可能自己去设计转换程序，因此，汉字输入自然而然落到WINDOWS系统管理中。一、输入法与系统的关系键盘事件 应用程序 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打开微软提供的拼音输入法（WINDOWSSYSTEMWINPY.IME）看看它有什么组成（这里一WINDOWS98为例，并假定windows系统安装在c:盘下）：C:Dumpbin c:windowssystemwinpy.imeMicrosoft (R) COFF Binary File Dumper Version 6.00.8168Copyright (C) Microsoft Corp 1992-1998. All rights reserved.Dump of file WINPY.IMEFile Type: DLL IME 实际为dll程序Section contains the following exports for WINPY.ime0 characteristics34A37323 time date stamp Fri Dec 26 17:04:35 19970.00 version1 ordinal base19 number of functions /共有个函数19 number of names / 对应个名称ordinal hint RVA name1 0 0000A010 CandWndProc /选择汉字窗口注册函数2 1 0000E750 CompWndProc /输入编码窗口注册函数3 2 0000FB50 ImeConfigure /配置当前ime参数函数4 3 0000FEC0 ImeConversionList/将字符或字符串转换成目标字符5 4 0000FFA0 ImeDestroy /退出当前使用的IME6 5 000030D0 ImeEnumRegisterWord7 6 0000FFB0 ImeEscape /应用软件访问输入法的接口函数.8 7 00003080 ImeGetRegisterWordStyle9 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 /用户界面接口函数Summary5000 .ShareDa7000 .data2000 .idata1000 .rdata3000 .reloc5000 .rsrc2000 .sgroup18000 .text从上述可以看出，IME程序共有个出口函数组成，每一个函数都有特定的格式，它们担负着与windows 系统传递信息的作用，这些函数是供Windows系统调用的。三、输入法的函数简介下面我们将介绍上述各个函数的功能及接口格式。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,否则为FALSE5.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,否则为FALSE7、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_SETCANDIDATEPOSIMC_SETCOMPOSITIONFONTIMC_SETCOMPOSITIONWINDOWIMC_SETCONVERSIONMODEIMC_SETSENTENCEMODEIMC_SETOPENSTATUS=NI_COMPOSITIONSTR 改变编码窗口中的编码此时：dwIndex 取下列值：CPS_COMPLETE 完成编码转换CPS_CONVERT 转换编码CPS_REVERT 取消当前的编码CPS_CANCEL 清除编码，并关闭编码窗dwValue 不用此函数成功，返回TRUE，否则为FALSE9、BOOL ImeSelect( /初始化输入法HIMC hIMC, /当前应用程序句柄BOOL fSelect /是否初始化当前输入法，TRUE表示初始化)返回：成功返回true，否则为FALSEThe 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_SETRECONVERTSTRINGLPCVOID 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 0x3fLFILEFLAGS 0xaLFILEOS 0x10004L /VOS_DOS_WINDOWS32 WIN32软件,可在DOS下运行FILETYPE 0x3L /VFT_DRV 驱动程序FILESUBTYPE 0xbL /VFT2_DRV_INPUTMETHOD 输入法驱动程序BEGINBLOCK StringFileInfoBEGINBLOCK 080403a8BEGINVALUE Comments, 0VALUE CompanyName, 唐码软件开发工作室0VALUE FileDes cription, 唐码输入法 版本1.00VALUE FileVersion, 4.00.9500VALUE InternalName, 唐码输入法 版本1.00VALUE LegalCopyright, Copyright (C) 唐码软件开发工作室 1999-19990VALUE LegalTrademarks, 0VALUE OriginalFilename, TM.IME0VALUE PrivateBuild, 0VALUE ProductName, 唐码输入法 版本1.00VALUE ProductVersion, 4.00.9500VALUE SpecialBuild, 0END第二章 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 /取选择区中编码ImmGetGuideLineImmGetConversionStatus /取当前输入法的状态（ACSII,SHAPE,FULL等）ImmGetConversionList /重新获得选择区转换表ImmGetOpenStatus /取输入法打开属性ImmSetConversionStatus /设置输入法状态ImmSetOpenStatus /设置输入法打开状态ImmNotifyIME /通报IME，输入法状态被改变ImmGenerateMessage /将我们的汉字串法发送到与当前输入法相关联的应用软件中ImmRequestMessage /向应用程序发送WM_IME_REQUESTImmLockIMC /获取当前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，否则为FALSE2、LRESULT WINAPI ImmRequestMessage( /向应用程序发送WM_IME_REQUEST/只是用于w98及w2000HIMC hIMC, /与当前输入法相关联的应用软件的句柄WPARAM wParam, /与WM_IME_REQUEST相关的wPLPARAM lParam /与WM_IME_REQUEST相关的LP/=IMR_COMPOSITIONWINOW/=IMR_CANDIDATEWINDOW/=IMR_COMPOSITIONFONT/=IMR_RECONVERTSTRING/=IMR_CONFIRMRECONVERTSTRING/=IMR_QUERYCHARPOSITION/=IMR_DOCUMENTFEED)3、LPINPUTCONTEXT WINAPI ImmLockIMC( /获取当前IMC的INPUTCONTEXT结构信息，增加IMC 计数器HIMC hIMC /当前应用程序句柄)成功返回INPUTCONTEXT 结构指针，否则为NULL4、BOOL WINAPI ImmUnlockIMC( /释放IMC计数器HIMC hIMC /当前应用程序句柄)返回:如果IMC计数器被减少到0了,返回FALSE,否则为TRUE.注意:ImmLockIMC与ImmUnlockIMC必须成对出现,必须是相同的HIMC5、HIMCC WINAPI ImmGetIMCLockCount( /取计数器值HIMC hIMC /当前应用程序句柄)如果成功返回HIMC的计数器值，否则为NULL.6、HIMCC WINAPI ImmCreateIMCC( /创建INPUTCONTEXT结构的一个成员DWORD dwSize /成员的缓冲区长度)如果成功返回IMC的成员句柄，否则为NULL7、HIMCC WINAPI ImmDestroyIMCC( /删除IMC成员缓冲区HIMCC hIMCC /被删除的IMC的成员)如果成功返回NULL，否则等于该HIMCC.8、LPVOID WINAPI ImmLockIMCC( /取IMCC缓冲地址，同时使IMCC的计数器值增加HIMCC hIMCC /IMC成员句柄)If the function is successful, the return value is the pointer for the IMC component. Otherwise, the return value is NULL.9、BOOL WINAPI ImmUnlockIMCC( /递减IMCC计数器HIMCC hIMCC /IMC成员句柄)如果IMCC的计数器值为零，则返回 FALSE，否则为TRUE.10、HIMCC WINAPI ImmReSizeIMCC( /重新设置IMC的成员的缓冲区大小HIMCC hIMCC, /IMC的成员句柄DWORD dwSize /新缓冲区大小)如果成功，返回新的HIMCC，否则为 NULL.11、DWORD WINAPI ImmGetIMCCSize( /取IMC成员的缓冲区大小HIMCC hIMCC /IMC成员句柄)返回IMC成员的缓冲区大小12、DWORD WINAPI ImmGetIMCCLockCount( /返回IMC计数器值HIMCC hIMCC /IMC成员的句柄)成功返回该IMCC的计数器值，否则为013、BOOL WINAPI ImmGetHotKey( /取输入法状态键，该函数供控制面板使用DWORD dwHotKeyID,LPUINT lpuModifiers,LPUINT lpuVKey,LPHKL lphKL)14、BOOL WINAPI ImmSetHotKey( /设置输入法的热键DWORD dwHotKeyID,UINT uModifiers,UINT uVKey,hKL hKL)15、HWND WINAPI ImmCreateSoftKeyboard( /产生一个软键盘UINT uType, /软件盘上的键码含义的定义方式/=SOFTKEYBOARD_TYPE_T1/=SOFTKEYBOARD_TYPE_C1UINT hOwner, /该输入法的UI窗口int x, /定位坐标int y /定位坐标)成功返回软键盘的窗口句柄16、BOOL WINAPI ImmDestroySoftKeyboard( /销毁软键盘HWND hSoftKbdWnd /软年盘窗口句柄)成功为TRUE,法哦则为FALSE.17、BOOL WINAPI ImmShowSoftKeyboard( /显示或隐藏软键盘HWND hSoftKbdWnd, /软年盘窗口句柄int nCmdShow /窗口状态=SW_HIDE 表示隐藏，=SW_SHOWNOACTIVATE表示显示)如构成功返回 TRUE. 否则为 FALSE.第三章 ime文件中必须使用的结构前二章我们讲述了ime和imm函数,二者之间是靠下列结构通讯的。1、IMEINFOstruct tagIMEInfo /输入法的接口信息 用于ImeInquire函数中DWORD dwPrivateDataSize;/用户设计的数据结构的字节数DWORD fdwProperty; /输入法对键盘事件的相应特性/其中其高字可为下列字节位的组合：/=IME_PROP_AT_CARET 转换窗口是否放置在需插入字符的位置/=IME_PROP_SPECIAL_UI 该输入法具有特殊用户接口/=IME_PROP_CANDLIST_START_FROM_1 输入法的选择窗口中汉字串的起始序号为1/=IME_PROP_UNICODE 支持UNICODE字符/其中其低字可为下列字节位的组合：/=IME_PROP_END_UNLOAD/=IME_PROP_KBD_CHAR_FIRST 首先由键盘转换字符/=IME_PORP_NEED_ALTKEY 将ALT键盘事件传送到IME输入法内/=IME_PROP_IGNORE_UPKEYS 禁止上位键事件进入输入法内/=IME_PROP_COMPLETE_ON_UNSELECT 当关闭输入法时，完成编码的转换/ 用于 W98及2000 中DWORD fdwConversionCaps;/当前输入法具有的功能特性,如有软键、标点、中西文切换等功能/=IME_CMODE_NATIVE 设置活动模式/=IME_CMODE_FULLSHAPE 设置全角模式/=IME_CMODE_CHARCODE 设置为字符模式/=IME_CMODE_SOFTKBD /设置软键盘模式/=IME_CMODE_NOCONVERSION /不支持模式变换/=IME_CMODE_EUDC /=IME_CMODE_SYMBOL /设置标点字符模式DWORD fdwSentenceCaps; /=IME_SMODE_PLAURALCLAUSE/=IME_SMODE_SINGLECONVERT/=IME_SMODE_AUTOMETIC/=IME_SMODE_CONVERSATIONDWORD fdwUICaps; / 用户界面能力：支持软键盘等/=UI_CAP_2700/=UI_CAP_ROT90/=UI_CAP_ROTANY/=UI_CAP_SOFKBDDWORD fdwSCSCaps; / 用户设置编码串的能力/=SCS_CAP_COMPSTR/=SCS_CAP_MAKEREADDWORD fdwSelectCaps; / 输入法切换时是否使用以前输入法的模式/=SELECT_CAP_CONVMODE/=SELECT_CAP_SENTENCE IIMEINFO;2、COMPOSITIONSTR 用于编码管理typedef struct tagCOMPOSITIONSTR /用于存放编码信息的信息:所有的实际信息放在本结构的后面DWORD dwSize; /当前编码信息需要的存储空间=读入的编码+属性+子串+属性+编码+属性+结果+属性DWORD dwCompReadAttrLen; /读入的编码属性长度DWORD dwCompReadAttrOffset; /存放在内存的位置DWORD dwCompReadClsLen; /读入的子串长度DWORD dwCompReadClsOffset; /存放在内存的位置DWORD dwCompReadStrLen; /读入的编码长度DWORD dwCompReadStrOffset; /存放在内存的位置DWORD dwCompAttrLen; /编码属性长度DWORD dwCompAttrOffset; /存放在内存的位置DWORD dwCompClsLen; /编码子串长度DWORD dwCompClsOffset; /存放在内存的位置DWORD dwCompStrLen; /编码串长度DWORD dwCompStrOffset; /存放在内存的位置DWORD dwCursorPos; /当前光标位置DWORD dwDeltaStart; /被修改编码的位置DWORD dwResultReadClsLen; /读入结果子串长度DWORD dwResultReadClsOffset; /存放在内存的位置DWORD dwResultReadStrLen; /读入的编码长度DWORD dwResultReadStrOffset; /存放在内存的位置DWORD dwResultClsLen; /结果子串长度DWORD dwResultClsOffset; /存放在内存的位置DWORD dwResultStrLen; /结果串长度DWORD dwResultStrOffset; /存放在内存的位置DWORD dwPrivateSize; /用户自定义数据长度DWORD dwPrivateOffset; /存放在内存的位置 COMPOSITIONSTR;3、CANDIDATEINFO 用于编码选择管理typedef struct tagCANDIDATEINFO /编码选择信息的信息，其后为实际编码列表数据DWORD dwSize; /数据所占内存大小DWORD dwCount; /表马列表个数DWORD dwOffset32; /各个编码列表的内存位置DWORD dwPrivateSize; /自定义数据尺寸DWORD dwPrivateOffset; /缓冲区位置 CANDIDATEINFO;4、GUIDELINEtypedef struct tagGUIDELINE DWORD dwSize;DWORD dwLevel; / the error level./ GL_LEVEL_NOGUIDELINE,/ GL_LEVEL_FATAL,/ GL_LEVEL_ERROR,/ GL_LEVEL_WARNNING,/ GL_LEVEL_INFORMATIONDWORD dwIndex; / GL_ID_NODICTIONARY and so on.DWORD dwStrLen; / Error Strings, if this is 0, there/ is no error string.DWORD dwStrOffset;DWORD dwPrivateSize;DWORD dwPrivateOffset; GUIDELINE;5、CANDIDATELISTThe CANDIDATELIST structure contains information about a candidate list.typedef struct tagCANDIDATELIST /编码选择列表信息 =管理编码窗口中的列表信息DWORD dwSize; / 用字节表示的内存大小：=sizeof(CANDIDATELIST)+选择字符数据DWORD dwStyle; / 列表串的取值方式/=IME_CAND_UNKNOWN 列表数据的格式无定义/=IME_CAND_READ 读到什么数据即为什么数据,一般我们使用该属性/=IME_CAND_CODE 如果dwCount=1，dwOffset不是地址，而是实际数据，/ 1 dwOffset 表示地址/=IME_CAND_MEANING/=IME_CAND_RADICAL/=IME_CAND_STROKESDWORD dwCount; / 当前列表个数DWORD dwSelection; / 当前选择的列表序号DWORD dwPageStart; / 在列表窗口中所显示的列表的起始序号（上下翻页时用）DWORD dwPageSize; / 一页显示的列表个数DWORD dwOffset; / 列表数据存放区地址：阿;大。 CANDIDATELIST;6、COMPOSITIONFORMtypedef tagCOMPOSITIONFORM /窗口位置、大小信息：/由IMC_SETCOMPOSITIONWINDOW和IMC_SETCANDIDATEPOS消息使用DWORD dwStyle; /管理窗口方式/=CFS_DEFAULT 将编码窗口显示到隐含的位置/=CFS_FORCE_POSITION / 以给定的坐标显示窗口，不受IME控制/=CFS_POINT / 以给定的坐标显示窗口，受IME控制/=CFS_RECT /以给定的大小显示窗口POINT ptCurrentPos; /给定坐标RECT rcArea; /给定窗口的小COMPOSITIONFORM;7、CANDIDATEFORMThe CANDIDATEFORM structure is used for IMC_GETCANDIDATEPOS and IMC_SETCANDIDATEPOS messages.typedef tagCANDIDATEFORM /列表窗口信息/由IMC_GETCANDIDATEPOS和IMC_SETCANDIDATEPOS消息处理DWORD dwIndex; /列表窗口序号DWORD dwStyle; /属性：/=CFS_CANDIDATEPOS 指定显示位置/=CFS_EXCLUDE 不可显示/=CFS_DEFAULT 根据需要显示POINT ptCurrentPos; /坐标位置REC rcArea; /不可显示区 CANDIDATEFORM;8、STYLEBUFtypedef struct tagSTYLEBUF /注册字结构DWORD dwStyle;TCHAR szDes cription32 STYLEBUF;9、SOFTKBDDATAtypedef struct tagSOFTKBDDATA /软键盘中各键对应的汉字UINT uCount; /键码数组个数（可以为1，2，当区分SHIFT键时为2，即：一组带SHIFT，一组不带SHIFT）WORD wCode256 /对应的键码数据 SOFTKBDDATA;10、RECONVERTSTRINGtypedef struct _tagRECONVERTSTRING /用于W98和2000DWOPD dwSize;DWORD dwVersion;DWORD dwStrLen;DWORD dwStrOffset;DWORD dwCompStrLen;DWORD dwCompStrOffset;DWORD dwTargetStrLen;DWORD dwTargetStrOffset; RECONVERTSTRING;11、IMEMENUITEMINFOtypedef _tagIMEMENUITEMINFO /输入法菜单结构，W98/2000UINT cbSize;UINT fType;UINT fState;UINT wID;HBITMAP hbmpChecked;HBITMAP hbmpUnchecked;DWORD dwItemData;TCHAR szString48;HBITMAP hbmpItem;12、INPUTCONTEXTThe INPUTCONTEXT structure is an internal data structure that stores Input Context data.typedef struct tagINPUTCONTEXT /IMC 数据存放区HWND hWnd; /使用该IMC的窗口BOOL fOpen; /IME的打开与关闭状态POINT ptStatusWndPos; /状态窗口的位置POINT ptSoftKbdPos; /软键盘的位置DWORD fdwConversion; /IME状态(活动、不活动，全角等）DWORD fdwSentence; /编码方式union LOGFONTA A;LOGFONTW W; lfFont; /字体COMPOSITIONFORM cfCompForm; /编码格式结构CANDIDATEFORM cfCandForm4; /列表选择结构HIMCC hCompStr; /HIMCC hCandInfo;HIMCC hGuideLineHIMCC hPrivate;DWORD dwNumMsgBuf; /存放在hMsgBuf中的消息数HIMCC hMsgBuf; /存放的消息，格式： 消息1 wParam1 lParam1 消息 wParam2 lParam2./注意:我们输入的汉字串存放在这里DWORD fdwInit /系统根据此值来初始本结构相应的信息/=INIT_STATUSWNDPOS 初始化ptStatusWndPos/=INIT_CONVERSION 初始化fdwConversion/=INIT_SENTENCE 初始化fdwSentence/=INIT_LOGFONT 初始化lfFont/=INIT_COMPFORM 初始化cfCompForm/=INIT_SOFTKBDPOS 初始化ptSoftKbdPosDWORD dwReserve3; /将来版本扩展的信息 INPUTCONTEXT;在UI窗口下需要处理下列windows消息.1、WM_IME_SETCONTEXT激活或休眠输入法LRESULT CALLBACK UIWndProc(HWND hUIWnd,UINT uMsg,WPARAM wParam,LPARAM lParam)：case WM_IME_SETCONTEXT:fSet= (BOOL) wParam;lISCBits = lParam;如果fSet为TRUE,系统将激活当前输入法的某个窗口(状态窗、列表窗等），为FALSE时休眠当前输入法.其中lISCBits中指出对哪个窗口操作。数值 含义ISC_SHOWUICOMPOSITIONWINDOW 显示编码窗口ISC_SHOWUIGUIDWINDOW 显示信息窗口ISC_SHOWUICANDIDATEWINDOW 显示0号列表窗口(ISC_SHOWUICANDIDATEWINDOW 1) 显示1号列表窗口.(ISC_SHOWUICANDIDATEWINDOW 2) 显示2号列表窗口.(ISC_SHOWUICANDIDATEWINDOW 3) 显示3号列表窗口.2、WM_IME_CONTROL管理当前输入法wSubMessage= wParam; 受WM_IME_CONTROL 控制的消息lpData = (LPVOID) lParam; 对应的数据其中子消息有下列消