Form 窗体

文章目录

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

介绍

QUI窗体界面, 所有控件都在这个窗体上绘制显示

属性

基本属性	数据类型	读写类型	说明
Name	标识符	不可读写	名称, 仅开发时可修改, 任意有效的标识符, 表示代码中使用该窗体的名称
Visible	布尔型	只读	显示, 表示该窗体是否可以被看到, 在窗体中仅支持 `True`
Enabled	布尔型	只读	有效, 表示该窗体是否响应用户生成事件, 在窗体中仅支持 `True`
Caption	字符串	可读可写	标题, 返回或设置窗体的标题栏或图标下面的文本

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

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

其他属性	数据类型	读写类型	说明
Picture	字符串	可读可写	图像路径, 返回或设置窗体的背景图片, 不支持附件路径
ShowPosition	整数型	不可读写	显示位置, 仅支持开发时设置窗体首次出现的位置

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

方法

方法名称	参数	返回	说明
Close	无	无	关闭窗体界面, 将已经打开的窗体关闭, 会触发 `UnLoad` 卸载事件
Hide	无	无	隐藏窗体界面, 将已经打开的窗体隐藏
SaveSetting	无	无	保存控件属性值, 与点击保存设置按钮的效果相同
LoadSetting	无	无	加载控件属性值, 将上次保存的数据加载到界面上
Show	无	无	显示窗体界面, 显示一个创建的窗体界面, 会触发 `Load` 加载事件和 `LoadOver` 加载完成事件
ShowModal	无	无	显示模态窗体界面, 与 `Show` 方法相似, 区别在于模态显示窗体后, 无法操作其他窗体界面

事件

事件名称	参数	返回	说明
Load	无	无	加载事件, 在界面加载之前会触发本事件
LoadOver	无	无	加载完成事件, 在界面加载完成之后会触发本事件
UnLoad	无	无	卸载事件, 在界面关闭之后会触发本事件

示例

//事件例子
Event Form1.Load
    MessageBox "我是加载事件"
End Event 

Event Form1.LoadOver
    MessageBox "我是加载完成事件"
End Event 

Event Form1.UnLoad
    MessageBox "我是卸载事件"
End Event

备注

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