HtmlWindow Класс

Ссылка

Определение

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

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

Важно!

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

Представляет логическое окно, в котором содержится один или несколько экземпляров 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()	Выступает в качестве хэш-функции для определенного типа.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
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)	Перемещает окно в указанные координаты.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Операторы

Equality(HtmlWindow, HtmlWindow)	Сравнивает два объекта HtmlWindow, чтобы определить, равны ли они.
Inequality(HtmlWindow, HtmlWindow)	Сравнивает два объекта `HtmlWindow`, чтобы определить их неравенство.

События

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

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