【转载】WebBrowser控件的常用方法、属性和事件
1. 属性
| 属性 | 说明 |
|---|---|
| Application | 如果该对象有效,则返回掌管WebBrowser控件的应用程序实现的自动化对象(IDispatch)。如果在宿主对象中自动化对象无效,这个程序将返回WebBrowser 控件的自动化对象 |
| Parent | 返回WebBrowser控件的父自动化对象,通常是一个容器,例如是宿主或IE窗口 |
| Container | 返回WebBrowser控件容器的自动化对象。通常该值与Parent属性返回的值相同 |
| Document | 为活动的文档返回自动化对象。如果HTML当前正被显示在WebBrowser中,则 Document属性提供对DHTML Object Model的访问途径 |
| TopLevelContainer | 返回一个Boolean值,表明IE是否是WebBrowser控件顶层容器,是就返回true |
| Type | 返回已被WebBrowser控件加载的对象的类型。例如:如果加载.doc文件,就会返 回Microsoft Word Document |
| Left | 返回或设置WebBrowser控件窗口的内部左边与容器窗口左边的距离 |
| Top | 返回或设置WebBrowser控件窗口的内部左边与容器窗口顶边的距离 |
| Width | 返回或设置WebBrowser窗口的宽度,以像素为单位 |
| Height | 返回或设置WebBrowser窗口的高度,以像素为单位 |
| LocationName | 返回一个字符串,该字符串包含着WebBrowser当前显示的资源的名称,如果资源 是网页就是网页的标题;如果是文件或文件夹,就是文件或文件夹的名称 |
| LocationURL | 返回WebBrowser当前正在显示的资源的URL |
| Busy | 返回一个Boolean值,说明WebBrowser当前是否正在加载URL,如果返回true 就可以使用stop方法来撤销正在执行的访问操作 |
2. 方法
| 方法 | 说明 |
|---|---|
| GoBack | 相当于IE的“ 后退 ”按钮,使你在当前历史列表中后退一项 |
| GoForward | 相当于IE的“ 前进 ”按钮,使你在当前历史列表中前进一项 |
| GoHome | 相当于IE的“ 主页 ”按钮,连接用户默认的主页 |
| GoSearch | 相当于IE的“ 搜索 ”按钮,连接用户默认的搜索页面 |
| Navigate | 连接到指定的URL |
| Refresh | 刷新当前页面 |
| Refresh2 | 同上,只是可以指定刷新级别,所指定的刷新级别的值来自RefreshConstants枚举表, 该表定义在ExDisp.h中,可以指定的不同值如下: REFRESH_NORMAL 执行简单的刷新,不将 HTTP pragma: no-cache头发送给服务器 REFRESH_IFEXPIRED 只有在网页过期后才进行简单的刷新 REFRESH_CONTINUE 仅作内部使用。在MSDN里写着DO NOT USE! 请勿使用 REFRESH_COMPLETELY 将包含 pragma: no-cache头的请求发送到服务器 |
| Stop | 相当于IE的“ 停止 ”按钮,停止当前页面及其内容的载入 |
3. 事件
| Private Events | Description |
|---|---|
| BeforeNavigate2 | 导航发生前激发,刷新时不激发 |
| CommandStateChange | 当命令的激活状态改变时激发。它表明何时激活或关闭Back和Forward 菜单项或按钮 |
| DocumentComplete | 当整个文档完成是激发,刷新页面不激发 |
| DownloadBegin | 当某项下载操作已经开始后激发,刷新也可激发此事件 |
| DownloadComplete | 当某项下载操作已经完成后激发,刷新也可激发此事件 |
| NavigateComplete2 | 导航完成后激发,刷新时不激发 |
| NewWindow2 | 在创建新窗口以前激发 |
| OnFullScreen | 当FullScreen属性改变时激发。该事件采用VARIENT_BOOL的一个输 入参数来指示IE是全屏显示方式(VARIENT_TRUE)还是普通显示方式(VARIENT_FALSE) |
| OnMenuBar | 改变MenuBar的属性时激发,标示参数是VARIENT_BOOL类型的。 VARIANT_TRUE是可见,VARIANT_ FALSE是隐藏 |
| OnQuit | 无论是用户关闭浏览器还是开发者调用Quit方法,当IE退出时就会激发 |
| OnStatusBar | 与OnMenuBar调用方法相同,标示状态栏是否可见。 |
| OnToolBar | 调用方法同上,标示工具栏是否可见。 |
| OnVisible | 控制窗口的可见或隐藏,也使用一个VARIENT_BOOL类型的参数 |
| StatusTextChange | 如果要改变状态栏中的文字,这个事件就会被激发,但它并不理会程序是否有状态栏 |
| TitleChange | Title有效或改变时激发 |