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

描述要加载的文件位置的统一资源定位器。

target
String

要在其中打开资源的窗口的名称。 它可能是开发人员提供的名称或者下列特殊值之一:

_blank urlString:在新窗口中打开。 与调用 OpenNew(String, String) 作用相同。

_media:在媒体栏中打开 urlString

_parent:在创建当前窗口的窗口中打开 urlString

_search:在搜索栏中打开 urlString

_self:在当前窗口中打开 urlString

_top:如果针对属于 元素的FRAME窗口调用,则会在承载其 FRAMESET的窗口中打开urlString。 否则, 的行为与 相同 _self

windowOptions
String

以逗号分隔的字符串,由以下零个或多个选项组成,格式为 name=value。 除了采用任意整数的 lefttopheightwidth 选项外,每个选项都接受 yes1、 和 no0或 作为有效值。

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 在托管应用程序中不起作用;标题栏将始终显示。

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

描述要加载的文件位置的统一资源定位器。

target
String

要在其中打开资源的窗口的名称。 它可以是开发人员提供的名称,或下列特殊值之一:

_blank url:在新窗口中打开。 与调用 OpenNew(String, String) 作用相同。

_media:在媒体栏中打开 url

_parent:在创建当前窗口的窗口中打开 url

_search:在搜索栏中打开 url

_self:在当前窗口中打开 url

_top:如果针对属于 元素的FRAME窗口调用,则会在承载其 FRAMESET的窗口中打开url。 否则, 的行为与 相同 _self

windowOptions
String

以逗号分隔的字符串,由以下零个或多个选项组成,格式为 name=value。 除了采用任意整数的 lefttopheightwidth 选项外,每个选项都接受 yes1、 和 no0或 作为有效值。

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 在托管应用程序中不起作用;标题栏将始终显示。

toolbar:工具栏按钮(如“后退”、“前进”“停止”)是否可见。 默认值为 yes

top:窗口顶部 (y 坐标) 相对于用户屏幕左上角的位置(以像素为单位)。 必须是正整数。

width:窗口工作区的宽度(以像素为单位)。 最小为 100 个像素;尝试打开小于此标准的窗口时,将根据 Internet Explorer 默认设置打开窗口。

replaceEntry
Boolean

true 将当前窗口的 URL url 替换为导航历史记录中的 。 这会影响类上 HtmlHistory 方法的操作。

返回

表示新窗口的 HtmlWindow,或者是以前创建的、由 target 参数命名的窗口。

示例

下面的代码示例包含两种方法:

  • 第一个 在名为 displayWindow的窗口中打开一个 URL,它创建时显示状态栏。
  • 第二个将在同一窗口中打开另一个 URL,但指定仅应显示位置栏。

请注意,窗口的尺寸和显示的控件取决于首先打开的 URL。 代码示例要求窗体包含名为 WebBrowserWebBrowser1控件。

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 下载资源;它随后会立即关闭。

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

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

另请参阅

适用于