HtmlWindow 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

HtmlWindow.cs

代表包含一個或多個 的 HtmlDocument邏輯視窗。

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

繼承

Object

HtmlWindow

範例

以下程式碼範例包含兩種方法。 第一個是在一個名為 的視窗中開啟一個網址 displayWindow，並顯示狀態列。 第二個視窗會在同一視窗中開啟另一個網址，但只顯示位置列。 請注意，視窗的尺寸和顯示的控制項取決於先開啟的 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 元素，每個元素都承載自己的文件。 網頁開發者使用框架集來將邏輯相關的頁面並排顯示（例如，內容頁與導覽頁並排）。 當頁面由單一文件組成時，你可以透過 Document 的 HtmlWindow屬性存取;如果頁面使用 frames，你可以透過 Frames 集合存取他們的文件，集合包含一個或多個 HtmlWindow 物件。

當你在 Windows Forms 應用程式中託管控制 WebBrowser 項時，你可以選擇使用標準的 Windows 表單類別（例如 Form 或 MessageBox）與使用者互動，或是使用定義的方法 HtmlWindow 來達成此目的。 此 Alert 方法呈現一個簡單的對話框，包含自訂文字和 確定 按鈕; Prompt 向使用者呈現一行自訂文字和文字輸入欄位;並 Confirm 呈現一個包含自訂文字行及 確定 與 取消 按鈕的對話框。

你可以用來 HtmlWindow 開啟包含新文件的新視窗。 Open 將指定的 URL 載入命名視窗，若該視窗尚未存在則建立該視窗，同時 OpenNew 總是在新建立的視窗中開啟其 URL。

屬性

名稱	Description
Document	取得視窗內包含的 HTML 文件。
DomWindow	讓這個類別包覆了非管理介面。
Frames	會取得網頁中定義的每個 FRAME 元素的參考。
History	取得一個包含使用者最近造訪網址的物件。
IsClosed	會得到一個值，表示這個視窗是開啟還是關閉。
Name	取得或設定視窗名稱。
Opener	會得到一個指向開啟當前視窗的視窗的參考。
Parent	取得位於包含框架頁面中當前視窗上方的視窗。
Position	它會取得視窗客戶端區域在螢幕上的位置。
Size	取得或設定目前視窗的大小。
StatusBarText	取得或設定視窗狀態列中顯示的文字。
Url	會取得視窗中目前項目對應的網址。
WindowFrameElement	取得對應此視窗的框架元素。

方法

名稱	Description
Alert(String)	顯示訊息方塊。
AttachEventHandler(String, EventHandler)	新增一個用於命名 HTML DOM 事件的事件處理程序。
Close()	關閉視窗。
Confirm(String)	顯示一個對話框，包含訊息及按鈕以徵求是非回應。
DetachEventHandler(String, EventHandler)	移除命名的事件處理器。
Equals(Object)	測試物件與當前物件的相等性。
Focus()	將焦點放在目前的視窗上。
GetHashCode()	作為特定類型的雜湊函數。
MoveTo(Int32, Int32)	將視窗移動到螢幕上指定的座標。
MoveTo(Point)	將視窗移動到螢幕上指定的座標。
Navigate(String)	顯示或下載位於指定網址的新內容。
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)	將視窗移動到指定的座標。

操作員

名稱	Description
Equality(HtmlWindow, HtmlWindow)	測試兩個 HtmlWindow 物件是否相等。
Inequality(HtmlWindow, HtmlWindow)	測試兩個 HtmlWindow 物體的不等式。

事件

名稱	Description
Error	當視窗內執行的腳本遇到執行錯誤時，會發生這種情況。
GotFocus	當當前視窗取得使用者輸入焦點時，會發生這種情況。
Load	當視窗的文件及其所有元素初始化完成時，會發生。
LostFocus	當使用者輸入焦點離開視窗時會發生。
Resize	當使用者用滑鼠改變視窗尺寸時會發生。
Scroll	當使用者透過視窗捲動以查看螢幕外文字時，會發生這種情況。
Unload	當當前頁面正在卸載，且即將顯示新頁面時，會發生這種情況。

另請參閱

• 視窗物件
• IHTMLWindow2 介面