在对话框中实现CHtmlView

Posted on 2006-08-03 09:45 kytte 阅读(844) 评论(0)  编辑 收藏 引用
微软的MFC在Visual Studio 6.0中提供了一个新类CHtmlView,利用这个类,我们可以实现在基于文档视图结构的程序中显示HTML文件。 但是它是否可以用来在对话框中实现这一功能呢?我们不妨拿CHtmlView和CListView做一个比较,通过比较这两个类,我们会发现一些有趣的差别,MFC中CListView有一个对应的CListCtrl类用来在对话框中使用,而CHtmlView却没有一个CHtmlCtrl类与之对应。所以为了实现在对话框的控制中显示HTML文件,我们不得不为CHtmlView创建一个对应的子类CHtmlCtrl。为了演示该类的使用方法,本实例在程序的About对话框中显示一个名为"about.htm"的HTML文件。更有趣的是,程序所用到的HTML源文件是作为资源存储在EXE文件中的。该程序编译运行后的效果如图一所示:


图一、显示HTML文件的对话框  

  一、实现方法

  为了在对话框中显示HTML文件,我们必须将CHtmlCtrl类与对话框中的一个静态控制(也可以是其它控制)关联起来,这样才能为显示HTML文件提供一个窗口,为此我们在CHtmlCtrl类中定义了CreateFromStatic()函数,具体代码如下: 

BOOL CHtmlCtrl::CreateFromStatic(UINT nID, CWnd* pParent)
{
 CStatic wndStatic; //静态控件对象;
 if (!wndStatic.SubclassDlgItem(nID, pParent)) 
  return FALSE; 
 // 获取静态控制的矩形区域并转换为父窗口的客户区坐标 
 CRect rc; 
 wndStatic.GetWindowRect(&rc); 
 pParent->ScreenToClient(&rc); 
 wndStatic.DestroyWindow();
 // 创建 HTML 控制 (CHtmlView) 
 return (Create(NULL, // 类名;
  NULL, // 标题;
  (WS_CHILD | WS_VISIBLE ), // 风格; 
  rc, // 矩形区域; 
  pParent, // 父窗口; 
  nID, // 控制的ID号;
  NULL)); //取消文档框架支持;


  为了避免主控程序将CHtmlView对象看作是文档/视图框架,需要重载CView::OnMouseActivate()和CView::OnDestroy()函数。此外,当用户在控制中单击时,OnMouseActivate要负责响应(WM_MOUSEACTIVATE)。

int CHtmlCtrl::OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT msg)

 //旁路 CView 文档/框架 
 return CWnd::OnMouseActivate(pDesktopWnd, nHitTest, msg);
}

void CHtmlCtrl::OnDestroy()

 if (m_pBrowserApp) 
 {
  m_pBrowserApp->Release();
  m_pBrowserApp = NULL; 
 } 
 CWnd::OnDestroy(); // 旁路 CView 文档/框架


  通常,CHtmlView是在virtual void PostNcDestroy()中释放空间,但对话框中的控制常常是作为堆栈对象实现的,所以,在PostNcDestroy()中不必在做什么。

  为了播放资源中的HTML文件,需要重载导航处理器OnBeforeNavigate2(), 实现"app:" 伪协议,。传递"app:"链接到一个虚拟协议处理器。因为app:是假协议,所以需要设置pbCancel参数为"TRUE",以停止掉这个导航。

void CHtmlCtrl::OnBeforeNavigate2( LPCTSTR lpszURL,
DWORD nFlags, 
LPCTSTR lpszTargetFrameName, 
CByteArray& baPostedData, 
LPCTSTR lpszHeaders, 
BOOL* pbCancel )
{
 const char APP_PROTOCOL[] = "app:"; 
 int len = _tcslen(APP_PROTOCOL); 
 if (_tcsnicmp(lpszURL, APP_PROTOCOL, len)==0) 
 { 
  OnAppCmd(lpszURL + len); 
  *pbCancel = TRUE; 
 }
}  

  定义一个虚函数OnAppCmd(),处理app:命令,例如当浏览器准备导航到"app:foo"时,这个函数被调用,参数lpszWhere的值为"foo"。

void CHtmlCtrl::OnAppCmd(LPCTSTR lpszWhere){ // default: do nothing} 

  对于作为资源的HTML文件和其中的嵌入的图片和音乐文件,用文件的实际名字作为资源名很重要,以便浏览器能够找到他们。在一个普通的Web页面中,我们使用图像是用下列语法:
<IMG src="pd.jpg"> 

  此代码假设图像文件"pd.jpg"存在当前目录(页面文件所在目录)中。如果图像文件是作为资源存在EXE文件中,我们如何引用呢?方法一样,此时,我们必须告诉浏览器Web页面文件的位置。为此要在Web页面文件的开头加上如下代码:

<BASE url="res://ShowHtml.exe/about.htm"> 

  这一行代码告诉浏览器当前目录是"res://ShowHtml.exe",当浏览器遇到代码<IMG src="pd.jpg">时,它会按照路径res://ShowHtml.exe/pd.jpg查找。否则,它会在程序文件的路径查找。通常用res://modulename可以访问动态库或可执行文件中的资源。这里res:的意思与http:,ftp:,file:,及mailto的意思相同。即:"在这个路径中的第一个名字是一个文件名,第二个名字是文件中的资源名"。其余的工作由浏览器完成。

  为了在对话框中加载web页面,调用CHtmlCtrl::LoadFromResource函数,它是由CHtmlView继承而来的。也可以用全路径res://ShowHtml.exe/about.htm作为参数。除此之外,还有一个问题就是:CAboutDialog对话框中"OK"按钮的处理,其实,它根本就不是一个按钮,而是一个在HTML文件中嵌入的图像,用JScript来控制图像被按下时和弹起时的状态。处理"OK"按钮的技巧主要是解决对话框与主控程序之间的通讯。利用动态HTML文档层(COM)技术可以处理用户单击图像或链接,方法是获得图像元素,然后侦听OnClick事件。但这是一种非常非常麻烦的方法。还有一种更简单的方法。假设HTML有如下的图像链接:

<A href="ok"><IMG ...></A>  

  当用户单击它时,浏览器显示这个"OK"文件,但是在显示之前,控制先执行CHtmlView::OnBeforeNavigate2()函数,为此可以定义CHtmlCtrl类的子类CMyHtmlCtrl,重载这个函数,在这里面实现想做的任何事情。下面的代码实现了当用户点击HTML文件上的"OK"图片时,关闭对话框。

void CHtmlCtrl::OnBeforeNavigate2(
 LPCTSTR lpszURL,
 ...,
 BOOL* pbCancel) 
{
 if (_tcscmp(lpszURL,_T("ok"))==0) 
 { 
  // "ok" clicked:
  *pbCancel=TRUE; // abort 
  GetParent()->SendMessage(WM_COMMAND,IDOK); // will close dialog 
 }


  其实"OK"并不是什么文件;它只是一个很特殊的名字,可以定义一个CHtmlCtrl类的子类CMyHtmlCtrl,该类将"OK"图片看作是"OK"按钮。为了实现这个想法,程序中创建了一个叫app:的冒充协议来代替"OK",在about.htm中定义实际的链接是app:ok。每当浏览器导航到app:somewhere的时候,CMyHtmlCtrl都以"somewhere"为参数调用一个虚函数:CMyHtmlCtrl::OnAppCmd。

void CMyHtmlCtrl::OnAppCmd( LPCTSTR lpszWhere )
{
 if (_tcsicmp(lpszWhere, _T("ok"))==0) 
 {
  GetParent()->SendMessage(WM_COMMAND,IDOK);
 } 


  二、编程步骤

  1、启动Visual C++6.0,生成一个单文档的应用程序,命名为"ShowHtml";

  2、修改程序中的"About"对话框资源,在其中放置一个Static控件,设置它的ID为IDC_HTMLVIEW;

  3、向程序中添加HTML文件资源,其ID设置为"About.htm";

  4、向程序中添加CHtmlCtrl、CMyHtmlCtrl类文件;

  5、在CAbout类中增加一个CMyHtmlCtrl类的对象m_page,并使用CLASSWIZARD重载CAbout类的OnInitDialog()函数;

  6、编译运行程序。

只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理