现在的位置: 首页 > 综合 > 正文

(转)Mobile 输入法接口简介

2017年12月07日 ⁄ 综合 ⁄ 共 3599字 ⁄ 字号 评论关闭

1. 概述

        Windows Mobile中的软输入面板(SIP)是一种用来支持用户自定义输入的机制。默认情况下,它主要包括标准键盘、块识别器和字母识别器。SIP作为一种 COM对象,通过IInputMethod接口来实现自定义输入。但由于其特殊性,不能像普通应用程序一样进行调试,所以在编写过程中有点复杂。

        为了代码层次分明,这里我对Mobile输入法的三个主要类:CClassFactory,CInputMethod和CIMWnd分别进行分析说明。前面两个类分别继承于IClassFactory和IInputMethod,是能让系统正常调用输入法所必须的com接口;而CIMWnd则是输入法的窗口,和普通的应用程序无异。

        这三个类的关系是CClassFactory通过自身的CreateInstance()函数来创建一个CInputMethod类的对象,然后CInputMethod类中会调用CIMWnd类来显示一个输入法窗口。下面我已图片的方式列出三者关系:

Mobile 输入法要用到的相关API如下:

Shell Reference
IInputMethod Interface
ATL
COM
Sequence of Events
2. 详细介绍

先来看看CClassFactory类的声明:

class CClassFactory : public IClassFactory
{
public:

// Ctor, Dtor
CClassFactory(REFCLSID rclsid);
virtual ~CClassFactory();

// IUnknown methods
STDMETHOD(QueryInterface) (REFIID riid, LPVOID FAR* ppvObj);
STDMETHOD_(ULONG,AddRef) (VOID);
STDMETHOD_(ULONG,Release) (VOID);

// IClassFactory methods
STDMETHOD(CreateInstance) (IUnknown FAR* pUnkOuter, REFIID riid,LPVOID FAR *ppunkObject);
STDMETHOD(LockServer) (BOOL fLock);

protected:

ULONG m_cRef;
CLSID m_clsid;
};

IUnknown标准接口:

QueryInterface:该函数用来查看对象支持哪种方法,这也是COM接口最先调用的函数。
AddRef:增加一次对象调用计数。
Release:减少一次对象调用计数。

IClassFactory特有的接口:

CreateInstance:系统调用该函数去创建另一个所需的实例。本文的例子中,这个函数体内创建了一个CInputMethod类的对象。
LockServer:用来标识该DLL是否被卸载。本文中,只有检测到m_plDllCnt变量为0值,也就是说该DLL已经没有被引用,此时管理器才会卸载该DLL。

下面让我们再来看看CInputMethod类:

BEGIN_INTERFACE_PART(CInputMethod, IInputMethod)

public:
// Ctor, Dtor
CInputMethod( IUnknown *pUnkOuter, HINSTANCE hInstance );
~CInputMethod();

// IInputMethod methods
STDMETHOD(Select) (HWND hwndSip);
STDMETHOD(Deselect) (void);
STDMETHOD(Showing) (void);
STDMETHOD(Hiding) (void);
STDMETHOD(GetInfo) (IMINFO *pimi);
STDMETHOD(ReceiveSipInfo) (SIPINFO *psi);
STDMETHOD(RegisterCallback) (IIMCallback *pIMCallback);
STDMETHOD(GetImData) (DWORD dwSize, void *pvImData);
STDMETHOD(SetImData) (DWORD dwSize, void *pvImData);
STDMETHOD(UserOptionsDlg) (HWND hwndParent);

private:
int m_cRef;
LPUNKNOWN m_pUnkOuter;

END_INTERFACE_PART(CInputMethod)

CInputMethod的IUnknown标准接口的作用和CClassFactory相同。

IInputMethod特有接口:

SetImData:应用程序可以通过该接口来获取输入法(IM)的信息。
GetImData:传递特定的信息给输入法。
RegisterCallback:SIP提供给输入法的回调函数接口。通过该回调函数接口,输入法可以给调用输入法的应用程序发送字符或键盘信息等等。这个是比较重要的一个函数,输入法就是通过该函数传递过来的接口函数来建立和外部的联系。
ReceiveSipInfo:SIP通过该接口传递消息给输入法。
GetInfo:SIP通过该接口来获取输入法的信息。
Hiding:隐藏输入法。
Showing:显示输入法。
Deselect:输入法即将从内存中卸载的时候将调用该接口。
Select:输入法装载到内存之前调用该接口。最明显的用户感受是在输入法管理器中选择某种输入法时,该接口即被调用。
UserOptionsDlg:控制面板通过该接口用来设置输入法的属性。

下面对输入法中用到的全局函数作一简单介绍:
static void WINAPI IM_DrawArea( HDC hdc, RECT *prcUpdate ): 用来绘制输入键盘区域

__inline static KEYENTRY* WINAPI IM_GetKeyFromCoord( RECT *prcKey ): 根据用户点击位置计算哪个键被击中,填充该键后返回键码

__inline static LRESULT WINAPI IM_OnMouseEvent( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam ): 处理用户的鼠标信息

static BOOL WINAPI IM_PressKey( BOOL fPress, KEYENTRY *pKey, RECT *prcKey ): 根据标志符fPress按下按键或弹起该键。fPress为ture则按下该键,反之则弹起该键

__inline static void WINAPI IM_SetDownKeys( void ): 在开始时初始化所有按键为未按下状态,同时在用户切换到其它输入法之前确保其所有按钮为未按下状态且撤销大写状态

static void WINAPI IM_SwitchBitmap( void ): 刷新整个键盘位图

LRESULT WINAPI ImWndProc( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam ): 主程序窗口过程

下面介绍下输入法dll部分:
extern “C” BOOL WINAPI DllMain(HANDLE hInstance, DWORD dwReason, LPVOID): DLL模块进入口

STDAPI DllCanUnloadNow(void): 判定DLL是否可以被OLE卸载

STDAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID* ppv): 返回一类工厂用来创建指定的对象

HRESULT RegisterAClsid(LPTSTR pszClsid): 添加所有用来生成CLSID所需的注册实体到一个SIP

STDAPI DllRegisterServer(void): 添加所有实体注册到系统

STDAPI DllUnregisterServer(void): 撤销所有在系统的注册实体

        输入法界面窗口和普通的应用程序的窗口没有什么不同,唯一最大的差异就是输入法窗口不能也不应该发送PostQuiteMessage,否则将导致输入法管理器的退出。至于接口的具体实现牵涉到一大堆代码,在这就不一一列出来了。

 

在SDK的ATL例子里面有一个Dvoraksip例子是实现一个输入方法的。在?:/Program Files/Windows CE Tools/wce500/Windows Mobile 5.0 Pocket PC SDK/Samples/CPP/ATL下

在Windows Mobile 5.0 for Smartphone里面有,在SDK的安装目录下,名称Phoneime

出处:http://blog.csdn.net/qinlicang/archive/2009/02/07/3867673.aspx

抱歉!评论已关闭.