WebBrowser控件使用详解

### WebBrowser 控件使用详解 #### 一、概述 `WebBrowser` 控件是一个功能强大的组件，用于在 Windows 应用程序中展示 HTML 内容。它可以用来浏览互联网上的网页，也可以用来显示本地的 HTML 文件或者自定义的文档格式。通过使用 `WebBrowser` 控件，开发人员能够方便地集成浏览器功能到他们的应用程序中。 #### 二、方法详解 - **GoBack**: 此方法等同于 Internet Explorer 的“后退”按钮，可以使用户在当前的历史记录列表中后退一项。 - **GoForward**: 类似于 IE 的“前进”按钮，允许用户在当前历史记录列表中前进一项。 - **GoHome**: 相当于 IE 的“主页”按钮，可以将 WebBrowser 控件重定向到用户默认的主页。 - **GoSearch**: 与 IE 的“搜索”按钮类似，可连接到用户的默认搜索引擎页面。 - **Navigate**: 该方法用于导航到指定的 URL 地址。 - **Refresh**: 用于刷新当前页面。 - **Refresh2**: 同样用于刷新当前页面，但是可以指定刷新级别，这可以通过 RefreshConstants 枚举来实现： - REFRESH_NORMAL: 执行简单的刷新，不会将 HTTP pragma:no-cache 头发送给服务器。 - REFRESH_IFEXPIRED: 只有当网页已过期时才会进行简单的刷新。 - REFRESH_CONTINUE: 内部使用，文档明确表示不要使用。 - REFRESH_COMPLETELY: 将包含 pragma:no-cache 头的请求发送到服务器，确保完全刷新。 - **Stop**: 类似于 IE 的“停止”按钮，可以立即停止当前页面及其内容的加载。 #### 三、属性详解 - **Application**: 如果该对象有效，则返回掌管 `WebBrowser` 控件的应用程序实现的自动化对象 (IDispatch)。如果在宿主对象中自动化对象无效，此程序将返回 `WebBrowser` 控件的自动化对象。 - **Parent**: 返回 `WebBrowser` 控件的父自动化对象，通常是容器对象，例如宿主或 IE 窗口。 - **Container**: 返回 `WebBrowser` 控件容器的自动化对象。通常该值与 Parent 属性返回的值相同。 - **Document**: 为当前显示的文档返回自动化对象。如果 HTML 当前正被显示在 `WebBrowser` 中，则 Document 属性提供了对 DHTML 对象模型的访问途径。 - **TopLevelContainer**: 返回一个布尔值，表明 IE 是否是 `WebBrowser` 控件的顶层容器，如果是则返回 true。 - **Type**: 返回已被 `WebBrowser` 控件加载的对象的类型。例如，如果加载的是 .doc 文件，则会返回 Microsoft Word Document。 - **Left** 和 **Top**: 分别返回或设置 `WebBrowser` 控件窗口的内部左边缘和顶部边缘与容器窗口相应边缘的距离。 - **Width** 和 **Height**: 分别返回或设置 `WebBrowser` 控件窗口的宽度和高度，单位为像素。 - **LocationName**: 返回一个字符串，该字符串包含 `WebBrowser` 当前显示的资源的名称，例如如果资源是网页，则是网页的标题；如果是文件或文件夹，则是文件或文件夹的名称。 - **LocationURL**: 返回 `WebBrowser` 当前正在显示的资源的 URL。 - **Busy**: 返回一个布尔值，说明 `WebBrowser` 当前是否正在加载 URL。如果返回 true，则可以使用 Stop 方法来取消正在执行的访问操作。 #### 四、事件 - **BeforeNavigate2**: 在导航发生之前触发，刷新时不会触发。 - **CommandStateChange**: 当命令的激活状态改变时触发。它可以指示何时激活或禁用 Back 和 Forward 菜单项或按钮。 - **DocumentComplete**: 当整个文档加载完成时触发，刷新页面时不会触发。 - **DownloadBegin**: 当下载操作开始时触发，刷新也可以触发此事件。 - **DownloadComplete**: 当下载操作完成时触发，刷新也可以触发此事件。 - **NavigateComplete2**: 在导航完成之后触发，刷新时不会触发。 - **NewWindow2**: 在创建新窗口之前触发。 - **OnFullScreen**: 当 FullScreen 属性改变时触发。该事件接受一个 VARIENT_BOOL 类型的输入参数，指示浏览器处于全屏模式 (VARIENT_TRUE) 还是普通模式 (VARIANT_FALSE)。 - **OnMenuBar**: 改变菜单栏的可见性时触发。 #### 五、总结 `WebBrowser` 控件提供了丰富的功能和灵活性，使得开发人员能够在自己的应用程序中轻松集成浏览器的功能。通过了解其方法、属性和事件，开发者可以更好地控制 `WebBrowser` 控件的行为，从而为用户提供更加流畅和定制化的体验。