微软的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页面中,我们使用图像是用下列语法:
此代码假设图像文件"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、编译运行程序。