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

示例

下面的代码示例包含两种方法。 第一个 在名为 displayWindow的窗口中打开一个 URL，该窗口创建并显示状态栏。 第二个窗口在同一窗口中打开另一个 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 窗体或 Windows API 中的窗口概念混淆;不存在 HWND 直接对应于 实例或类似的 HtmlWindowWindows 资源。 HtmlWindow而是提供用户屏幕上文档位置的高级说明，以及通过提示和对话框与用户交互的方法。 HtmlWindow 充当网页文档及其元数据的逻辑容器，例如文档的位置和 Web 浏览器的功能。

网页由单个文档或 FRAMESET 包含一个或多个 FRAME 元素（每个元素承载自己的文档）组成。 Web 开发人员使用框架集并排显示逻辑相关的页面 (例如，导航页旁边的内容页) 。 当页面包含单个文档时，可以通过 的 HtmlWindow属性访问它Document;如果页面使用框架，则可以通过Frames由一个或多个 HtmlWindow 对象组成的集合访问其文档。

在 Windows 窗体应用程序中托管 WebBrowser 控件时，可以选择使用标准 Windows 窗体类（如 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	当正在卸载当前页，而一个新页即将显示时发生。

另请参阅

• window 对象
• IHTMLWindow2 接口