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 элемент) или FORM элемент, который использует TARGET атрибут для открытия URL-адреса в новом окне. Следующий HTML-код открывает новое окно с именем orderWindow , когда пользователь щелкает его:

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

Если указать какие-либо параметры для windowOptions параметра, любой параметр, не включенный, автоматически отключается. Другими словами, если указать windowOptions только строку состояния, то строка меню, панель инструментов, заголовок, полосы прокрутки и т. д. не будут отображаться, если вы явно не включите их с помощью windowOptions.

Если файл, на который ссылается , является HTML-файлом, текстовым файлом url или файлом другого типа, который может размещаться в интернет-Обозреватель, он будет отображаться в именованном окне. Если файл не может отображаться внутри интернет-Обозреватель, а окно с именем целевого объекта еще не существует, окно будет открываться достаточно долго, чтобы интернет-Обозреватель скачать ресурс; оно закроется сразу же после этого.

При создании новых окон с помощью Open или OpenNewобъектная модель html-документов открывает новый экземпляр интернет-Обозреватель. Если вы не вызываете Close во всех созданных окнах, этот экземпляр интернет-Обозреватель будет работать даже после завершения работы приложения.

Если вы используете 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.

Примеры

Следующий пример кода содержит два метода:

• Первый открывает URL-адрес в окне с именем displayWindow, которое он создает с отображаемой строкой состояния.
• Второй открывает другой 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 элемент) или FORM элемент, который использует TARGET атрибут для открытия URL-адреса в новом окне. Следующий HTML-код открывает новое окно с именем orderWindow , когда пользователь щелкает его:

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

Если указать какие-либо параметры для windowOptions параметра, любой параметр, не включенный, автоматически отключается. Другими словами, если указать windowOptions только строку состояния, то строка меню, панель инструментов, заголовок, полосы прокрутки и т. д. не будут отображаться, если вы явно не включите их с помощью windowOptions.

Если файл, на который ссылается , является HTML-файлом, текстовым файлом url или файлом другого типа, который может размещаться в интернет-Обозреватель, он будет отображаться в именованном окне. Если файл не может отображаться внутри интернет-Обозреватель, а окно с именем целевого объекта еще не существует, окно будет открываться достаточно долго, чтобы интернет-Обозреватель скачать ресурс; оно закроется сразу же после этого.

При создании новых окон с помощью Open или OpenNewобъектная модель html-документов открывает новый экземпляр интернет-Обозреватель. Если вы не вызываете Close во всех созданных окнах, этот экземпляр интернет-Обозреватель будет работать даже после завершения работы приложения.

Если вы используете Open для загрузки URL-адреса в существующем окне, будет игнорироваться. windowOptions В окне будут сохранены размеры, внешний вид и расположение экрана, сначала заданные при первоначальном вызове Open.

См. также раздел

• Метод open