HtmlWindow Класс

Определение

Представляет логическое окно, в котором содержится один или несколько экземпляров HtmlDocument.Represents the logical window that contains one or more instances of HtmlDocument.

public ref class HtmlWindow sealed
public sealed class HtmlWindow
type HtmlWindow = class
Public NotInheritable Class HtmlWindow
Наследование
HtmlWindow

Примеры

В следующем примере кода содержатся два метода.The following code example contains two methods. Первый открывает URL-адрес в окне с именем displayWindow, которое оно создает с отображаемой строкой состояния.The first opens a URL in a window named displayWindow, which it creates with a status bar displayed. Второй открывает другой URL-адрес в том же окне, но указывает, что должна отображаться только строка расположения.The second opens another URL in the same window, but specifies that only the location bar should be displayed. Обратите внимание, что размеры окна и отображаемые элементы управления зависят от того, какой URL-адрес открыт первым.Notice that the dimensions of the window and the controls that are displayed depends on which URL is opened first. В примере кода требуется, чтобы форма содержала WebBrowser элемент управления с именем. WebBrowser1The code example requires that your form contains a WebBrowser control named 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; отсутствует или похожий ресурс Windows, который непосредственно соответствует HtmlWindowэкземпляру. HWNDHtmlWindow should not be confused with the concept of a window in Windows Forms or the Windows API; there is no HWND or similar Windows resource that corresponds directly to an instance of HtmlWindow. Вместо этого HtmlWindow предоставляет высокоуровневые описания местоположения документа на экране пользователя, а также методы взаимодействия с пользователями с помощью запросов и диалоговых окон.Rather, HtmlWindow provides high-level descriptions of a document's location on a user's screen, as well as methods for interacting with users by way of prompts and dialog boxes. HtmlWindowвыступает в качестве логического контейнера для документов веб-страницы и его метаданных, таких как расположение документа и возможности веб-браузера.HtmlWindow acts as a logical container for a Web page's documents and its metadata, such as the document's location and the capabilities of the Web browser.

Веб-страница состоит из одного документа или FRAMESET , содержащего один или несколько FRAME элементов, каждый из которых содержит собственный документ.A Web page consists of a single document, or a FRAMESET containing one or more FRAME elements, each of which hosts its own document. Веб-разработчики используют наборы рамок для отображения логически связанных страниц рядом (например, страницы содержимого рядом со страницей навигации).Web developers use framesets to show logically related pages side by side (for example, a content page next to a navigation page). Если страница состоит из одного документа, доступ к ней Document можно получить через свойство объекта HtmlWindow; если на странице используются рамки, можно Frames получить доступ к своим документам через коллекцию, которая состоит из одного или нескольких HtmlWindow объектов.When a page consists of a single document, you can access it through the Document property of HtmlWindow; if the page uses frames, you can access their documents through the Frames collection, which consists of one or more HtmlWindow objects.

При размещении WebBrowser элемента управления в Windows Forms приложении можно выбрать взаимодействие с пользователем с помощью стандартных классов Windows Forms, таких как Form или MessageBox, или можно использовать методы HtmlWindow , определенные для этой цели.When your host the WebBrowser control in a Windows Forms application, you can choose to interact with the user using standard Windows Forms classes, such as Form or MessageBox, or you can use methods on HtmlWindow defined for this purpose. Метод представляет простое диалоговое окно с настраиваемым текстом и кнопкой ОК. Alert представляет собой строку пользовательского текста и текстовое поле ввода для пользователя, а Confirm также предоставляет диалоговое окно со строкой пользовательского текста и кнопками ОК и Отмена . PromptThe Alert method presents a simple dialog box with custom text and an OK button; Prompt presents a line of custom text and a text input field to the user; and Confirm presents a dialog box with a line of custom text and OK and Cancel buttons.

Можно использовать HtmlWindow для открытия новых окон, содержащих новые документы.You can use HtmlWindow to open new windows containing new documents. Openзагружает указанный URL-адрес в именованное окно, создавая его, если он еще не существует OpenNew , тогда как всегда открывает его URL-адрес во вновь созданном окне.Open loads the specified URL into the named window, creating it if it does not already exist, while OpenNew always opens its URL in a newly created window.

Свойства

Document

Получает HTML-документ, содержащийся в этом окне.Gets the HTML document contained within the window.

DomWindow

Получает неуправляемый интерфейс, оболочкой для которого является этот класс.Gets the unmanaged interface wrapped by this class.

Frames

Получает ссылку на каждый из элементов FRAME, определенных на веб-странице.Gets a reference to each of the FRAME elements defined within the Web page.

History

Получает объект, содержащий последние посещенные пользователем URL-адреса.Gets an object containing the user's most recently visited URLs.

IsClosed

Получает значение, указывающее, является ли это окно открытым или закрытым.Gets a value indicating whether this window is open or closed.

Name

Получает или задает имя окна.Gets or sets the name of the window.

Opener

Получает ссылку на окно, которое открыло текущее окно.Gets a reference to the window that opened the current window.

Parent

Получает окно, которое располагается над текущим окном на странице, содержащей рамки.Gets the window which resides above the current one in a page containing frames.

Position

Получает положение клиентской области в окне на экране.Gets the position of the window's client area on the screen.

Size

Получает или задает размер текущего окна.Gets or sets the size of the current window.

StatusBarText

Получает или задает текст, отображаемый в строке состояния окна.Gets or sets the text displayed in the status bar of a window.

Url

Получает URL-адрес, соответствующий текущему элементу, отображаемому в окне.Gets the URL corresponding to the current item displayed in the window.

WindowFrameElement

Получает элемент рамки, соответствующий этому окну.Gets the frame element corresponding to this window.

Методы

Alert(String)

Отображает окно сообщения.Displays a message box.

AttachEventHandler(String, EventHandler)

Добавляет обработчик событий для именованного события HTML DOM.Adds an event handler for the named HTML DOM event.

Close()

Закрывает окно.Closes the window.

Confirm(String)

Отображает диалоговое окно с сообщением и кнопками для запроса ответа «Да» или «Нет».Displays a dialog box with a message and buttons to solicit a yes/no response.

DetachEventHandler(String, EventHandler)

Удаляет именованный обработчик событий.Removes the named event handler.

Equals(Object)

Тестирует объект на равенство с текущим объектом.Tests the object for equality against the current object.

Focus()

Перемещает фокус в текущее окно.Puts the focus on the current window.

GetHashCode()

Служит хэш-функцией для определенного типа.Serves as a hash function for a particular type.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MoveTo(Int32, Int32)

Перемещает окно в место, указанное координатами на экране.Moves the window to the specified coordinates on the screen.

MoveTo(Point)

Перемещает окно в место, указанное координатами на экране.Moves the window to the specified coordinates on the screen.

Navigate(String)

Отображает или загружает новое содержимое, расположенное по указанному URL-адресу.Displays or downloads the new content located at the specified URL.

Navigate(Uri)

Отображает новый документ в текущем окне.Displays a new document in the current window.

Open(String, String, String, Boolean)

Отображает файл в именованном окне.Displays a file in the named window.

Open(Uri, String, String, Boolean)

Отображает файл в именованном окне.Displays a file in the named window.

OpenNew(String, String)

Отображает файл в новом окне.Displays a file in a new window.

OpenNew(Uri, String)

Отображает файл в новом окне.Displays a file in a new window.

Prompt(String, String)

Отображает диалоговое окно, в котором отображается сообщение и текстовое окно, предназначенные для пользователя.Shows a dialog box that displays a message and a text box to the user.

RemoveFocus()

Перемещает фокус из текущего окна.Takes focus off of the current window.

ResizeTo(Int32, Int32)

Изменяет размер окна до указанных размеров.Changes the size of the window to the specified dimensions.

ResizeTo(Size)

Изменяет размер окна до указанных размеров.Changes the size of the window to the specified dimensions.

ScrollTo(Int32, Int32)

Прокручивает окно до назначенной позиции.Scrolls the window to the designated position.

ScrollTo(Point)

Перемещает окно в место, указанное координатами.Moves the window to the specified coordinates.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Операторы

Equality(HtmlWindow, HtmlWindow)

Сравнивает два объекта HtmlWindow, чтобы определить, равны ли они.Tests the two HtmlWindow objects for equality.

Inequality(HtmlWindow, HtmlWindow)

Сравнивает два объекта HtmlWindow, чтобы определить их неравенство.Tests two HtmlWindow objects for inequality.

События

Error

Происходит при появлении ошибки во время выполнения в скрипты, выполняющемся в окне.Occurs when script running inside of the window encounters a run-time error.

GotFocus

Происходит при получении текущим окном фокуса пользовательского ввода.Occurs when the current window obtains user input focus.

Load

Происходит после окончания инициализации документа окна и всех его элементов.Occurs when the window's document and all of its elements have finished initializing.

LostFocus

Происходит при потере окном фокуса ввода пользователя.Occurs when user input focus has left the window.

Resize

Происходит при использовании пользователем мыши для изменения размером окна.Occurs when the user uses the mouse to change the dimensions of the window.

Scroll

Происходит при прокрутке пользователем содержимого окна для просмотра текста, находящегося вне экрана.Occurs when the user scrolls through the window to view off-screen text.

Unload

Происходит при выгрузке текущей страницы и сразу перед отображением новой страницы.Occurs when the current page is unloading, and a new page is about to be displayed.

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

Дополнительно