📄 输入法编程指南.htm
字号:
<TBODY>
<TR>
<TD></TD></TR></TBODY></TABLE>输入法编程指南（根据msdn翻译）
<P>作者： <FONT color=#0000ff>李丽
</FONT>，如转载请保证本文档的完整性，并注明出处。<BR><FONT color=#ffffff>欢迎光临 C++
Builder
研究，http://www.ccrun.com/doc/go.asp?id=590</FONT><BR>Windows
95输入法编辑器（IME） <BR>原著：Microsoft <BR>翻译：TBsoft Software Studio
<BR>一、关于Windows 95混合语言IME <BR> 在Windows
95中，IME是一个动态链接库（DLL），与Windows
3.1远东版本IME不同的是，每一个运行的IME相当于混合语言键盘布局中的一种。与Windows 3.1
IME相比较，Windows 95混合语言IME提供下列增强功能：
<BR> ●运行时相当于混合语言环境的一个部件
<BR> ●为每一个应用程序任务提供多重输入上下文
<BR> ●为每一个应用程序线程提供一个活动的IME
<BR> ●通过应用程序消息循环给应用程序提供信息（消息顺序不能改变）
<BR> ●为无IME支持应用程序和部分IME支持应用程序提供有力的支持
<BR> 要得到全部的增强功能，应用程序需要支持Windows 95
IME应用程序I／F。 <BR> 本文档描述了Windows 95
IME体系结构的应用程序I／F。 <BR><BR>1、IME的结构
<BR> Windows 95
IME必须提供两个部件：IME转换接口和IME用户接口。IME转换接口由一组IME模块引出函数提供，这些函数被IMM（输入法管理器——译者注）调用。
<BR> IME用户接口由一组窗口提供，这些窗口接收消息并提供IME的用户界面。<BR><BR>2、IME支持应用程序（IME感知应用程序——译者注）
<BR> 应用程序有下列类型：
<BR>●无IME支持应用程序：这种应用程序不控制IME，然而，如果应用程序接受DBCS字符，用户可以通过IME在应用程序中输入DBCS字符。
<BR>●部分IME支持应用程序：这种应用程序只控制不同的IME上下文，例如打开和关闭IME、写作窗口等等，但是不重新显示任何IME用户界面。
<BR>●完全IME支持应用程序：这种应用程序负责管理通过IME显示给应用程序的任何信息。
<BR> 在Windows
95中，一个无IME支持应用程序有一个缺省的IME窗口和一个缺省的输入上下文。
<BR> 部分IME支持应用程序使用预定义的“IME”类创建自己的IME窗口，可以管理或者不管理自己的输入上下文。
<BR> 完全IME支持应用程序自己管理输入上下文，显示输入上下文给出的任何需要的信息，不使用IME窗口。<BR>二、IME用户界面
<BR> IME用户界面包括IME窗口、用户界面（UI）窗口以及UI窗口的部件。<BR><BR>1、特征
<BR> IME类是实现IME用户界面部分的预定义全局窗口类。“IME”类与预定义的公共控制窗口类有许多相同的特点，IME窗口实例与静态控制一样通过CreateWindowEx函数创建，IME类窗口自己不响应用户输入，取而代之的是接收不同类型的控制消息实现全部IME用户接口。应用程序可以使用IME类创建自己的IME窗口，还可以使用ImmGetDefaultIMEWnd函数获取缺省IME窗口。创建自己的IME窗口或者使用缺省IME窗口的应用程序被称为IME支持应用程序，具有以下优点（与对应的Windows3.1应用程序比较）：<BR><BR>●包括候选字列表窗口（候选窗口），每一个应用程序可以有自己的用户界面窗口实例，使得用户可以在任何输入过程的中途停止并切换到另一个应用程序。在Windows
3.1日文版本中，用户切换到另一个应用程序是必须放弃当前输入过程。
<BR>●因为IME用户界面窗口包括应用程序窗口句柄，IME用户界面窗口可以为应用程序提供缺省行为。例如当应用程序移动时IME用户界面窗口自动移动，自动跟随窗口中的插入符号位置，为每一个应用程序标示模式等等。
<BR> 即使系统仅仅只提供一个IME类，IME窗口仍然有两种类型。一种类型是系统为无IME支持应用程序创建的IME窗口，DefWindowProc函数为该窗口处理消息，DefWindowProc函数的IME用户接口被线程的所有无IME支持窗口共享，在文档中，这种窗口称为缺省IME窗口。另一种类型是IME支持应用程序创建的IME窗口，在文档中，IME支持应用程序创建的IME窗口称作应用程序IME窗口。
<BR><BR>2、缺省和应用程序IME窗口
<BR> 当线程初始化时系统创建缺省IME窗口，这就是说，线程自动获取缺省IME窗口。缺省IME窗口为无IME支持应用程序提供IME用户界面，当IME或者IMM生成一个IME消息（WM_IME_*）时，无IME支持应用程序传递该消息到DefWindowProc函数，DefWindowProc函数发送需要的消息到为应用程序提供缺省IME用户界面的缺省IME窗口。IME支持应用程序当不从IME获取消息时也可以使用缺省IME窗口，需要时可以使用自身的IME窗口。<BR><BR>3、IME类
<BR> IME类是Windows
95远东版本预定义的窗口类，就像Edit是预定义的窗口类一样。预定义的IME类实现全部的IME用户接口，处理所有来自IME和包含IMM函数的应用程序的消息，应用程序使用IME类创建自己的IME窗口。系统IME类不能被被任何IME替换。
<BR> 窗口过程与IME类通过WM_IME_SELECT消息交互，该消息包括新选中的IME的键盘布局，IME类使用键盘布局查找到每一个IME定义的类名。使用类名，IME类为当前活动的IME创建IME用户界面窗口。
<BR><BR>4、IME UI类
<BR> 每一个IME必须向系统注册自己的用户界面（UI）类，UI类提供IME相关功能。当IME附加在进程上时IME注册自己的UI类，这就是说，当DLLEntry函数被调用DLL_PROCESS_ATTACH功能时，IME必须在对ImeInquire函数的调用过程中指定UI类名。UI类应该使用CS_IME窗口风格注册以使得每一个应用程序都可以使用UI类。
<BR> UI类名（包括空终结符）可以使用16位的TCHAR字符，这个限制可能延续到Windows的未来版本。
<BR> 当注册一个UI类时，应该指定8个字节的窗口附加数据（这就是说，设置WNDCLASSEX类的cbWndExtra成员的值为2*sizeof(LONG)），系统使用该窗口附加数据。
<BR> IME可以在为应用程序执行任务时注册任何类和创建任何窗口。
<BR><BR> 下面的实例显示了怎样注册IME窗口类：
<BR><BR>BOOL WINAPI DLLEntry ( HINSTANCE hInstDLL, DWORD
dwFunction, LPVOID lpNot) <BR>{
<BR> switch (dwFunction)
<BR> {
<BR> case
DLL_PROCESS_ATTACH:
<BR> hInst=
hInstDLL;
<BR> wc.style =
CS_MYCLASSFLAG | CS_IME;
<BR> wc.lpfnWndProc
= MyUIServerWndProc;
<BR> wc.cbClsExtra
= 0;
<BR> wc.cbWndExtra
= 2 * sizeof(LONG);
<BR> wc.hInstance
= hInst;
<BR> wc.hCursor
= LoadCursor( NULL, IDC_ARROW);
<BR> wc.hIcon =
NULL;
<BR> wc.lpszMenuName
= (LPSTR) NULL;
<BR> wc.lpszClassName
= (LPSTR) szUIClassName;
<BR> wc.hbrBackground
= NULL;
<BR> if(!RegisterClass((LPWNDCLASS)&wc))
<BR> return
FALSE;
<BR> wc.style =
CS_MYCLASSFLAG | CS_IME;
<BR> wc.lpfnWndProc
= MyCompStringWndProc;
<BR> wc.cbClsExtra
= 0;
<BR> wc.cbWndExtra
= cbMyWndExtra;
<BR> wc.hInstance
= hInst;
<BR> wc.hCursor
= LoadCursor(NULL, IDC_ARROW);
<BR> wc.hIcon =
NULL;
<BR> wc.lpszMenuName
= (LPSTR) NULL;
<BR> wc.lpszClassName
= (LPSTR) szUICompStringClassName;
<BR> wc.hbrBackground
= NULL;
<BR> if(!RegisterClass((LPWNDCLASS)&wc))
<BR> return
FALSE;
<BR> break;
<BR> case
DLL_PROCESS_DETACH:
<BR> UnregisterClass(szUIClassName,hInst);
<BR> UnregisterClass(szUICompStringClassName,hInst);
<BR> break;
<BR> }
<BR> return TRUE; <BR>} <BR><BR>5、UI窗口
<BR> IME类对应的IME窗口被应用程序或者系统创建，当IME窗口被创建时，IME自身提供的UI窗口被创建并被IME窗口所拥有。每一个UI窗口有一个当前的输入上下文，当UI窗口接收到IME消息（WM_IME_*）时，可以通过调用GetWindowLong函数和指定IMMGWL_IMC索引值查找到输入上下文，UI窗口可以根据输入上下文处理消息，UI窗口可以在除响应WM_CREATE消息以外的任何时间查找到输入上下文。
<BR> IME不允许改变UI窗口的窗口附加数据，如果UI窗口的某个实例需要窗口附加数据，可以使用IMMGWL_PRIVATE参数值调用SetWindowLong和GetWindowLong函数，IMMGWL_PRIVATE参数值提供为UI窗口的某个实例存取附加数据中LONG类型值的能力，如果需要大于LONG类型值的附加数据，可以保存一个内存块的句柄到IMMGWL_PRIVATE域。
<BR> UI窗口过程可以使用DefWindowProc函数，但是UI窗口不允许传递IME消息给DefWindowProc函数，即使某个IME消息没有被处理，UI窗口也不允许传递该消息给DefWindowProc函数。
<BR>LRESULT UIWndProc (HWND hWnd, UINT msg, WPARAM wParam,
LPARAM lParam) <BR>{ <BR>HIMC hIMC; <BR>HGLOBAL hMyExtra;
<BR>switch(msg){ <BR>case WM_CREATE: <BR>// Allocate the
memory bloack for the window instance. <BR>hMyExtra =
GlobalAlloc(GHND,size_of_MyExtra); <BR>if (!hMyExtra)
<BR>MyError(); <BR>// Set the memory handle into
IMMGWL_PRIVATE <BR>SetWindowLong(hWnd, IMMGWL_PRIVATE,
(LONG)hMyExtra); <BR>. <BR>. <BR>. <BR>break; <BR>case
WM_IME_xxxx: <BR>// Get IMC; <BR>hIMC =
GetWindowLong(hWnd,IMMGWL_IMC); <BR>// Get the memory handle
for the window instance. <BR>hMyExtra = GetWindowLong(hWnd,
IMMGWL_PRIVATE); <BR>lpMyExtra = GlobalLock(hMyExtra); <BR>.
<BR>. <BR>. <BR>GlobalUnlock(hMyExtra); <BR>break; <BR>. <BR>.
<BR>. <BR>case WM_DESTROY: <BR>// Get the memory handle for
the window instance. <BR>hMyExtra = GetWindowLong(hWnd,
IMMGWL_PRIVATE); <BR>// Free the memory block for the window
instance. <BR>GlobalFree(hMyExtra); <BR>break; <BR>default:
<BR>return DefWindowProc(hWnd, msg, wParam, lParam); <BR>}
<BR>}
<BR> UI窗口必须在当前选定的输入上下文中执行动作，当一个窗口被激活时，UI窗口接收到提供当前输入上下文的消息，此后，UI窗口运行在当前选中的输入上下文上。输入上下文必须包括UI窗口显示写作窗口、状态窗口等需要的所有信息。
<BR> UI窗口要求输入上下文，但是窗口不必自己更新输入上下文。当UI窗口需要更新输入上下文时，应该调用IMM函数，因为输入上下文由IMM函数管理，当输入上下文更新时，IMM和IME接收到通知消息。
<BR> 例如，有时UI窗口当鼠标单击时需要改变输入上下文的转换模式，为了设置转换模式，UI窗口调用ImmSetConversionMode函数，该函数为NotifyIME生成一个通知消息并发送WM_IME_NOTIFY消息到UI窗口，如果UI窗口改变转换模式的显示，UI窗口会等待处理WM_IME_NOTIFY消息。
<BR><BR>6、UI窗口的部件
<BR> UI窗口可以根据输入上下文注册和显示写作窗口和状态窗口，UI窗口的部件类的窗口风格必须包括CS_IME。UI窗口的一个窗口实例从当前输入上下文接收例如写作字符串、字体、位置等信息，当应用程序的一个窗口获得焦点时，系统获取该窗口自己的输入上下文并将当前输入上下文传递给UI窗口，系统发送WM_IME_SETCONTEXT消息和输入上下文的句柄给应用程序，应用程序传递该消息给UI窗口。如果当前输入上下文被更新，UI窗口应该重新绘制写作窗口，无论何时输入上下文改变，UI窗口都应该显示正确的写作窗口，可以保证IME的状态。
<BR> UI窗口可以创建子窗口或者弹出式窗口显示状态、写作字符串或者候选字列表，这些窗口必须是UI窗口的附属窗口，而且必须创建为不可接收输入（Disable）窗口，任何IME创建的窗口都不应该获取焦点。
<BR><BR>三、输入上下文 <BR><BR>1、缺省输入上下文
<BR> 缺省情况下系统给每个线程一个输入上下文，该输入上下文被线程的所有无IME支持窗口共享。
<BR><BR>2、输入上下文与窗口的交互
<BR> 应用程序的一个窗口可以使用窗口句柄与输入上下文交互以维护任何IME状态，包括中间写作字符串。一旦应用程序使得输入上下文与窗口句柄交互，无论何时窗口被激活，系统自动选中输入上下文。使用这个特点，应用程序可以轻松地完成Windows
3.1下必须的复杂切换处理。 <BR><BR>3、使用输入上下文
<BR> 当应用程序或者系统创建新的输入上下文时，系统准备新的输入上下文，新的输入上下文已经包括IMCC，这个IMC的部件由hCompStr、hCandInfo、hGuideLine、hPrivate和hMsgBuf组成。IME基本上不需要创建输入上下文和输入上下文的部件，不过IME可以改变它们的大小，可以通过锁定它们查找到部件的指针。
<BR> <BR>⑴存取HIMC
<BR> 为了存取输入上下文，IME必须调用ImmLockIMC函数以查找到输入上下文的指针，ImmLockIMC函数给IMC增加imm锁定计数，ImmUnlockIMC函数减少之。<BR><BR>⑵存取HIMCC
<BR> 为了存取输入上下文中的一个部件，IME必须调用ImmLockIMCC函数获取IMCC的指针，ImmLockIMCC函数给IMCC增加imm锁定计数，ImmUnlockIMCC函数减少之，ImmReSizeIMCC函数可以修改IMCC的大小以指定新的大小。
<BR> 某些情况下，IME可能需要自己创建输入上下文的一个部件，这种情况下，IME可以调用ImmCreateIMCC函数获取IMCC的句柄，这个IMCC可以是INPUTCONTEXT结构的成员（hCompStr、hCandInfo、hGuideLine、hPrivate或者hMsgBuf）。
<BR> ImmDestroyIMCC清除输入上下文的一个部件。
<BR><BR>⑶怎样使用输入上下文
<BR> 下面的实例显示了怎样使用输入上下文
<BR>LPINPUTCONTEXT lpIMC; <BR>LPCOMOSITIONSTRING lpCompStr;
<BR>HIMCC hMyCompStr; <BR>if (hIMC) { // It is not NULL
context. <BR>lpIMC = ImmLockIMC(hIMC); <BR>if (!lpIMC) {
<BR>MyError( "Can not lock hIMC"); <BR>return FALSE; <BR>}
<BR>// Use lpIMC->hCompStr. <BR>lpCompStr =
(LPCOMPOSITIONSTRING) ImmLockIMCC(lpIMC->hCompStr); <BR>//
Access lpCompStr. <BR>ImmUnlockIMCC(lpIMC->hCompStr);
<BR>// ReSize lpIMC->hCompStr. <BR>if (!(hMyCompStr =
ImmReSizeIMCC(lpIMC->hCompStr,dwNewSize)) {
<BR>MyError("Can not resize hCompStr");
<BR>ImmUnlockIMC(hIMC); <BR>return FALSE; <BR>}
<BR>lpIMC->hCompStr = hMyCompStr; <BR>ImmUnlockIMC(hIMC);
<BR>} <BR><BR>四、生成消息
<BR> IME需要生成IME消息。当IME开始转换时，IME必须生成WM_IME_STARTCOMPOSITION消息，如果IME改变了写作字符串，IME必须生成WM_IME_COMPOSITION消息，IME引发的事件导致生成消息给与输入上下文进行交互的窗口。IME基本上使用ImeToAsciiEx函数参数提供的lpdwTransKey缓冲区生成消息，当ImeToAsciiEx函数被调用时IME存储消息到lpdwTransKey缓冲区中，不过即使ImeToAsciiEx函数没有
<BR>被调用，IME也可以生成消息给使用输入上下文的消息缓冲区与输入上下文交互的窗口。输入上下文有一个内存块的句柄作为消息缓冲区，IME存储消息到被消息缓冲区句柄提供的内存块中，以后IME调用ImmGenerateMessage函数，ImmGenerateMessage函数发送保存在消息缓冲区中的消息到适当的窗口。<BR><BR>1、在ImeToAsciiEx函数中使用消息缓冲区
<BR> 下面的实例显示了怎样通过传递缓冲区到ImeToAsciiEx函数生成消息：
<BR>UINT ImeToAsciiEx(uVirKey, uScanCode, lpbKeyState,
lpdwTransBuf, <BR>fuState , hIMC ) <BR>{ <BR>DWORD dwMyNumMsg
= 0; <BR>. <BR>. <BR>. <BR>// Set the messages that the IME
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -