共用方式為


HtmlWindow.Open 方法

定義

在具名視窗中顯示檔案。

多載

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 為 下列選項的零或多個。 除了接受任意整數的 、、 和 選項之外,每個選項都會接受 yes1 、 和 no0 作為有效值。 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 類別上的方法作業。

傳回

新的視窗,或先前由 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 下載資源;它會在之後立即關閉。

當您使用 OpenOpenNew 建立新的視窗時,它會導致 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

以逗號分隔的字串,其格式 name=value 為 下列選項的零或多個。 除了接受任意整數的 、、 和 選項之外,每個選項都會接受 yes1 、 和 no0 作為有效值。 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 url 。 這會影響 類別上 HtmlHistory 方法的作業。

傳回

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 下載資源;其之後會立即關閉。

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

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

另請參閱

適用於