一、簡介
大家都知道,目前比較流行的網絡浏覽器如Mozilla Firefox以及MyIE2等都具有多頁面浏覽功能,每打開一個新的頁面都自動產生一個新的選項卡頁面,頁面的關閉也十分簡便。這種設計思想使得用戶在浏覽多個網頁時桌面十分簡潔,也避免了用戶等待單頁面顯示的苦惱。由於這些浏覽器一般都支持操作多種文件格式,所以當浏覽本地機器上的多個文件時也極為方便。
本文使用Visual C#詳細介紹如何實現這種多頁面浏覽功能。同時,還實現了下面附加功能: 打印, 打印預覽,頁面屬性,選項,查找,查看頁面源文件等。
二、關鍵技術分析
解決問題的關鍵在於對浏覽器控件WebBrowser的NewWindow2事件的編程。當需要顯示某種文件而生成一個新窗口時,NewWindow2 事件即被激活。注意,該事件發生在WebBrowser控件的新窗口產生之前。例如,作為對導航到一個新窗口或者一個腳本控制的window.open方法的響應,即發生該事件。為了聲明當一個新窗口被打開時,將使用我們自己的浏覽器程序,應該把參數ppDisp置為Application 對象。此時,如果你選擇“在新窗口中打開”,則新產生一個窗口來顯示Web頁面。你也可以把RegisterAsBrowser設置為TRUE,這將導致新生成的WebBrowser控件參與到窗口命名的沖突問題上。例如,如果一個窗口的名字在腳本的另外一處用到,那麼該控件被派上用場,而不是再產生一個新的窗口,因為控件在打開一個新的窗口之前先檢查一下所有已存在的窗口名稱以避免命名沖突。 在本文示例中,作為對該事件的響應,我們動態地創建一個tab頁面,並通過調用CreateNewWebBrowser()方法產生一個WebBrowser控件作為其子控件――這裡每一個子控件都有一個包含該控件相關信息的tag屬性。詳見下面的源碼:
private void axWebBrowser1_NewWindow2(object sender, AxSHDocVw.DWebBrowserEvents2_NewWindow2Event e)
{
AxSHDocVw.AxWebBrowser _axWebBrowser = CreateNewWebBrowser();
e.ppDisp = _axWebBrowser.Application;
_axWebBrowser.RegisterAsBrowser = true;
}
private AxSHDocVw.AxWebBrowser CreateNewWebBrowser()
{
AxSHDocVw.AxWebBrowser _axWebBrowser = new AxSHDocVw.AxWebBrowser();
_axWebBrowser.Tag = new HE_WebBrowserTag();
TabPage _TabPage = new TabPage();
_TabPage.Controls.Add(_axWebBrowser);
_axWebBrowser.Dock = DockStyle.Fill;
_axWebBrowser.BeforeNavigate2 += new AxSHDocVw.DWebBrowserEvents2_BeforeNavigate2EventHandler(this.axWebBrowser1_BeforeNavigate2);
_axWebBrowser.DocumentComplete += new AxSHDocVw.DWebBrowserEvents2_DocumentCompleteEventHandler(this.axWebBrowser1_DocumentComplete);
_axWebBrowser.NavigateComplete2 += new AxSHDocVw.DWebBrowserEvents2_NavigateComplete2EventHandler(this.axWebBrowser1_NavigateComplete2);
_axWebBrowser.NavigateError += new AxSHDocVw.DWebBrowserEvents2_NavigateErrorEventHandler(this.axWebBrowser1_NavigateError);
_axWebBrowser.NewWindow2 += new AxSHDocVw.DWebBrowserEvents2_NewWindow2EventHandler(this.axWebBrowser1_NewWindow2);
_axWebBrowser.ProgressChange += new AxSHDocVw.DWebBrowserEvents2_ProgressChangeEventHandler(this.axWebBrowser1_ProgressChange);
_axWebBrowser.StatusTextChange += new AxSHDocVw.DWebBrowserEvents2_StatusTextChangeEventHandler(this.axWebBrowser1_StatusTextChange);
_axWebBrowser.TitleChange += new AxSHDocVw.DWebBrowserEvents2_TitleChangeEventHandler(this.axWebBrowser1_TitleChange);
_axWebBrowser.CommandStateChange += new AxSHDocVw.DWebBrowserEvents2_CommandStateChangeEventHandler(this.axWebBrowser1_CommandStateChange);
tabControl1.TabPages.Add(_TabPage);
tabControl1.SelectedTab = _TabPage;
return _axWebBrowser;
}
注意,每一個WebBrowser控件都有一個tag,我定義成一個簡單的class,它用來包含一些該控件相關的獨有信息。請看:
public class HE_WebBrowserTag
{
public int _TabIndex = 0;
public bool _CanBack = false;
public bool _CanForward = false;
}
三、實現“查找”、“查看頁面源文件”、“選項”對話框等功能
注意 本例程中使用了一個未公開的GUID,其在將來的系統中可以發生變更。
1、定義 IOleCommandTarget 接口
為定義一個.Net接口以獲得關於一個COM接口的參考,請遵從下列步驟:
1) 賦予.Net接口相應的COM接口的GUID值;
2) 包含對接口中所有方法的類型聲明;
3) 包含對MsHtml.dll和Shdocvw.dll文件的參考,在Visual C# .Net工程中操作,請遵從:
A. 在項目菜單下單擊“添加引用”;
B. 單擊“COM” 選項卡;
C. 雙擊“Microsoft Html Object Library” 和“Microsoft Internet Controls”。
4) 應該在程序命名空間聲明之前,包含下面的接口聲明以添加對Microsoft HTML (MSHtml) IOleCommandTarget接口的參照引用:
using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential,CharSet=CharSet.Unicode)]
public struct OLECMDTEXT
{
public uint cmdtextf;
public uint cwActual;
public uint cwBuf;
[MarshalAs(UnmanagedType.ByValTStr,SizeConst=100)]public char rgwz;
}
[StructLayout(LayoutKind.Sequential)]
public struct OLECMD
{
public uint cmdID;
public uint cmdf;
}
// IOleCommandTarget的Interop定義
[ComImport,
Guid("b722bccb-4e68-101b-a2bc-00aa00404770"),
InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IOleCommandTarget
{
//重要: 下面方法的順序非常重要,因為本示例中我們使用的是早期綁定,詳見MSDN中有關.Net/COM互操作的參考。
void QueryStatus(ref Guid pguidCmdGroup, UInt32 cCmds,
[MarshalAs(UnmanagedType.LPArray, SizeParamIndex=1)] OLECMD[] prgCmds, ref OLECMDTEXT CmdText);
void Exec(ref Guid pguidCmdGroup, uint nCmdId, uint nCmdExecOpt, ref object pvaIn, ref object pvaOut);
}
2、為CGID_IWebBrowser定義一個GUID
必須定義CGI_IWebBrowser的GUID以通知MSHtml如何來處理你的命令ID。在.Net中實現如下:
private Guid cmdGuid = new Guid("ED016940-BD5B-11CF-BA4E-00C04FD70816");
private enum MiscCommandTarget { Find = 1, VIEwSource, Options }
3、調用Exec()方法
注意,下列三個過程成功調用Exec()的前提是,已經存在名為webBrowser的浏覽器控件的被包容實例。
private mshtml.HtmlDocument GetDocument()
{
try
{
mshtml.HTMLDocument htm = (mshtml.HtmlDocument)axWebBrowser2.Document;
return htm;
}
catch
{
throw (new Exception("不能從WebBrowser控件中獲取文件對象"));
}
}
//查看源碼的方法
public void VIEwSource()
{
IOleCommandTarget cmdt;
Object o = new object();
try
{
cmdt = (IOleCommandTarget)GetDocument();
cmdt.Exec(ref cmdGuid, (uint)MiscCommandTarget.VIEwSource,
(uint)SHDocVw.OLECMDEXECOPT.OLECMDEXECOPT_DODEFAULT, ref o, ref o);
}
catch(Exception e)
{
System.Windows.Forms.MessageBox.Show(e.Message);
}
}
public void Find()
{
IOleCommandTarget cmdt;
Object o = new object();
try
{
cmdt = (IOleCommandTarget)GetDocument();
cmdt.Exec(ref cmdGuid, (uint)MiscCommandTarget.Find,
(uint)SHDocVw.OLECMDEXECOPT.OLECMDEXECOPT_DODEFAULT, ref o, ref o);
}
catch(Exception e)
{
System.Windows.Forms.MessageBox.Show(e.Message);
}
}
//顯示“選項”對話框的方法
public void InternetOptions()
{
IOleCommandTarget cmdt;
Object o = new object();
try
{
cmdt = (IOleCommandTarget)GetDocument();
cmdt.Exec(ref cmdGuid, (uint)MiscCommandTarget.Options,
(uint)SHDocVw.OLECMDEXECOPT.OLECMDEXECOPT_DODEFAULT, ref o, ref o);
}
catch
{
// 注意:因為該過程相應的CMDID是在Internet Explorer處理
// ,所以此處的異常代碼塊將總被激活,即使該對話框及其操作成功。
//當然,你可以通過浏覽器選擇設置來禁止這種錯誤的出現。
//不過,即使出現這種提示,對你的主機也無任何損害。
}
}
四、總結
本文通過C#編例,詳細介紹如何實現一種多頁面浏覽程序的基本原理。歡迎同仁批評指正。 另外,本文所附源程序在Windows 2000/.Net 2003/Internet Explorer 6平台上調試通過。