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 在同一窗口中打开另一个 URL，但指定只应显示位置栏。 请注意，窗口的维度和显示的控件取决于首先打开的 URL。 The 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 窗体或Windows API 中的窗口概念混淆;没有HWND与实例HtmlWindow直接对应的Windows资源。 相反， HtmlWindow 提供用户屏幕上文档位置的高级说明，以及通过提示和对话框与用户交互的方法。 HtmlWindow 充当网页文档及其元数据的逻辑容器，例如文档的位置和 Web 浏览器的功能。

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