在Win CE程序开发中使用软件输入面板

 软件输入面板(Software Input Panel,简称SIP)是每个装备了WinCE系统的移动平台的一个基本功能。它提供给用户在PDA上进行数据输入的一种手段。当谈及SIP的时候,我们一般会想到两点:一是SIP本身,二是如何在程序中使用SIP。

  SIP是一个实现了IInputMethod或者IInputMethod2接口的COM对象。它应该被系统调入使用,所以你不能在C#中进行SIP开发。C或者C++是很好的开发语言。因为SIP本身也只是另外一个COM对象,ATL使得开发过程变得极为简单。这里我不想讨论SIP开发,SDK包里包含了一个很好的例程ATLDvoraksip,所以你可以去学习这个例程以获取更多的信息。 这里我想讨论的是如何在你自己的程序里管理SIP。这看起来很琐碎简单,但是如果因为屏幕不太够用,而你又想使得你的程序更加聪明更加方便用户使用,那SIP的管理就变成很重要的一个方面了。另外,如果你开发了很多用于不同场合的SIP(比如多语言,数字或者其他等等),你可能想在某个场合使用某个特定的SIP。这种能力使得你可以完成很多不同的任务:当用户只需要进行数字输入的时候,你可以展示一个大的数字键盘,这样他不用笔而只需要用手指就可以输入了。当然你也可以有自己的想法,这就看程序员该作些什么了。

  Win32 API

  SIP的API函数很简单,从sipapi.h中只可以看到只有极少几个函数:

DWORD WINAPI SipStatus();
BOOL WINAPI SipSetDefaultRect(RECT *);
BOOL WINAPI SipRegisterNotification(HWND);
BOOL WINAPI SipShowIM(DWORD);
BOOL WINAPI SipGetInfo(SIPINFO *);
BOOL WINAPI SipSetInfo(SIPINFO *);
int WINAPI SipEnumIM(IMENUMPROC);
BOOL WINAPI SipGetCurrentIM(CLSID *);
BOOL WINAPI SipSetCurrentIM(CLSID *);

  我把这些放在开始,是因为它同时支持Windows Mobile和CE.NET平台。如果你对Windows Mobile设备编程,那么aygshell.h文件提供给你更多的和SIP有关的函数供使用。当然选择哪个来使用就依赖于你自己的需求了,使用Windows Mobile上的SIP会使得工作更加完美一些。如果你使用了相同的OS版本,但是不同的build版本的时候,你可能会获得稍微不同的SIP行为。所以,一种方法并不一定像你所想的那样在所有的PDA上都会适用。

  列举可用的SIP

  第一步就是了解如何列举所有可用的SIP。可以使用如下的代码:

CTypedPtrMap<CMapStringToPtr,CString,CLSID*> g_SipMap;
int SipEnumIMProc(IMENUMINFO *pIMInfo)
{
 CLSID* pCLSID = new CLSID;
 memcpy(pCLSID,&pIMInfo->clsid,sizeof(CLSID));
 g_SipMap.SetAt(CString(pIMInfo->szName),pCLSID);
 TRACE(_T("%sn"),CString(pIMInfo->szName));
 return 1;
}
void CSIPDemoDlg::OnButtonEnum()
{
 SipEnumIM(SipEnumIMProc);
 CString sSipName;
 CLSID *pCLSID = NULL;
 for (POSITION pos = g_SipMap.GetStartPosition(); pos; )
 {
  g_SipMap.GetNextAssoc(pos,sSipName,pCLSID);
  m_SipList.AddString(sSipName);
 }
}

 

代码所作的就是填充一个全局的map,它包含了"SIP名"/CLSID对。这个例子和其他的都用到了MFC,当然你也可以使用熟悉的Win32 API或者其他的框架

  如何选择,显示和隐藏特定的SIP

  当你知道某个SIP的CLSID,你可以选择它。同时,当前选择的SIP也可以被获得:

void CSIPDemoDlg::OnButtonEnum()
{
 SipEnumIM(SipEnumIMProc);
 CLSID CurrSip;
 SipGetCurrentIM(&CurrSip);
 int nCurrSip = LB_ERR, nSipCount = 0;
 CString sSipName, sCurrSipName;
 CLSID *pCLSID = NULL;
 for (POSITION pos = g_SipMap.GetStartPosition(); pos; )
 {
  g_SipMap.GetNextAssoc(pos,sSipName,pCLSID);
  m_SipList.AddString(sSipName);
  if ( memcmp(&CurrSip,pCLSID,sizeof(CLSID)) == 0 )
  {
   nCurrSip = nSipCount;
   sCurrSipName = sSipName;
  }
  nSipCount++;
 }
 m_SipList.SelectString(0,sCurrSipName);
}
void CSIPDemoDlg::OnButtonSelect()
{
 int nSel = m_SipList.GetCurSel();
 if ( LB_ERR == nSel )
  return;
 CString sSipName;
 m_SipList.GetText(nSel,sSipName);
 CLSID *pCLSID = NULL;
 if ( !g_SipMap.Lookup(sSipName,pCLSID) )
  return;
 BOOL bRes = SipSetCurrentIM(pCLSID);
 if ( !bRes )
  TRACE(L"SipSetCurrentIM returned %lun",GetLastError());
}
void CSIPDemoDlg::OnButtonShowHide()
{
 if ( !g_bShow )
 {
  SipShowIM(SIPF_ON);
  g_bShow = TRUE;
 }
 else
 {
  SipShowIM(SIPF_OFF);
  g_bShow = FALSE;
 }
}
void CSIPDemoDlg::OnButtonShowHide2()
{
 SIPINFO SipInfo;
 memset(&SipInfo,0,sizeof(SipInfo));
 SipInfo.cbSize=sizeof(SIPINFO);
 BOOL bRes = SipGetInfo(&SipInfo);
 if ( bRes )
 {
  if ( !g_bShow )
  {
   SipInfo.fdwFlags |= SIPF_ON;
   g_bShow = TRUE;
  }
  else
  {
   SipInfo.fdwFlags = SIPF_OFF;
   g_bShow = FALSE;
  }
  bRes = SipSetInfo(&SipInfo);
 }
 else
 {
  TRACE(L"SipGetInfo returned %lun",GetLastError());
 }
}

  这里,你可以看到修改的例子(CSIPDemoDlg::OnButtonEnum()),它检测哪个SIP是被激活的并且选择listbox里相应的行。其他例子的对话框方法选择SIP并且显示或者隐藏它。注意,为了使得SipGetInfo或者SipSetInfo工作,你必须用sizeof(SIPINFO)的值初始化SIPINFO.cbSize,这样操作系统才能正常反应。这是一个很常用的Win32的解决方式。

SipGetInfo给你可视的桌面和SIP大小,这样你可以在需要的时候重新定制SIP的位置。而SipSetInfo不会改变SIP的位置。如果你需要移动SIP,使用SipSetDefaultRect。下面会给出一些例子来说明的。

  使用Shell函数

  如果你决定使用基于aygshell的函数,SHSipPreference也会为你完成相似的任务。和SipShowIM一样,这个API将会显示和隐藏输入面板。它的最后一个参数定义了作什么,可以请求显示或隐藏输入面板,马上隐藏(因为操作系统在一个常规事例里将会为此设置一个计时器)或者放弃所有的等待中的请求。SHSipInfo允许你作和SipXXX函数一样的操作。

  通常,你可以用以上所有的API来响应WM_SETTINGCHAANGE或WM_CREATE消息。根据文档,当你使用SHSipInfo来处理WM_SETTINGCHANGE消息的时候要特别小心。这有几个原因:第一,SIP的改变可能导致shell来发送WM_SETTINGCHANGE消息,所以当你在你的处理函数里调用的时候要小心无限循环;第二,SHSipInfo将会和Device.exe以及输入面板线程相互作用,因此将会占据100ms左右的时间。这将导致WM_SETTINGCHANGE消息发送给所有运行的程序,所以系统将会因此而失去响应一段时间。将lParam值同时和WM_SETTINGCHANGE传递将会避免这样的延迟。

  当说到shell函数时,有些Windows Mobile平台上的函数会非常有用也可能会变得让你头痛。这些包括SHInputDialog,SHFullScreen或者类似的调用。另外,SHHandleWMActivate和SHHandleWMSettingChange会让你充分享受MFC程序中键盘自动弹出的乐趣,因为它们被用在合适的消息句柄的CDialog和CFrameWnd类中。如果你不想拥有缺省的行为,你可以重载OnActivate或OnSettingChange句柄。

  自定义控制

  如果你想支持一种智能化的输入框类的行为--每次进行输入时键盘自动弹出,然后当输入焦点从输入框移开后键盘隐藏,那么需要对WM_SETFOCUS和WM_KILLFOCUS进行处理。下面的代码可以帮助你:

void CSipEdit::OnSetFocus(CWnd* pOldWnd)
{
 CEdit::OnSetFocus(pOldWnd);
 SHSipPreference(m_hWnd,SIP_UP);
}
void CSipEdit::OnKillFocus(CWnd* pNewWnd)
{
 CEdit::OnKillFocus(pNewWnd);
 SHSipPreference(m_hWnd,SIP_FORCEDOWN);
}

  设定SIP位置

  下面谈谈如何移动SIP到屏幕上的某个位置。SipSetDefaultRect将会改变缺省的SIP的举行,但是它不会立即生效,除非你重新选择输入法:

void CSIPDemoDlg::OnButtonMove()
{
 SIPINFO SipInfo;
 memset(&SipInfo,0,sizeof(SipInfo));
 SipInfo.cbSize=sizeof(SIPINFO);
 BOOL bRes = SipGetInfo(&SipInfo);
 if ( bRes )
 {
  CRect rc(SipInfo.rcSipRect);
  rc.OffsetRect(0,-20);
  SipSetDefaultRect(&rc);
  CLSID clsid;
  if ( SipGetCurrentIM(&clsid) )
  {
   SipSetCurrentIM(&clsid);
  }
  SipShowIM(SIPF_ON);
 }
}

上面的代码告诉你如何在屏幕上移动SIP的位置。这在你想在屏幕低端放置一些控件的时候会非常有用。当然这样不符合微软的Pocket PC的GUI设计标准,但是有些时候你也没有其他的选择。

  如果你可以获取窗口的句柄来控制窗口的样式,比如:

long lStyle=GetWindowLong(hwndSIP,GWL_STYLE);
lStyle |= WS_CAPTION|WS_SYSMENU;
SetWindowLong(hwndSIP,GWL_STYLE,lStyle);

  • 0
    点赞
  • 0
    收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
©️2022 CSDN 皮肤主题:大白 设计师:CSDN官方博客 返回首页
评论

打赏作者

91program

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值