HtmlWindow.Open 方法

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

参数

返回

新窗口，或以前创建的由 参数命名的 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首先给定它的尺寸、外观和屏幕位置。

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

参数

返回

表示新窗口的 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 的文件是 HTML 文件、文本文件或可在 Internet Explorer 中托管的其他文件类型，则它将显示在命名窗口中。 如果文件不能显示在 Internet Explorer 内，并且目标命名的窗口不存在，则该窗口将只打开足够长的时间，供 Internet Explorer 下载资源;它随后会立即关闭。

使用 Open 或 OpenNew创建新窗口时，会导致 HTML 文档对象模型打开 Internet Explorer 的新实例。 如果不在创建的所有窗口上调用 Close ，即使应用程序退出，此 Internet Explorer 实例仍将保持运行状态。

如果使用 Open 在现有窗口中加载 URL， windowOptions 则 将被忽略;该窗口将保留通过对 的初始调用 Open首先给定它的尺寸、外观和屏幕位置。

另请参阅

• open 方法