VC7 HTML Dialog开发实例讲解

开发环境：VS7，Windows XP，Windows 2K

　　在VS7中添加了一种新的对话框类：CDHtmlDialog，顾名思义就是能够显示DHTML内容的对话框，但不同与以前的CHTMLView不同的是添加了对DHTML的支持，能够响应各种DHTML的事件，而且能够方便的得到网页上的各种内容和输入。在这以前要完成这些功能必须通过复杂的COM接口来完成，而现在MS MFC已经为我们做好了这一切。 
　　 在下面我会按照下面的顺序讲解CDHtmlDialog的用法。但本文也只能对DHTML对话框的功能进行部分的讲解，更多更全的说明需要大家自己摸索和查找资料。本文的目的是在于讲解如何得到和设置网页上的各种元素的值，如何处理事件。 
　　 此外在阅读本文前你必须对HTML和DHTML有所了解。

类成员函数介绍

　　 构造函数

　　 CDHtmlDialog( ); 
　　 CDHtmlDialog( 
　　 LPCTSTR lpszTemplateName, 
　　 LPCTSTR szHtmlResID, 
　　 CWnd *pParentWnd = NULL 
　　 ); 
　　 CDHtmlDialog( 
　　 UINT nIDTemplate, 
　　 UINT nHtmlResID = 0, 
　　 CWnd *pParentWnd = NULL 
　　 );

　　 你可以看到和CDialog不同的就在于第二个参数，表示在对话框创建时是否自动加载HTML，这里必须说明的是HTML必须以资源的形式存放，这个参数指明的是资源的ID或名称。

　　

　　 或者你可以利用

　　 BOOL LoadFromResource( 
　　 LPCTSTR lpszResource 
　　 ); 
　　 BOOL LoadFromResource( 
　　 UINT nRes 
　　 ); 
　　 将HTML内容在后期进行装载。

　　页面浏览

　　 此外一些函数如：OnNavigateComplete，OnBeforeNavigate，Navigate等用于页面转换的函数，在以前的CHtmlView中就有这里就不再作讲解。

得到当前URL

　　 void GetCurrentUrl( 
　　 CString& szUrl 
　　 );

得到网页中的DHTML元素的指定接口

　　 HRESULT GetElementInterface( 
　　 LPCTSTR szElementId, 
　　 REFIID riid, 
　　 void** ppvObj 
　　 );

　　 第一个参数指定，第二个参数指定接口ID，第三个参数返回接口指针。

得到网页中的DHTML元素的IHTMLElement接口

　　 HRESULT GetElement( 
　　 LPCTSTR szElementId, 
　　 IHTMLElement **pphtmlElement 
　　 ); 
　　 相当于调用 GetElementInterface(szElementId,IHTMLElement,pphtmlElement);

　　 这个函数非常的重要，因为如果要得到DHTML的内容就必须通过页面上的各个元素的属性来得到，例如：对于Input type=text的属性value就是输入的值，对于p的属性innerText就是段落中的内容。

　　 函数的第二个参数就是元素的名称。

　　 函数的第二个参数，是一个指向指针的指针，通过它得到IHTMLElement的接口。函数返回值是HRESULT其值的定义符合COM中对返回值的定义。（如果你不了解，可以简单的检测返回值是否等于S_OK）

得到元素的innerText和innerHTML的属性

　　 innerHTML属性： 
　　 BSTR GetElementHtml( 
　　 LPCTSTR szElementId 
　　 ); 
　　 innerText属性： 
　　 BSTR GetElementText( 
　　 LPCTSTR szElementId 
　　 ); 
　　 相当于调用IHTMLElement接口的gett_innerHTML和get_innerText方法

　　 与之对应的是设置元素的innerText和InnerHTML属性： 
　　 innerHTML属性： 
　　 void SetElementHtml( 
　　 LPCTSTR szElementId, 
　　 BSTR bstrText 
　　 ); 
　　 innerText属性： 
　　 void SetElementText( 
　　 LPCTSTR szElementId, 
　　 BSTR bstrText 
　　 ); 
　　 相当于调用IHTMLElement接口的put_innerHTML和put_innerText方法

示范代码

　　 假设页面上的代码为：<p id=p2>test</p>，执行下面代码可以显示原来的内容和将新内容设置为：abcdefg

　　 CComPtr<IHTMLElement> spP1; 
　　 HRESULT hr = S_OK;

　　 // Use the template overload 
　　 hr = GetElementInterface("p2", &spP1); 
　　 // 或者 hr = GetElement("p2", &spP1); 
　　 // 或者 hr = GetElementInterface("p2", IID_IHTMLElement, reinterpret_cast<void**>(&spP1)); 
　　 if(S_OK == hr) 
　　 { 
　　 BSTR bStr; 
　　 spP1->get_innerHTML(&bStr); 
　　 CString szTemp; 
　　 szTemp = bStr; 
　　 AfxMessageBox(szTemp);

　　 CString strTable="abcdefg"; 
　　 BSTR bstrTable = strTable.AllocSysString(); 
　　 spP1->put_innerHTML(bstrTable); 
　　 } 
　　 或者利用SetElementHtml和SetElementText来进行设置： 
　　 BSTR bStr; 
　　 bStr = GetElementHtml("p2"); 
　　 CString szTemp; 
　　 szTemp = bStr; 
　　 AfxMessageBox(szTemp); 
　　 CString strTable="ABCDEFG"; 
　　 BSTR bstrTable = strTable.AllocSysString(); 
　　 //spP1->put_innerHTML(bstrTable); 
　　 SetElementHtml("p2",bstrTable); 
事件处理映射宏

基本格式

BEGIN_DHTML_EVENT_MAP(className ) 
　　 DHTML_EVENT_ONCLICK(elemName, memberFxn ) //处理onclick事件 
　　 DHTML_EVENT_ONFOCUS(elemName, memberFxn ) //处理onfocus事件 
　　 DHTML_EVENT_ONKEYDOWN(elemName, memberFxn ) //处理onkeydown事件 
　　 DHTML_EVENT_ONMOUSEMOVE(elemName, memberFxn ) //处理mousemove事件 
　　 DHTML_EVENT_ONMOUSEOUT(elemName, memberFxn ) //处理mousemoveout事件 
　　 等等……… 
　　 END_DHTML_EVENT_MAP()

　　 更详细的说明可以查阅MSDN中DHTML Event Map Macros部分。MSDN中对可以处理的事件进行了详细的说明。DHTML中的事件与Windows中消息不是同一个概念，虽然映射宏的形式很相同。

添加映射处理代码

　　 我在VC7中没有发现自动添加各种事件映射的方法，只能通过手工添加代码的方式。

　　 定义事件处理函数： 
　　 函数原型为：HRESULT urClass::OnXXXXX(IHTMLElement* /*pElement*/) 
　　 添加消息映射： 
　　 BEGIN_DHTML_EVENT_MAP(urClass) 
　　 DHTML_EVENT_ONCLICK(_T("id name"), OnXXXXX) 
　　 END_DHTML_EVENT_MAP()

　　 下面是一段示范代码： 
　　 // mydlg.h 
　　 class CmydhtmlDlg : public CDHtmlDialog 
　　 { 
　　 // 构造 
　　 public: 
　　 CmydhtmlDlg(CWnd* pParent = NULL); // 标准构造函数

　　 // 对话框数据 
　　 enum { IDD = IDD_MYDHTML_DIALOG, IDH = IDR_HTML_MYDHTML_DIALOG };

　　 protected: 
　　 virtual void DoDataExchange(CDataExchange* pDX); // DDX/DDV 支持 
　　 HRESULT OnButtonOK(IHTMLElement *pElement); 
　　 HRESULT OnButtonCancel(IHTMLElement *pElement); 
　　 HRESULT OnButtonTest1(IHTMLElement *pElement); 
　　 HRESULT OnButtonTest2(IHTMLElement *pElement); 
　　 HRESULT OnButtonTest3(IHTMLElement *pElement); 
　　 HRESULT OnSelectTest1(IHTMLElement *pElement); 
　　 HRESULT OnDivMouseMove1(IHTMLElement *pElement); 
　　 HRESULT OnDivMouseOut1(IHTMLElement *pElement);

　　 //mydlg.cpp 
　　 BEGIN_DHTML_EVENT_MAP(CmydhtmlDlg) 
　　 DHTML_EVENT_ONCLICK(_T("ButtonOK"), OnButtonOK) 
　　 DHTML_EVENT_ONCLICK(_T("ButtonCancel"), OnButtonCancel) 
　　 DHTML_EVENT_ONCLICK(_T("Test1"), OnButtonTest1) 
　　 DHTML_EVENT_ONCLICK(_T("Test2"), OnButtonTest2) 
　　 DHTML_EVENT_ONCLICK(_T("Test3"), OnButtonTest3) 
　　 DHTML_EVENT_ONCHANGE(_T("s1"), OnSelectTest1) 
　　 DHTML_EVENT_ONMOUSEMOVE(_T("d1"), OnDivMouseMove1 ) 
　　 DHTML_EVENT_ONMOUSEOUT(_T("d1"), OnDivMouseOut1 ) 
　　 END_DHTML_EVENT_MAP()

　　 HRESULT CmydhtmlDlg::OnButtonOK(IHTMLElement* /*pElement*/) 
　　 { 
　　 OnOK(); 
　　 return S_OK; 
　　 }

　　 HRESULT CmydhtmlDlg::OnButtonCancel(IHTMLElement* /*pElement*/) 
　　 { 
　　 OnCancel(); 
　　 return S_OK; 
　　 }

　　 HRESULT CmydhtmlDlg::OnButtonTest1(IHTMLElement* /*pElement*/) 
　　 { 
　　 AfxMessageBox("test1 button clicked"); 
　　 return S_OK; 
　　 }

　　 HRESULT CmydhtmlDlg::OnSelectTest1(IHTMLElement* /*pElement*/) 
　　 { 
　　 TRACE("select1 changed\n"); 
　　 return S_OK; 
　　 }

　　 HRESULT CmydhtmlDlg::OnDivMouseMove1(IHTMLElement* /*pElement*/) 
　　 { 
　　 TRACE("div1 mouse move\n"); 
　　 return S_OK; 
　　 }

　　 HRESULT CmydhtmlDlg::OnDivMouseOut1(IHTMLElement* /*pElement*/) 
　　 { 
　　 TRACE("div1 mouse out\n"); 
　　 return S_OK; 
　　 }

各种DDX帮助宏

DDX宏介绍

如同CDialog类一样，CHtmlDialog也提供各种DDX帮助宏来与HTML页面上的控件交换数据。

　　遗憾的是VS7中无法为CDHTMLDialog 的子类自动添加DDX变量，必须通过手工添加。

　　 设置innerText和innerHTML属性

　　 DDX_DHtml_ElementInnerText( 
　　 CDataExchange* dx, 
　　 LPCTSTR name, 
　　 CString& var 
　　 ) 
　　 和 
　　　 DDX_DHtml_ElementInnerHtml( 
　　 CDataExchange* dx, 
　　 LPCTSTR name, 
　　 CString& var 
　　 ) 
　　 相当与前面提到的设置和获取innerText，innerHTML属性。

　　 获取和设置控件中的值

　　在DHTML中利用“对象名程.value”可以得到控件中输入的值，利用DDX也同样可以得到。

　　 DDX_DHtml_ElementValue( 
　　 CDataExchange* dx, 
　　 LPCTSTR name, 
　　 var 
　　 ) 
　　 用于在控件和对象之间交换数据。

　　 使用方法

　　假设HTML文件中代码如下

　　 <p id="p4"><b>p4 for ddx</b></p> 
　　 <input type="text" ID="input1" size="20" value="input1 for ddx" NAME="input1"> 
　　 <input type="text" ID="input2" size="20" value="101" NAME="input2">

　　 在H文件中添加变量定义： 
　　 public: //DDX 
　　 CString m_szP4,m_szInput1; 
　　 int m_iInput2;

　　 在类的构造函数中赋初值： 
　　 CmydhtmlDlg::CmydhtmlDlg(CWnd* pParent /*=NULL*/) 
　　 : CDHtmlDialog(CmydhtmlDlg::IDD, CmydhtmlDlg::IDH, pParent) 
　　 { 
　　 m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME); 
　　 m_szP4 = "test for p4"; 
　　 m_szInput1= "test for input1"; 
　　 m_iInput2 = 101; 
　　 }

　　 在CPP文件中的void CmydhtmlDlg::DoDataExchange(CDataExchange* pDX)函数中添加代码： 
　　 void CmydhtmlDlg::DoDataExchange(CDataExchange* pDX) 
　　 { 
　　 CDHtmlDialog::DoDataExchange(pDX); 
　　 //// for html ddx 
　　 DDX_DHtml_ElementInnerHtml(pDX,"p4",m_szP4); //对应 p4 
　　 DDX_DHtml_ElementValue(pDX,"input1",m_szInput1); //对应 input1 
　　 DDX_DHtml_ElementValue(pDX,"input2",m_iInput2); //对应 input2 
　　 } 
　　 使用是与CDialog一样利用UpdateData。 
　　 HRESULT CmydhtmlDlg::OnButtonTest4(IHTMLElement* /*pElement*/) 
　　 { 
　　 UpdateData(); 
　　 TRACE("p4=%s\n",m_szP4); 
　　 CString szTemp=m_szP4; 
　　 m_szP4 =m_szInput1; 
　　 m_szInput1=szTemp; //对换p4和input1中内容 
　　 m_iInput2 ++; //将input2中数字加一 
　　 UpdateData(FALSE); 
　　 return S_OK; 
　　 }

一个简单的例子

　　 最后介绍一下如何利用VC7创建一个利用CDHtmlDialog的工程。

　　首先创建工程，进行如下设置：

　　

　　 在资源管理中修改HTML文件：

　　　

　　 最后添加自己的代码。我提供的例子中所使用的函数在上面都已经提到。