HtmlWindow.Open 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在具名視窗中顯示檔案。

多載

Open(String, String, String, Boolean)	在具名視窗中顯示檔案。
Open(Uri, String, String, Boolean)	在具名視窗中顯示檔案。

Open(String, String, String, Boolean)

在具名視窗中顯示檔案。

public:
 System::Windows::Forms::HtmlWindow ^ Open(System::String ^ urlString, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow Open (string urlString, string target, string windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow? Open (string urlString, string target, string windowOptions, bool replaceEntry);

member this.Open : string * string * string * bool -> System.Windows.Forms.HtmlWindow

Public Function Open (urlString As String, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

參數

urlString: String

描述要載入之檔案位置的統一資源定位器 (URL)。

target: String

要在其中開啟資源的視窗名稱。這可能是開發人員所提供的名稱，或是下列其中一個特殊值：

_blank：在新視窗中開啟 urlString 。與呼叫 OpenNew(String, String) 的作用相同。

_media：在媒體列中開啟 urlString 。

_parent：在建立目前視窗的視窗中開啟 urlString 。

_search：在搜尋列中開啟 urlString 。

_self：在目前的視窗中開啟 urlString 。

_top：如果針對屬於 FRAME 專案的視窗呼叫，則會在裝載其 FRAMESET 的視窗中開啟 urlString 。否則，會與相同 _self 。

windowOptions: String

以逗號分隔的字串，其格式 name=value 為下列選項的零或多個。除了接受任意整數的、、和選項之外，每個選項都會接受 yes 或 1 、和 no 或 0 作為有效值。 widthheighttopleft

channelmode：搭配 Internet Explorer 4.0 的已取代通道技術使用。預設為 no。

directories：視窗是否應該顯示瀏覽目錄按鈕。預設為 yes。

height：視窗的工作區高度 (以像素為單位)。最小值為 100。若嘗試開啟比這個值還要小的視窗，該視窗就會根據 Internet Explorer 的預設值來進行開啟。

left：相對於使用者螢幕左上角的視窗左方 (X 座標) 位置 (以像素為單位)。必須是正整數。

location：是否要顯示網址列，讓使用者能夠將視窗巡覽至新的 URL。預設為 yes。

menubar：是否要在新視窗上顯示功能表。預設為 yes。

resizable：使用者是否可以調整視窗的大小。預設為 yes。

scrollbars：視窗是否有水準和垂直捲動條。預設為 yes。

status：視窗是否在底部具有狀態列。預設為 yes。

titlebar：是否顯示目前頁面的標題。將此選項設定為 no 在 Managed 應用程式中沒有任何作用;標題列一律會出現。

toolbar：是否顯示 [ 上一頁]、[ 轉寄] 和 [ 停止 ] 等工具列按鈕。預設為 yes。

top：視窗的頂端 (y 座標) 位置，相對於使用者畫面左上角，以圖元為單位。必須是正整數。

width：視窗工作區的寬度，以圖元為單位。最小值為 100。若嘗試開啟比這個值還要小的視窗，該視窗就會根據 Internet Explorer 的預設值來進行開啟。

replaceEntry: Boolean

true 將目前視窗的 URL urlString 取代為流覽歷程記錄中的。這會影響 HtmlHistory 類別上的方法作業。

傳回

HtmlWindow

新的視窗，或先前由 target 參數命名的視窗。

備註

參數 target 可以將建立為先前呼叫 Open 之結果所建立的視窗命名為。參數也可以按一下超連結來指向開啟的視窗， (專案) A 或使用 FORMTARGET 屬性在新視窗中開啟其 URL 的專案。當使用者按一下它時，下列 HTML 程式碼會開啟名為 orderWindow 的新視窗：

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

如果您提供參數的任何選項 windowOptions ，則會自動停用未包含的任何選項。換句話說，如果您只透過 windowOptions 想要的狀態列來指定，除非您透過明確啟用它們 windowOptions ，否則不會顯示功能表列、工具列、標題、捲軸等等。

如果所 url 參考的檔案是 HTML 檔案、文字檔或其他可裝載于 Internet Explorer 內的檔案類型，則會顯示在具名視窗中。如果檔案無法顯示在 Internet Explorer 內，且目標所命名的視窗不存在，則視窗只會開啟足夠的時間，讓 Internet Explorer 下載資源;它會在之後立即關閉。

當您使用 Open 或 OpenNew 建立新的視窗時，它會導致 HTML 檔案物件模型開啟 Internet Explorer 的新實例。如果您未在所有已建立的視窗上呼叫 Close ，即使您的應用程式結束，這個 Internet Explorer 實例仍會繼續執行。

如果您使用 Open 在現有的視窗中載入 URL， windowOptions 將會忽略;視窗會保留第一次呼叫 Open 的維度、外觀和螢幕位置。

適用於

Open(Uri, String, String, Boolean)

在具名視窗中顯示檔案。

public:
 System::Windows::Forms::HtmlWindow ^ Open(Uri ^ url, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow Open (Uri url, string target, string windowOptions, bool replaceEntry);

public System.Windows.Forms.HtmlWindow? Open (Uri url, string target, string windowOptions, bool replaceEntry);

member this.Open : Uri * string * string * bool -> System.Windows.Forms.HtmlWindow

Public Function Open (url As Uri, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

參數

url: Uri

描述要載入之檔案位置的統一資源定位器 (URL)。

target: String

要在其中開啟資源的視窗名稱。這可能是開發人員所提供的名稱，或是下列其中一個特殊值：

_blank：在新視窗中開啟 url 。與呼叫 OpenNew(String, String) 的作用相同。

_media：在媒體列中開啟 url 。

_parent：在建立目前視窗的視窗中開啟 url 。

_search：在搜尋列中開啟 url 。

_self：在目前的視窗中開啟 url 。

_top：如果針對屬於 FRAME 專案的視窗呼叫，則會在裝載其 FRAMESET 的視窗中開啟 url 。否則，會與相同 _self 。

windowOptions: String

channelmode：搭配 Internet Explorer 4.0 的已取代通道技術使用。預設為 no。

directories：視窗是否應該顯示瀏覽目錄按鈕。預設為 yes。

height：視窗的工作區高度 (以像素為單位)。最小值為 100。若嘗試開啟比這個值還要小的視窗，該視窗就會根據 Internet Explorer 的預設值來進行開啟。

left：相對於使用者螢幕左上角的視窗左方 (X 座標) 位置 (以像素為單位)。必須是正整數。

location：是否要顯示網址列，讓使用者能夠將視窗巡覽至新的 URL。預設為 yes。

menubar：是否要在新視窗上顯示功能表。預設為 yes。

resizable：使用者是否可以調整視窗的大小。預設為 yes。

scrollbars：視窗是否有水準和垂直捲動條。預設為 yes。

status：視窗是否在底部具有狀態列。預設為 yes。

titlebar：是否顯示目前頁面的標題。將此選項設定為 no 在 Managed 應用程式中沒有任何作用;標題列一律會出現。

toolbar：是否顯示 [ 上一頁]、[ 轉寄] 和 [ 停止 ] 等工具列按鈕。預設為 yes。

top：視窗的頂端 (Y 座標) 位置，相對於使用者畫面左上角，以圖元為單位。必須是正整數。

width：視窗工作區的寬度，以圖元為單位。最小值為 100。若嘗試開啟比這個值還要小的視窗，該視窗就會根據 Internet Explorer 的預設值來進行開啟。

replaceEntry: Boolean

true 以在流覽歷程記錄中取代目前視窗的 URL url 。這會影響類別上 HtmlHistory 方法的作業。

傳回

HtmlWindow

HtmlWindow，代表新視窗，或是之前建立的視窗 (由 target 參數所命名)。

範例

下列程式碼範例包含兩種方法：

第一個會在名為 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

備註

參數 target 可以將先前呼叫 Open 所建立的視窗命名為。參數也可以按一下超連結來指向開啟的視窗， (專案) A 或使用 FORMTARGET 屬性在新視窗中開啟其 URL 的專案。當使用者按一下此視窗時，下列 HTML 程式碼會開啟名為 orderWindow 的新視窗：

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

如果您為參數提供任何選項 windowOptions ，則不會自動停用未包含的任何選項。換句話說，如果您只透過 windowOptions 想要狀態列來指定，除非透過明確啟用 windowOptions 它們，否則不會顯示功能表列、工具列、標題、捲軸等等。

如果所 url 參考的檔案是可裝載在 Internet Explorer 內的 HTML 檔案、文字檔或其他檔案類型，則會顯示在具名視窗中。如果檔案無法顯示在 Internet Explorer 內，且目標所命名的視窗不存在，則視窗只會開啟足夠的時間，讓 Internet Explorer 下載資源;其之後會立即關閉。

當您使用 Open 或 OpenNew 建立新的視窗時，它會導致 HTML 檔案物件模型開啟 Internet Explorer 的新實例。如果您未呼叫 Close 您所建立的所有視窗，即使您的應用程式結束，這個 Internet Explorer 實例仍會繼續執行。

如果您使用 Open 在現有的視窗中載入 URL， windowOptions 將會忽略;視窗會保留第一次呼叫 Open 時所給予的維度、外觀和螢幕位置。

另請參閱

open 方法

適用於

共用方式為

HtmlWindow.Open 方法

定義

多載

Open(String, String, String, Boolean)

參數

傳回

備註

適用於

Open(Uri, String, String, Boolean)

參數

傳回

範例

備註

另請參閱

適用於

其他資源