IE里的探索之定制浏览器好助手(下)

类别:VC语言 点击:0 评论:0 推荐:

出处:http://www0.ccidnet.com/tech/web/2001/02/08/58_1642.html

IE里的探索之定制浏览器好助手(下)
(作者:青苹果工作室编译 2001年02月08日 14:00)

访问文档对象
  现在 BHO 引用了 Internet Explorer 的 WebBrowser 控件并已经连接到浏览器 以接收它产生的事件。在 Web 页面被完全下载并被正确地初始化之后,现在终于可以通过 DHTML 文档对象模型访问它了。WebBrowser 的 Document 属性返回一个指向文档对象的 IDispatch 接口的指针:

  CComPtr<IDispatch> pDisp;

  HRESULT hr = m_spWebBrowser2->get_Document(&pDisp);

  get_Document() 方法提供的只是一个指向接口的指针。我们需要确定在 IDispatch 指针后面确实是一个 HTML 文档对象。如果使用 Visual Basic,以下是等价的代码:

  Dim doc As Object

  Set doc = WebBrowser1.Document

  If TypeName(doc)="HTMLDocument" Then

   ' Get the document content and display

  Else

   ' Disable the display dialog

  End If

  现在我们需要判断 get_Document() 返回的 IDispatch 指针的实质。Internet Explorer 不仅是一个 HTML 浏览器,还能处理任何 ActiveX 文档 ;即任何有作为 ActiveX 文档服务程序的应用程序支持的文档。这样一来,就不能保证查看的文档的确是一个 HTML 页面。

  有一个解决办法就是查看 URL 并检查 URL 的扩展名。但该如何处理 Active Server Pages (ASP) 或一个暗含指向 HTML 页面的 URL?如果你使用了像 about 或 res 这样的定制协议又该如何?

  我们决定采取另一种方式,它和上面的 Visual Basic 代码性质相同。这种想法就是,如果 IDispatch 指针确实指向一个 HTML 文档,对 IHTMLDocument2 接口的访问就能成功地返回。IHTMLDocument2 是综合了 DHTML 对象模型为 HTML 页面实现的所用功能的接口。以下代码片断说明如何进行这样的判断:

  CComPtr<IDispatch> pDisp;

  HRESULT hr = m_spWebBrowser2->get_Document(&pDisp);

  CComQIPtr<IHTMLDocument2, &IID_IHTMLDocument2> spHTML;

  spHTML = pDisp;

  if (spHTML) {

   // 取得文档的内容并显示它

  }

  else {

   // 禁止代码窗口控件

  }

  如果访问 IHTMLDocument2 接口失败,spHTML 指针为 NULL。否则,我们就可以正常访问 DHTML 对象模型的方法和属性了。

  现在的问题是如何获得已显示的页面的源代码。幸好,基本的 DHTML 知识就足以做到这一点。由于 HTML 页面将它所有的内容包含在 <BODY> 标记中,DHTML 对象模型要求你首先获得指向 Body 对象的指针:

  CComPtr<IHTMLElement> m_pBody;

  hr = spHTML->get_body(&m_pBody);

  奇特的是,DHTML 对象模型不让你知道在 <BODY> 之前的标记,例如 <HEAD> 的原始内容。这些内容已经被处理并被保存到一系列属性中了,但你依然不能得到一个最初的 HTML 文件的原始内容。然而,现在 body 能告诉我们的就足够了。我们需要将 outerHTML 属性的内容读取到一个 BSTR 变量里以获得包含在 <BODY> 和 </BODY> 之间的 HTML 代码。

  BSTR bstrHTMLText;

  hr = m_pBody->get_outerHTML(&bstrHTMLText);

  现在,在代码窗口中显示文本的工作就是创建窗口、将字符串从 Unicode 转换为 ANSI,并如图 3 中所示设置编辑框。以下是完成这些工作的全部代码:

  HRESULT CViewSource::GetDocumentContent()

  {

   USES_CONVERSION;

  

   // 获得 WebBrowser 文档对象

   CComPtr<IDispatch> pDisp;

   HRESULT hr = m_spWebBrowser2->get_Document(&pDisp);

   if (FAILED(hr))

   return hr;

   // 验证我们得到了一个指向 IHTMLDocument2 接口的指针

   // 我们查询 IHTMLDocument2 接口 (通过灵巧指针)

   CComQIPtr<IHTMLDocument2, &IID_IHTMLDocument2> spHTML;

   spHTML = pDisp;

   // 获得文档的源代码

   if (spHTML)

   {

   // 获得 BODY 对象

   hr = spHTML->get_body(&m_pBody);

   if (FAILED(hr))

       return hr;

   // 获得 HTML 文本

   BSTR bstrHTMLText;

   hr = m_pBody->get_outerHTML(&bstrHTMLText);

   if (FAILED(hr))

   return hr;

   // 将文本从 Unicode 转换为 ANSI

   LPTSTR psz = new TCHAR[SysStringLen(bstrHTMLText)];

   lstrcpy(psz, OLE2T(bstrHTMLText));

   // 允许修改文本

   HWND hwnd = m_dlgCode.GetDlgItem(IDC_TEXT);

   EnableWindow(hwnd, true);

   hwnd = m_dlgCode.GetDlgItem(IDC_APPLY);

   EnableWindow(hwnd, true);

   // 设置代码窗口的文本

   m_dlgCode.SetDlgItemText(IDC_TEXT, psz);

   delete [] psz;

   }

   else // 文档不是 HTML 页面

   {

   m_dlgCode.SetDlgItemText(IDC_TEXT, "");

   HWND hwnd = m_dlgCode.GetDlgItem(IDC_TEXT);

   EnableWindow(hwnd, false);

   hwnd = m_dlgCode.GetDlgItem(IDC_APPLY);

   EnableWindow(hwnd, false);

   }

   return S_OK;

  }

  由于我们运行这段代码以响应 DocumentComplete 通知,每个新页面都会迅速地自动处理。DHTML 对象模型允许你修改显现的页面的结构,但在你按 F5 键或浏览器的 Refresh 按钮刷新视图后,所有的修改会立即丢失。通过对 DownloadComplete 事件进行处理你能同时刷新代码窗口。(注意 DownloadComplete 事件比 DocumentComplete 事件先到达) 这时,你应该忽略第一次下载页面时产生的 DownloadComplete 而只考虑刷新时产生的事件。一个简单的布尔成员例如 m_bDocumentCompleted 可以用来区分这两种情况。

管理代码窗口
  用以显示当前页面的 HTML 源代码的代码窗口是 ATL 的另一个基本元素,一个可以在 ATL 对象向导的 Miscellaneous 页里找到的对话框窗口。我们重置这个窗口的尺寸以响应 WM_INITDIALOG 消息,并使此窗口占据桌面工作区,即屏幕的可用部分减掉任务栏可能占据位置最下面的部分。

  浏览器启动时此窗口可能出现也可能不出现。默认情况下它是出现的,但可以通过清除复选框 Show window at startup 禁止。如果你愿意也可以关掉它。随后,可以在任何时候按 F12 键将其召回。F12 由我们在 SetSite() 中安装的键盘挂钩捕获。

  启动设置完全按照 Microsoft 指示保存在注册表里。读写注册表时我们没有使用 Win32 函数,而是使用了新的 Shell Lightweight API (shlwapi.dll),这样 可以避免打开和关闭相应的注册表项的麻烦:

  DWORD dwType, dwVal;

  DWORD dwSize = sizeof(DWORD);

  SHGetValue(HKEY_CURRENT_USER, _T("Software\\MSDN\\BHO"),

   _T("ShowWindowAtStartup"), &dwType, &dwVal, &dwSize);

  这个 DLL 是在 Internet Explorer 4.0 和 Active Desktop 中引入的,从 Windows 98 开始成为标准的系统组件。这些函数比相应的 Win32 函数更直接,适合只进行一次读写时使用。

注册助手对象
  BHO 是 COM 服务程序,应该同时以 COM 服务程序和 BHO 注册。ATL 模板为你提供了完成第一项注册的注册脚本代码 (RGS) 。以下是完成 BHO 注册的 RGS 代码。(CLSID 是从例程序中得到的。)

  HKLM {

   SOFTWARE {

   Microsoft {

   Windows {

   CurrentVersion {

     Explorer {

      'Browser Helper Objects' {

      ForceRemove {1E1B2879-88FF-11D2-8D96-D7ACAC95951F}

  }}}}}}}

  注意 ForceRemove 子句使键在对象取消注册时被删除。

  在 Browser Helper Objects 键下是所有安装的助手对象。浏览器从不将这些放入缓存,所以安装并测试 BHO 是一个很快的过程。

BHO小结
  本文中,我们介绍了浏览器助手对象,一种相对来说比较新的、在浏览器的地址空间内直接引入你的代码的有效方式。你所要做的就是编写一个 COM 服务程序以支持 IObjectWithSite 接口。这里,你的模块从所有预定目的来看都是浏览器机构中的一个组件。本文中我们建立的例程序还涉及到如 COM 事件、动态 HTML 对象模型以及 WebBrowser 编程接口等内容。我们认为它演示了 BHO 的功能,同时提供了一个创建你自己对象的实用平台。如果你需要知道浏览器正在显示什么,你一定需要熟悉事件并进一步了解 WebBrowser。现在你知道:预先警告是为了早做准备。作为结语,我们提醒你 BHO 对 Windows Explorer 非常有用,而且,通过 WebBrowser,它能由你的代码驱动。


 

本文地址:http://com.8s8s.com/it/it1501.htm