CSDN博客

img CathyEagle

Internet Explorer 编程简述(十)响应来自HTML Element的事件通知——几个好用的类

发表于2006/3/11 20:52:00  14734人阅读

分类: Internet Explorer 编程简述 Internet Explorer 编程

关键字:HTML Element, Sink

 
1、概述
实现了对Webbrowser的resuing之后我们便会发现有时候我们还需要处理浏览器中的元素(HTML Element)。这种处理包括主动和被动两个方面,像《FAQ:如何访问WebBrowser的滚动条、《FAQ:操纵下拉列表、《FAQ:两种方法访问多层嵌套的frame等文章所演示的就是主动的处理。通常我们从Webbrowser获得一个Web文档接口(IHTMLDocumentx),从它出发便可访问到浏览器所包含的一切HTML元素。而被动的处理则是在COM技术中称为Sink的技术,我更喜欢的说法是事件通知。当文档的下载进度发生变化时,我们可以获得ProgressChange通知,当Webbrowser下载完HTML文档时,我们可以获得DocumentComplete的通知,而当链接被点击,或图片被拖动时,我们如何获得通知呢?本文希望能够给出部分的答案。
 
2、HtmlObj Template
如何Sink一个HTML Element并不是本文的重点,其理论我不是太了解,也懒得去搞透彻,所以使用现成的库来实现。CodeProject上的一篇文章《CHtmlObj Template》给出的一个模板类CHtmlObj就非常好用。下面的例子是针对Html Anchor Element的一个实例化。
 
#include "HtmlObj.h"
 
class CHtmlAnchorElement : public CHtmlObj<IHTMLAnchorElement,
&DIID_HTMLAnchorEvents> 
{
public:
CHtmlAnchorElement(CHtmlDocument2* pParentDoc2);
virtual ~CHtmlAnchorElement();
 
virtual HRESULT OnInvoke(DISPID dispidMember,REFIID riid,
LCID lcid, WORD wFlags,
DISPPARAMS * pdispparams, VARIANT * pvarResult,
EXCEPINFO * pexcepinfo,
UINT * puArgErr);
};

HRESULT CHtmlAnchorElement::OnInvoke(DISPID dispidMember,
REFIID riid, LCID lcid, WORD wFlags,
DISPPARAMS * pdispparams, VARIANT * pvarResult,
EXCEPINFO * pexcepinfo,
UINT * puArgErr)
{
HRESULT hr = E_NOTIMPL;
switch(dispidMember)
{
case DISPID_HTMLELEMENTEVENTS_ONMOUSEOVER :
{//当鼠标经过链接时,我们在这里获得通知
hr = S_OK;
      // TODO: add code to handle on mouse over events
break;
}
case DISPID_HTMLELEMENTEVENTS_ONMOUSEOUT :
{//当鼠标从链接上移开时,我们在这里获得通知,其它的Dispatch ID可根据需要添加
hr = S_OK;
      // TODO: add code to handle on mouse out events
break;
}
default:
{
break;
}
}
 
return hr;
}
 
当我们得到某个链接的HTML接口指针,便可调用CHtmlAnchorElement继承自CHtmlObj的SetSite(IUnknown *pUnkSite)成员函数传入该接口指针。在CHtmlObj类内部用一个智能指针m_spHtmlObj来保存相应的HTML Element接口指针,所以当上面的ONMOUSEHOVER和ONMOUSEOUT两个事件通知到达时,从m_spHtmlObj就可以访问IHTMLAnchorElement的所有成员,如从href获得链接的Url等,此处不再赘述。
 
3、CHtmlElements类
有了CHtmlObj之后我们又会发现实践中常常会需要多个相同类型的CHtmlObj。比如包含Frame的网页中每个Frame的HTML Document都需要一个CHtmlObj来Sink其事件。所以我们还需要有效地管理这些相同类型的CHtmlObj。下面是我写的一个简单的模板类CHtmlElements,它通过CMap来管理多个CHtmlObj对象。
 
template<class THtmlElement> class CHtmlElements
{
typedef CMap<LPDISPATCH, LPDISPATCH, THtmlElement*, THtmlElement*> CMapDispToHtmlElement;
CMapDispToHtmlElement m_htmlElements;
BOOL IsSiteConnected( LPDISPATCH pDisp )
{
THtmlElement *pElement;
return m_htmlElements.Lookup( pDisp, pElement );
}
public:
CHtmlElements(void)
{
}
~CHtmlElements(void)
{
}
public:
void SetSite( LPDISPATCH pDisp )
{
if ( IsSiteConnected( pDisp ) ) //检查以避免多余的Sink
{
return;
}
THtmlElement *pElement = new THtmlElement; //通过模板类型创建相应的类的实例进行连接
pElement->SetSite( pDisp );
m_htmlElements.SetAt( pDisp, pElement );
}
 

//在合适的地方调用Clear释放所管理的内存

void Clear(void)

{

POSITION pos = m_htmlElements.GetStartPosition();

THtmlElement *pElement = NULL;

LPDISPATCH pDisp = NULL;

while (pos != NULL)

{

m_htmlElements.GetNextAssoc( pos, pDisp, pElement );

m_htmlElements.RemoveKey( pDisp );

delete pElement;

}

}

};
 
假设我们有一个象CHtmlAnchorElement那样派生自CHtmlObj的类CHtmlDocument2,使用CHtmlElements时这样声明:
 
typedef CHtmlElements<CHtmlDocument2> CHtmlDocuments;
typedef CHtmlElements<CHtmlAnchorElement> CHtmlAnchors;
 
class CMyView : public CHtmlView
{
private:
CHtmlDocuments m_htmlDocs;
CHtmlAnchors m_htmlAnchors;
}
 
在DocumentComplete时就可以这样连接到浏览器的文档对象:
void CMyView ::OnDocumentComplete(LPDISPATCH pDisp, LPCTSTR lpszURL)
{
m_htmlDocs.SetSite(pDisp);
}
 
如果想一次性连接上文档中所有的Anchor Element,可以通过IHTMLDocument2::get_anchors获得包含所有IHTMLAnchorElement接口指针的IHTMLElementCollection,再遍历其中的每个元素,分别调用m_htmlAnchors.SetSite即可。当然,一次性的Sink全部链接可能并不是个好注意,我更愿意在CHtmlDocument2中响应事件再通过其它手段来访问当前位置的HTML Element。
 
4、结论
响应HTML Element的事件通知对于浏览器编程来说是一个非常强大的手段,它可以更深入细化地控制浏览器中的文档及其HTML元素,实现更为高级的功能,比如所谓的“超级拖放”(许多多窗口浏览器都提供了该功能,但实际上没有哪个浏览器完美地实现了对URL、文字及图片的拖放)。
 
5、参考资料
 
0 0

相关博文

我的热门文章

img
取 消
img