HtmlWindow.Open 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在命名視窗中顯示一個檔案。
多載
| 名稱 | Description |
|---|---|
| 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
統一資源定位器(Uniform Resource Locator),描述要載入檔案的位置。
- target
- String
開啟資源的視窗名稱。 這可以是開發者提供的名稱,或以下特殊值之一:
_blank: 在新視窗開啟 urlString 。 運作方式和呼叫 OpenNew(String, String).
_media:在媒體欄開啟 urlString 。
_parent: 在 urlString 建立當前視窗的視窗中開啟。
_search: 在搜尋欄中開啟 urlString 。
_self:在目前視窗中開啟 urlString 。
_top若對屬於元素 FRAME 的視窗被呼叫,則在 urlString 承載其 FRAMESET的視窗中開啟。 否則,行為與 相同 _self。
- windowOptions
- String
一個逗號分隔字串,包含零個或多個以下選項,形式 name=value為 。 除了 left、 top和 heightwidth選項(取任意整數)外,每個選項都接受 yes 或 1、 或 no0 為有效值。
channelmode:搭配已淘汰的 Internet Explorer 4.0 頻道技術使用。 預設值為 no。
directories視窗是否應該顯示目錄導覽按鈕。 預設值為 yes。
height:視窗用戶端區域的高度,以像素為單位。 最低限度為100人;嘗試開啟比這個小的視窗時,該視窗會依照 Internet Explorer 預設值開啟。
left:視窗相對於使用者螢幕左上角的左(x座標)位置,以像素為單位。 必須是正整數。
location: 是否顯示地址列,讓使用者能透過視窗導航到新的網址。 預設值為 yes。
menubar: 是否要在新視窗顯示選單。 預設值為 yes。
resizable:使用者是否可以調整視窗大小。 預設值為 yes。
scrollbars視窗是否有水平與垂直捲軸。 預設值為 yes。
status:視窗底部是否有狀態列。 預設值為 yes。
titlebar: 是否顯示當前頁面的標題。 在受管理的應用程式中,將此選項設為 no Setly 不會有影響;標題列會一直顯示。
toolbar: 工具列按鈕如 返回、 前進和 停止 是否可見。 預設值為 yes。
top:視窗相對於使用者螢幕左上角的頂端(y座標)位置,以像素為單位。 必須是正整數。
width:視窗用戶端區域的寬度,以像素為單位。 最低限度為100人;嘗試開啟比這個小的視窗時,該視窗會依照 Internet Explorer 預設值開啟。
- replaceEntry
- Boolean
true 將當前視窗的網址替換為導航歷史中的 URL urlString 。 這會影響該類別中方法 HtmlHistory 的操作。
傳回
新視窗,或先前以參數命名 target 的視窗。
備註
參數 target 可以命名因先前呼叫而 Open產生的視窗。 參數也可能指向點擊超連結A (元素)開啟的視窗,或 FORM 是使用該 TARGET 屬性在新視窗中開啟其 URL 的元素。 以下 HTML 程式碼在使用者點擊時會開啟一個新視窗 orderWindow :
<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>
如果你提供任何參數選項 windowOptions ,未包含的選項會自動被停用。 換句話說,如果你只透過 windowOptions 指定想要狀態列,那麼選單列、工具列、標題、捲軸等等,除非你透過 S 明確啟用 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
統一資源定位器(Uniform Resource Locator),描述要載入檔案的位置。
- target
- String
開啟資源的視窗名稱。 這可以是開發者提供的名稱,或以下其中一個特殊值:
_blank: 在新視窗開啟 url 。 運作方式和呼叫 OpenNew(String, String).
_media:在媒體欄開啟 url 。
_parent: 在 url 建立當前視窗的視窗中開啟。
_search: 在搜尋欄中開啟 url 。
_self:在目前視窗中開啟 url 。
_top若對屬於元素 FRAME 的視窗被呼叫,則在 url 承載其 FRAMESET的視窗中開啟。 否則,行為與 相同 _self。
- windowOptions
- String
一個逗號分隔字串,包含零個或多個以下選項,形式 name=value為 。 除了 left、 top和 heightwidth選項(取任意整數)外,每個選項都接受 yes 或 1、 或 no0 為有效值。
channelmode:搭配已淘汰的 Internet Explorer 4.0 頻道技術使用。 預設值為 no。
directories視窗是否應該顯示目錄導覽按鈕。 預設值為 yes。
height:視窗用戶端區域的高度,以像素為單位。 最低限度為100人;嘗試開啟比這個小的視窗時,該視窗會依照 Internet Explorer 預設值開啟。
left:視窗相對於使用者螢幕左上角的左(x座標)位置,以像素為單位。 必須是正整數。
location: 是否顯示地址列,讓使用者能透過視窗導航到新的網址。 預設值為 yes。
menubar: 是否要在新視窗顯示選單。 預設值為 yes。
resizable:使用者是否可以調整視窗大小。 預設值為 yes。
scrollbars視窗是否有水平與垂直捲軸。 預設值為 yes。
status:視窗底部是否有狀態列。 預設值為 yes。
titlebar: 是否顯示當前頁面的標題。 在受管理的應用程式中,將此選項設為 no Setly 不會有影響;標題列會一直顯示。
toolbar: 工具列按鈕如 返回、 前進和 停止 是否可見。 預設值為 yes。
top:視窗相對於使用者螢幕左上角的頂端(y座標)位置,以像素為單位。 必須是正整數。
width:視窗用戶端區域的寬度,以像素為單位。 最低限度為100人;嘗試開啟比這個小的視窗時,該視窗會依照 Internet Explorer 預設值開啟。
- replaceEntry
- Boolean
true 將當前視窗的網址替換為導航歷史中的 URL url 。 這會影響類別上方法 HtmlHistory 的操作。
傳回
代表 HtmlWindow 新視窗,或以參數命名 target 的先前建立視窗。
範例
以下程式碼範例包含兩種方法:
- 第一個是在一個名為 的視窗中開啟一個網址
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
備註
參數 target 可以命名因先前呼叫而 Open產生的視窗。 參數也可能指向點擊超連結A (元素)開啟的視窗,或 FORM 是使用該 TARGET 屬性在新視窗中開啟其 URL 的元素。 以下 HTML 程式碼在使用者點擊時會開啟一個新視窗 orderWindow :
<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>
如果你提供任何參數選項 windowOptions ,未包含的選項會自動被停用。 換句話說,如果你只透過 windowOptions 指定想要狀態列,那麼選單列、工具列、標題、捲軸等等,除非你透過 S 明確啟用 windowOptions,否則不會顯示。
如果 url 所參考的檔案是 HTML 檔案、文字檔或其他可存放於 Internet Explorer 中的檔案類型,則會顯示在命名視窗中。 如果檔案無法在 Internet Explorer 中顯示,且目標指定的視窗尚未存在,則該視窗只會開啟足夠 Internet Explorer 下載資源;下載後會立即關閉。
當你使用 Open 或 OpenNew 建立新視窗時,HTML 文件物件模型會開啟一個新的 Internet Explorer 實例。 如果你沒有在所有建立的視窗上呼叫 Close,這個 Internet Explorer 實例即使應用程式結束後仍會繼續執行。
如果你在現有視窗中 Open 載入 URL, windowOptions 將會被忽略;視窗會保留最初呼叫 Open給出的尺寸、外觀和螢幕位置。