HtmlWindow Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

HtmlWindow.cs

Представляет логическое окно, содержащее один или несколько экземпляров HtmlDocument.

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Наследование

Object

HtmlWindow

Примеры

В следующем примере кода содержится два метода. Первый открывает 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

Комментарии

HtmlWindow не следует путать с понятием окна в Windows Forms или API Windows; Нет HWND или аналогичный ресурс Windows, соответствующий непосредственно экземпляру HtmlWindow. Скорее, HtmlWindow предоставляет высокоуровневые описания расположения документа на экране пользователя, а также методы взаимодействия с пользователями путем запросов и диалоговых окон. HtmlWindow выступает в качестве логического контейнера для документов веб-страницы и его метаданных, таких как расположение документа и возможности веб-браузера.

Веб-страница состоит из одного документа или FRAMESET одного или нескольких FRAME элементов, каждый из которых размещает собственный документ. Веб-разработчики используют наборы кадров для отображения логически связанных страниц параллельно (например, страницы содержимого рядом со страницей навигации). Если страница состоит из одного документа, доступ к нему можно получить через Document свойство HtmlWindow; если страница использует кадры, вы можете получить доступ к своим документам через Frames коллекцию, которая состоит из одного или нескольких HtmlWindow объектов.

При размещении WebBrowser элемента управления в приложении Windows Forms вы можете взаимодействовать с пользователем, используя стандартные классы Windows Forms, например Form или MessageBoxметоды HtmlWindow , определенные для этой цели. Метод Alert представляет простое диалоговое окно с настраиваемым текстом и кнопкой "ОК "; Prompt представляет строку пользовательского текста и поле ввода текста пользователю; и Confirm представляет диалоговое окно со строкой пользовательского текста и кнопками "ОК " и " Отмена ".

Можно использовать HtmlWindow для открытия новых окон, содержащих новые документы. Open загружает указанный URL-адрес в именованное окно, создавая его, если он еще не существует, а OpenNew всегда открывает его URL-адрес в только что созданном окне.

Свойства

Имя	Описание
Document	Возвращает HTML-документ, содержащийся в окне.
DomWindow	Возвращает неуправляемый интерфейс, упакованный этим классом.
Frames	Получает ссылку на каждый из элементов, определенных FRAME на веб-странице.
History	Возвращает объект, содержащий недавно посещаемые URL-адреса пользователя.
IsClosed	Возвращает значение, указывающее, открыто ли это окно или закрыто.
Name	Возвращает или задает имя окна.
Opener	Возвращает ссылку на окно, открывающее текущее окно.
Parent	Возвращает окно, которое находится над текущим на странице, содержащей кадры.
Position	Возвращает положение клиентской области окна на экране.
Size	Возвращает или задает размер текущего окна.
StatusBarText	Возвращает или задает текст, отображаемый в строке состояния окна.
Url	Возвращает URL-адрес, соответствующий текущему элементу, отображаемого в окне.
WindowFrameElement	Возвращает элемент кадра, соответствующий этому окну.

Методы

Имя	Описание
Alert(String)	Отображает окно сообщения.
AttachEventHandler(String, EventHandler)	Добавляет обработчик событий для именованного события HTML DOM.
Close()	Закрывает окно.
Confirm(String)	Отображает диалоговое окно с сообщением и кнопками, чтобы запрашивать ответ "да/нет".
DetachEventHandler(String, EventHandler)	Удаляет именованный обработчик событий.
Equals(Object)	Проверяет объект на равенство по текущему объекту.
Focus()	Помещает фокус в текущее окно.
GetHashCode()	Служит хэш-функцией для определенного типа.
MoveTo(Int32, Int32)	Перемещает окно на указанные координаты на экране.
MoveTo(Point)	Перемещает окно на указанные координаты на экране.
Navigate(String)	Отображает или скачивает новое содержимое, расположенное по указанному URL-адресу.
Navigate(Uri)	Отображает новый документ в текущем окне.
Open(String, String, String, Boolean)	Отображает файл в именованном окне.
Open(Uri, String, String, Boolean)	Отображает файл в именованном окне.
OpenNew(String, String)	Отображает файл в новом окне.
OpenNew(Uri, String)	Отображает файл в новом окне.
Prompt(String, String)	Отображает диалоговое окно, отображающее сообщение и текстовое поле для пользователя.
RemoveFocus()	Отключает фокус от текущего окна.
ResizeTo(Int32, Int32)	Изменяет размер окна на указанные измерения.
ResizeTo(Size)	Изменяет размер окна на указанные измерения.
ScrollTo(Int32, Int32)	Прокручивает окно до указанной позиции.
ScrollTo(Point)	Перемещает окно в указанные координаты.

Операторы

Имя	Описание
Equality(HtmlWindow, HtmlWindow)	Проверяет два HtmlWindow объекта для равенства.
Inequality(HtmlWindow, HtmlWindow)	Проверяет два HtmlWindow объекта для неравенства.

События

Имя	Описание
Error	Происходит, когда скрипт, запущенный в окне, обнаруживает ошибку во время выполнения.
GotFocus	Происходит, когда текущее окно получает фокус ввода пользователей.
Load	Происходит, когда документ окна и все его элементы завершили инициализацию.
LostFocus	Происходит, когда фокус ввода пользователя покинул окно.
Resize	Происходит, когда пользователь использует мышь для изменения измерений окна.
Scroll	Происходит, когда пользователь прокручивает окно для просмотра внеэкранного текста.
Unload	Происходит при выгрузке текущей страницы, а новая страница будет отображаться.

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

• Объект window
• Интерфейс IHTMLWindow2