HtmlWindow.Open Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Отображает файл в именованном окне.

Перегрузки

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 , открывается urlString в окне, в котором размещается его FRAMESET. В противном случае действует так же, как _self.

windowOptions
String

Строка с разделителями-запятыми, состоящая из нуля или нескольких следующих параметров в формате name=value. leftЗа исключением параметров , top, heightи width , которые принимают произвольные целые числа, каждый параметр принимает в качестве допустимых yes значений или 1, и no или 0.

channelmode: используется с устаревшей технологией каналов Internet Обозреватель 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.

Возвращаемое значение

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.

Применяется к

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 , открывается url в окне, в котором размещается его FRAMESET. В противном случае действует так же, как _self.

windowOptions
String

Строка с разделителями-запятыми, состоящая из нуля или нескольких следующих параметров в формате name=value. leftЗа исключением параметров , top, heightи width , которые принимают произвольные целые числа, каждый параметр принимает в качестве допустимых yes значений или 1, и no или 0.

channelmode: используется с устаревшей технологией каналов Internet Обозреватель 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

Окно 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.

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

Применяется к