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有效或改变时激发 |