CListView, CListCtrl, CListBox


1. http://forum.eviloctal.com/simple/index.php?t18780.html
微软的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、编译运行程序。

三、程序代码

////////////////////////////////////////////////////CHtmlCtrl类的头文件;
#include "afxhtml.h"
class CHtmlCtrl : public CHtmlView {
 public:
  CHtmlCtrl() { }
  ~CHtmlCtrl() { }
  //使CHtmlCtrl控件与静态控件建立关联;
  BOOL CreateFromStatic(UINT nID, CWnd* pParent);
  virtual void PostNcDestroy() { }
  //重载下面两个函数,旁路ChtmlView类的文档视图结构;
  afx_msg void OnDestroy();
  afx_msg int OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT msg);
  // 实现"app"伪协议;
  virtual void OnBeforeNavigate2( LPCTSTR lpszURL,
   DWORD nFlags,
   LPCTSTR lpszTargetFrameName,
   CByteArray& baPostedData,
   LPCTSTR lpszHeaders,
   BOOL* pbCancel );
   virtual void OnAppCmd(LPCTSTR lpszWhere);
   DECLARE_MESSAGE_MAP();
   DECLARE_DYNAMIC(CHtmlCtrl)
};

//////////////////////////////////////////////CHtmlCtrl类的实现文件;
#include "StdAfx.h"
#include "HtmlCtrl.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
IMPLEMENT_DYNAMIC(CHtmlCtrl, CHtmlView)
BEGIN_MESSAGE_MAP(CHtmlCtrl, CHtmlView)
ON_WM_DESTROY()
ON_WM_MOUSEACTIVATE()
END_MESSAGE_MAP()
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();
 // 创建一个HtmlView控件;
 return Create(NULL, // class name
   NULL, // title
  (WS_CHILD | WS_VISIBLE ), // style
  rc, // rectangle
  pParent, // parent
  nID, // control ID
  NULL); // frame/doc context not used
}

void CHtmlCtrl::OnDestroy()
{
 if (m_pBrowserApp) {释放浏缆器的m_pBrowserApp成员变量;
  m_pBrowserApp->Release();
  m_pBrowserApp = NULL;
 }
 CWnd::OnDestroy(); // bypass CView doc/frame stuff
}

int CHtmlCtrl::OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT msg)
{
 //旁路文档视图结构;
 return CWnd::OnMouseActivate(pDesktopWnd, nHitTest, msg);
}

//////////////////实现"app"伪协议;
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;
 }
}

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

/////////////////////////////////////////////////////
class CMyHtmlCtrl : public CHtmlCtrl {
 virtual void OnAppCmd(LPCTSTR lpszWhere);
};

/////////////////// 处理HTML文件上的 "app:ok"链接,关闭对话框;
void CMyHtmlCtrl::OnAppCmd(LPCTSTR lpszWhere)
{
 if (_tcsicmp(lpszWhere,_T("ok"))==0) {
  GetParent()->SendMessage(WM_COMMAND,IDOK);
 }
}
////////////////////////////////////////
class CAboutDlg : public CDialog
{
 public:
  CAboutDlg();
  CMyHtmlCtrl m_page;
  // Dialog Data
  //{{AFX_DATA(CAboutDlg)
   enum { IDD = IDD_ABOUTBOX };
  //}}AFX_DATA
  // ClassWizard generated virtual function overrides
  //{{AFX_VIRTUAL(CAboutDlg)
 protected:
  virtual void DoDataExchange(CDataExchange* pDX); // DDX/DDV support
  //}}AFX_VIRTUAL
  // Implementation
 protected:
  //{{AFX_MSG(CAboutDlg)
   virtual BOOL OnInitDialog();
  //}}AFX_MSG
 DECLARE_MESSAGE_MAP()
};

CAboutDlg::CAboutDlg() : CDialog(CAboutDlg::IDD)
{
 //{{AFX_DATA_INIT(CAboutDlg)
 //}}AFX_DATA_INIT
}

void CAboutDlg::DoDataExchange(CDataExchange* pDX)
{
 CDialog::DoDataExchange(pDX);
 //{{AFX_DATA_MAP(CAboutDlg)
 //}}AFX_DATA_MAP
}

BEGIN_MESSAGE_MAP(CAboutDlg, CDialog)
 //{{AFX_MSG_MAP(CAboutDlg)
 //}}AFX_MSG_MAP
END_MESSAGE_MAP()

// App command to run the dialog
void CShowHtmlApp::OnAppAbout()
{
 CAboutDlg aboutDlg;
 aboutDlg.DoModal();
}

BOOL CAboutDlg::OnInitDialog()
{
 CDialog::OnInitDialog();
 VERIFY(CDialog::OnInitDialog());
 VERIFY(m_page.CreateFromStatic(IDC_HTMLVIEW, this));
 m_page.LoadFromResource(_T("ABOUT.HTM"));
 return TRUE;
}

  四、小结

  在上述实例中,读者朋友还可以在HTML文件中作其他的链接,诸如:app:cancel, app:refresh, 或 app:whatever等等,并且在OnAppCmd中编写自己的代码来处理 "cancel"、"refresh"、和"whatever"等字符串。参照例子程序,将自己的About对话框改进一番吧。如果有兴趣的话,您甚至可以利用这个技术来实现复活节彩蛋。

posted on 2006-10-15 20:07 cy163 阅读(...) 评论(...) 编辑 收藏

导航