2021-04-06

Form.WebBrowser 浏览器

文章目录

1. 介绍
2. 属性
3. 方法
4. 事件
5. 示例
6. 备注

介绍

QUI的浏览器控件, 相当于内置了一个浏览器

属性

基本属性	数据类型	读写类型	说明
Name	标识符	不可读写	名称, 仅开发时可修改, 任意有效的标识符, 表示代码中使用该控件的名称
Visible	布尔型	可读可写	显示, 返回或设置该控件是否可以被看到
Enabled	布尔型	可读可写	有效, 返回或设置该控件是否响应用户生成事件
Url	字符串	可读可写	网页地址, 返回或设置要打开的网页地址

位置属性	数据类型	读写类型	说明
Left	整数型	可读可写	左边, 返回或设置该控件的左边缘与容器左边缘之间的距离
Top	整数型	可读可写	上边, 返回或设置该控件的顶边缘与容器顶边缘之间的距离
Width	整数型	可读可写	宽度, 返回或设置该控件的宽度
Height	整数型	可读可写	高度, 返回或设置该控件的高度
ZOrder	整数型	可读可写	显示顺序, 返回或设置该控件的显示顺序

外观属性	数据类型	读写类型	说明
Appearance	整数型	可读可写	外形, 返回或设置该控件的外观显示造型, `0`:直角, `1`:圆角
ColorScheme	整数型	可读可写	配色方案, 返回或设置该控件的颜色配置方案, `0`:红, `1`:橙, `2`:黄, `3`:绿, `4`:青, `5`:蓝, `6`:紫, `7`:自定义
BorderColor	字符串	可读可写	边框颜色, 返回或设置该控件的边框颜色, 格式为十六进制的`"BBGGRR"`

隐藏属性	数据类型	读写类型	说明
Hwnd	整数型	只读	句柄, 返回控件的句柄

方法

浏览器方法	参数	返回	说明
Back	无	无	后退操作, 执行浏览器的后退功能
Forward	无	无	前进操作, 执行浏览器的前进功能
Refresh	无	无	刷新页面, 执行浏览器的刷新页面功能
GetURL	无	网址	得到当前页面网址
GetTitle	无	标题	获取当前页面标题
GetIEHwnd	无	句柄	获取当前页面句柄
ScrollTo	坐标x, 坐标y	无	网页滚到到指定位置
Save	网址, 保存路径	无	保存网页或图片
CleanCookie	方式	无	清空IE缓存 `0`:删除所有 `1`:不删除临时文件而仅删除Cookie `2`:不删除Cookie而仅删除临时文件

元素方法	参数	返回	说明
HtmlClick	元素特征串	无	点击页面元素
SendString	文本内容	无	输入文本内容
HtmlInput	内容, 元素特征串	无	往文本框中输入文字
HtmlCheck	选中, 元素特征串	无	选择/清除单选框或复选框
HtmlSelect	索引, 元素特征串	无	选择页面下拉框
HtmlGet	类型, 元素特征串	信息	获取页面元素信息支持`Text`/`Value`/`Src`/`Class`/`Href`/`Offset`
HtmlExists	元素特征串	是否存在	判断页面元素是否存在
RunJS	类型, JS语句	无	在当前页面中执行JS脚本

事件

事件名称	参数	返回	说明
DocumentComplete	无	无	页面加载完成, 当网页加载完成时触发执行本事件

示例

//首先 在界面上放1个“按钮控件”和1个“浏览器控件”。。
//其次 复制以下脚本进行调试：

Event Form1.Load '加载事件
    Form1.WebBrowser1.Url = "bbs.zimaoxy.com"
    Form1.Button1.Caption = "点击访问论坛"
End Event
Event Form1.Button1.Click '按钮1事件
    //以下使用“网页按键精灵”网页分析功能查找元素特征串
    Form1.WebBrowser1.HtmlClick "tag:A&txt:论坛"
End Event

备注

绘制QUI界面与控件方法如下
- 点击按键精灵编辑器左边的 界面 按钮
- 点击 设置界面 按钮后, 脚本界面将由QUI接管
- 点击 控件列表 中的控件, 在中间窗体上按住鼠标左键并移动鼠标后松开, 即可放入对应控件
- 右上方的 窗体 可增加新的界面窗口
- 窗体和控件的可以自由拉伸调整大小
- 右边的 属性 栏可选择对应控件与修改属性
- 右下方有个 点击这里选择控件的响应事件 下拉框, 可自动生成事件代码
网页特征元素可使用网页按键精灵来查找分析获取