HtmlWindow 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

代表邏輯視窗，包含 HtmlDocument 的一個或多個執行個體。

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

繼承

Object

HtmlWindow

範例

下列程式碼範例包含兩種方法。 第一個會在名為 displayWindow 的視窗中開啟 URL，它會建立並顯示狀態列。 第二個會在相同的視窗中開啟另一個 URL，但會指定只顯示位置列。 請注意，視窗的維度和顯示的控制項取決於先開啟的 URL。 程式碼範例會要求表單包含 WebBrowser 名為 的 WebBrowser1 控制項。

private void DisplayFirstUrl()
{
    if (webBrowser1.Document != null)
    {
        //If this is called first, the window will only have a status bar.
        webBrowser1.Document.Window.Open(new Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", false);
    }
}

private void DisplaySecondUrl()
{
    if (webBrowser1.Document != null)
    {
        // If this is called first, the window will only have an Address bar.
        webBrowser1.Document.Window.Open(new Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", false);
    }
}

Private Sub DisplayFirstUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have a status bar.
            .Window.Open(New Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", False)
        End With
    End If
End Sub

Private Sub DisplaySecondUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have an Address bar.
            .Window.Open(New Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", False)
        End With
    End If
End Sub

備註

HtmlWindow不應該與 Windows Forms 或 Windows API 中視窗的概念混淆;沒有 HWND 或類似Windows資源直接對應至 的實例 HtmlWindow 。 HtmlWindow而是提供使用者畫面上檔位置的高階描述，以及透過提示和對話方塊與使用者互動的方法。 HtmlWindow 可作為網頁檔及其中繼資料的邏輯容器，例如檔的位置和網頁瀏覽器的功能。

網頁是由單一檔所組成，或 FRAMESET 包含一或多個 FRAME 元素，每個元素都會裝載自己的檔。 Web 開發人員會使用框架組來並排顯示邏輯相關頁面 (，例如流覽頁面旁的內容頁面) 。 當頁面是由單一檔所組成時，您可以透過 Document 的 HtmlWindow 屬性來存取它;如果頁面使用框架，您可以透過 Frames 集合存取其檔，其中包含一或多個 HtmlWindow 物件。

當您在Windows Forms應用程式中裝載 WebBrowser 控制項時，您可以選擇使用標準Windows Forms類別來與使用者互動，例如 Form 或 MessageBox ，或者您可以使用針對此用途定義的 方法 HtmlWindow 。 方法 Alert 會呈現具有自訂文字和 [確定 ] 按鈕的簡單對話方塊; Prompt 向使用者呈現一行自訂文字和文字輸入欄位;並 Confirm 呈現一行自訂文字和 [確定 ] 和 [ 取消 ] 按鈕的對話方塊。

您可以使用 HtmlWindow 開啟包含新檔的新視窗。 Open 會將指定的 URL 載入至具名視窗，並在不存在時加以建立，同時 OpenNew 一律會在新建立的視窗中開啟其 URL。

屬性

Document	取得包含在視窗內的 HTML 文件。
DomWindow	取得這個類別所包裝的 Unmanaged 介面。
Frames	取得定義在網頁內每一個 FRAME 項目的參考。
History	取得包含使用者最近瀏覽過之 URL 的物件。
IsClosed	取得值，表示這個視窗已開啟還是關閉。
Name	取得或設定視窗的名稱。
Opener	取得開啟目前視窗之視窗的參考。
Parent	取得位於包含框架的網頁中目前視窗上方的視窗。
Position	取得螢幕上視窗的工作區位置。
Size	取得或設定目前視窗的大小。
StatusBarText	取得或設定顯示在視窗狀態列中的文字。
Url	取得 URL，其對應到顯示在視窗中的目前項目。
WindowFrameElement	取得對應到這個視窗的框架項目。

方法

Alert(String)	顯示訊息方塊。
AttachEventHandler(String, EventHandler)	為具名的 HTML DOM 事件加入事件處理常式。
Close()	關閉視窗。
Confirm(String)	顯示對話方塊，其中包含請求是/否回應的訊息和按鈕。
DetachEventHandler(String, EventHandler)	移除具名事件處理常式。
Equals(Object)	依目前的物件測試物件的相等性。
Focus()	讓目前視窗具有焦點。
GetHashCode()	以特定類型的雜湊函式進行服務。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MoveTo(Int32, Int32)	將視窗移至螢幕上的指定座標位置。
MoveTo(Point)	將視窗移至螢幕上的指定座標位置。
Navigate(String)	顯示或下載位於指定 URL 的新內容。
Navigate(Uri)	在目前視窗中顯示新文件。
Open(String, String, String, Boolean)	在具名視窗中顯示檔案。
Open(Uri, String, String, Boolean)	在具名視窗中顯示檔案。
OpenNew(String, String)	在新視窗中顯示檔案。
OpenNew(Uri, String)	在新視窗中顯示檔案。
Prompt(String, String)	顯示對話方塊，其中會對使用者顯示訊息和文字方塊。
RemoveFocus()	讓目前視窗失去焦點。
ResizeTo(Int32, Int32)	將視窗大小變更為指定的維度。
ResizeTo(Size)	將視窗大小變更為指定的維度。
ScrollTo(Int32, Int32)	捲動視窗至指定的位置。
ScrollTo(Point)	將視窗移至指定的座標。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

運算子

Equality(HtmlWindow, HtmlWindow)	測試兩個 HtmlWindow 物件是否相等。
Inequality(HtmlWindow, HtmlWindow)	測試兩個 HtmlWindow 物件是否不相等。

事件

Error	當視窗內執行的指令碼遇到執行階段錯誤時發生。
GotFocus	當目前視窗取得使用者輸入焦點時發生。
Load	當視窗的文件和其所有項目完成初始化時發生。
LostFocus	當使用者輸入焦點離開視窗時發生。
Resize	當使用者使用滑鼠變更視窗的維度時發生。
Scroll	當使用者在視窗中捲動來檢視螢幕範圍外的文字時發生。
Unload	當目前網頁正在卸載，而且即將要顯示新網頁時發生。

另請參閱

• window 物件
• IHTMLWindow2 介面