在MFC应用中深入定制WebBrowser控件(转)

80酷酷网    80kuku.com

  web|webbrowser控件正如VC ++ 6.0的演示程序MFCIE所示,用应用程序向导创建一个具有Web导航能力的MFC应用可谓轻而易举。本文在此基础上,进一步讨论两个问题:资源自包含的实现,上下文菜单以及快捷键的完全控制。
一、资源自包含及res协议

   所谓的资源自包含,指的是在最终产品中HTML文档(包括相关资源如脚本、图片)成为执行文件的一部分,就象其它资源(如应用程序图标)一样,而不是以独立文件形式分发。

   资源自包含不仅使产品分发更为方便,而且在最终用户面前隐藏了更多的实现细节,具有一定的现实意义。

   MFC类CHtmlView不仅把WebBrowser控件的所有功能(如导航,用户接口配置等)重新整理成为C++方法和MFC事件映射,还提供了许多“原创”的功能。其中之一便是从包含它的应用程序中读取Web页面的能力。完成这个任务的主要方法为CHtmlView::LoadFromResource(),其原型如下:

 BOOL LoadFromResource( LPCTSTR lpszResource ); //用字符串指定资源ID
 BOOL LoadFromResource( UINT nRes ); //用数字指定资源ID
   LoadFromResource()依赖于res://协议(IE在找不到URL指定的服务器时,所显示的错误提示页面即使用res协议引出。)res协议的URL和常见的http或ftp协议所用URL格式不同,它的完整语法为:

 res://resource_file[/resource_type]/resource_id
   其中resource_file为包含目标资源的执行文件名字。resource_type为资源类型,它可能用数字表示,也可能用字符串表示。当资源为定制或不直接支持类型时用字符串指出资源类型(如GIF,JPEG等,可在.RC文件中定义);当资源为已知类型时该值往往用数字表示(如位图为2,HTML为23)。已知资源类型的完整列表可以参见winuser.h,它是一组RT_常量。

   CHtmlView::LoadFromResource()总是假定目标资源所在的执行文件为当前模块。但在实际应用中,我们往往要把资源分类放在不同文件中。为解决此问题,可以定义一个派生类CHtmlViewEx覆盖此方法,只需要对原方法略作修改引入模块参数即可:

 『清单1』
 BOOL CHtmlViewEx::LoadFromResource(LPCTSTR lpszModule, LPCTSTR lpszResource)
 {
   CString strResourceURL;
   strResourceURL.Format(_T("res://%s/%s"), lpszModule, lpszResource);
   Navigate(strResourceURL, 0, 0, 0);
   return TRUE;
 }
   二、上下文菜单和快捷键控制

   在实际应用中,为了避免用户查看页面源文件或防止用户用快捷键打开当前页面的另外一个窗口,我们往往要对由WebBrowser控件提供的上下文菜单(在页面上按鼠标右键)或快捷键(如Ctrl+N打开新窗口)加以定制。

   无论是WebBrowser控件还是CHtmlView类都没有直接提供定制上述操作的方法,因而必须通过实现IDocHostUIHandler接口来完成。在该接口中,可以实现上下文菜单和快捷键控制的方法分别为ShowContextMenu()和TranslateAccelerator()。

   由于使用MFC封装类CHtmlView比直接应用WebBrowser控件更为方便,因而可以考虑把定制之后的接口支持功能集成到MFC框架内。具体实现的基本思路如下:

创建一个新的OLE客户站并在其中实现接口IDocUIHandler
在InitInstance()中用一个新的管理类取代缺省配置以引入该客户站
   基于以上思路,我们可以从COleControlSite创建派生类CCustomWebBrowserSite,并在派生类中实现IDocHostUIHandler。COleControlSite在VC++的mfcsrcoccimpl.h中定义,用于封装控件客户站。新的客户站定义为:

 『清单2』
 class CCustomWebBrowserSite : public COleControlSite
 {
 public:
   CCustomWebBrowserSite(COleControlContainer *pCnt):   
      COleControlSite(pCnt){}
 protected:
 DECLARE_INTERFACE_MAP();
 BEGIN_INTERFACE_PART(DocHostUIHandler, IDocHostUIHandler)
   STDMETHODIMP ShowContextMenu(DWORD, POINT*, IUnknown*, IDispatch*);
   STDMETHODIMP TranslateAccelerator(LPMSG, const GUID*, DWORD);
   STDMETHODIMP GetHostInfo(DOCHOSTUIINFO);
   STDMETHODIMP EnableModeless(BOOL);
   STDMETHODIMP OnDocWindowActivate(BOOL);
   STDMETHODIMP OnFrameWindowActivate(BOOL);
   STDMETHODIMP ResizeBorder(LPCRECT, IOleInPlaceUIWindow*, BOOL);
   STDMETHODIMP GetOptionKeyPath(LPOLESTR*, DWORD);
   STDMETHODIMP GetDropTarget(IDropTarget*, IDropTarget**);
   STDMETHODIMP GetExternal(IDispatch**);
   STDMETHODIMP TranslateUrl(DWORD, OLECHAR*, OLECHAR**);
   STDMETHODIMP FilterDataObject(IDataObject*, IDataObject**);
   STDMETHODIMP ShowUI(DWORD, IOleInPlaceActiveObject*,
       IOleCommandTarget*, IOleInPlaceFrame*, IOleInPlaceUIWindow*);
   STDMETHODIMP HideUI(void);
   STDMETHODIMP UpdateUI(void);
 END_INTERFACE_PART(DocHostUIHandler)
 };
   如上所介绍,在这个接口中我们感兴趣的方法主要有ShowContextMenu()和TranslateAccelerator()两个。以完全禁止上下文菜单显示为例,在派生类CCustomWebBrowserSite中ShowContextMenu()的实现代码为:

 『清单3』
 STDMETHODIMP CCustomWebBrowserSite::XDocHostUIHandler::ShowContextMenu(
     DWORD, POINT*, IUnknown*, IDispatch*)
 {
     METHOD_PROLOGUE(CCustomWebBrowserSite, DocHostUIHandler)
      return S_OK; // 禁止菜单显示
 }
   用类似的方法可以关闭由控件直接响应的快捷键:

 『清单4』
 STDMETHODIMP CustomWebBrowserSite::XDocHostUIHandler::TranslateAccelerator(LPMSG lpMsg,const GUID __RPC_FAR *pguidCmdGroup, DWORD nCmdID)
 {
     METHOD_PROLOGUE(CCustomWebBrowserSite, DocHostUIHandler)
         return S_OK;  // 关闭快捷键
 }
   在IDocHostUIHandler接口实现之后,我们还需要一个管理类CCustomOccManager来支持CCustomWebBrowserSite,新的管理类CCustomOccManager从COccManager派生,COccManager也在mfcsrcoccimpl.h中定义:

 『清单5』
 class CCustomOccManager : public COccManager
 {
 public:
   CCustomOccManager() {}
   COleControlSite* CreateSite(COleControlContainer* pCC)
 

分享到
  • 微信分享
  • 新浪微博
  • QQ好友
  • QQ空间
点击: