HtmlWindow.Open Метод

Определение

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

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

Имя.	Описание
Open(String, String, String, Boolean)	Отображает файл в именованном окне.
Open(Uri, String, String, Boolean)	Отображает файл в именованном окне.

Open(String, String, String, Boolean)

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

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

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

windowOptions: String

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

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: отображаются ли кнопки панели инструментов, такие как Back, Forward и Stop . По умолчанию — 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

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

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

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

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

Open(Uri, String, String, Boolean)

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

Исходный код:: HtmlWindow.cs

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

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

windowOptions: String

channelmode: используется с устаревшей технологией каналов Internet Explorer 4.0. По умолчанию — no.

directories: должно ли окно отображать кнопки навигации каталога. По умолчанию — yes.

menubar: следует ли отображать меню в новом окне. По умолчанию — yes.

resizable: можно ли изменить размер окна пользователем. По умолчанию — yes.

scrollbars: имеет ли окно горизонтальные и вертикальные полосы прокрутки. По умолчанию — yes.

status: имеет ли окно строку состояния в нижней части. По умолчанию — yes.

toolbar: отображаются ли кнопки панели инструментов, такие как Back, Forward и Stop . По умолчанию — yes.

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

См. также

Метод open

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

Обратная связь

Были ли сведения на этой странице полезными?

HtmlWindow.Open Метод

Определение

Перегрузки

Open(String, String, String, Boolean)

Параметры

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

Комментарии

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

Open(Uri, String, String, Boolean)

Параметры

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

Примеры

Комментарии

См. также

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