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 или Windows API; Нет HWND или аналогичного ресурса Windows, который напрямую соответствует экземпляру HtmlWindow. HtmlWindow Вместо этого предоставляет высокоуровневые описания расположения документа на экране пользователя, а также методы взаимодействия с пользователями с помощью запросов и диалоговых окон. HtmlWindow выступает в качестве логического контейнера для документов веб-страницы и ее метаданных, таких как расположение документа и возможности веб-браузера.

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

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

Бөлісу құралы: