Поделиться через


HtmlWindow Класс

Определение

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

public ref class HtmlWindow sealed
public sealed class HtmlWindow
type HtmlWindow = class
Public NotInheritable Class HtmlWindow
Наследование
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

Происходит при выгрузке текущей страницы и сразу перед отображением новой страницы.

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

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