开关控件(Switch)
Guition 开关控件允许您在界面上添加开关按钮,用于控制某些功能或状态的开启和关闭,具有多种可设置的属性,使您能够自定义开关的外观和行为。
可设置的属性值说明:
颜色 (color):
类型: 字符串(十六进制颜色代码)
默认值: 无
说明: 设置开关按钮的前景色,即开关处于开启状态时的颜色。
背景颜色 (bgcolor):
类型: 字符串(十六进制颜色代码)
默认值: 无
说明: 设置开关按钮的背景色,即开关处于关闭状态时的颜色。
横坐标 (x):
类型: 整数
默认值: 0
说明: 设置开关按钮左上角的横坐标位置。
纵坐标 (y):
类型: 整数
默认值: 0
说明: 设置开关按钮左上角的纵坐标位置。
宽度 (w):
类型: 整数
默认值: 100
说明: 设置开关按钮的宽度。
高度 (h):
类型: 整数
默认值: 30
说明: 设置开关按钮的高度。
初始值 (val):
类型: 整数(0 或 1)
默认值: 0
说明: 设置开关按钮的初始状态,0 表示关闭,1 表示开启。
可见性 (vis):
类型: 布尔值(0 或 1)
默认值: 1
说明: 设置开关按钮是否可见,1 表示可见,0 表示隐藏。
do (事件动作):
类型: 字符串
可设置的属性值“open”,“close”
说明: 指定当开关状态发生变化时执行的事件动作。通常用于定义开关状态改变时所触发的操作,例如打开或关闭某个功能或切换某个状态。
在上面的示例中,设置了开关控件的属性,并指定了开关状态变化时要执行的事件动作为 “open”。具体的事件动作取决于应用场景的需求。
通过串口指令设置属性示例:
{
"name": "sw0",
"prop": {
"color": "#FF0000",
"bgcolor": "#00FF00",
"x": 200,
"y": 100,
"w": 150,
"h": 50,
"val": 0,
"vis": 1
},
"do": "open"
}
说明:
在上面的示例中,设置了一个开关控件的属性,包括颜色、背景颜色、位置、大小、初始值和可见性。 当开关被打开时,执行打开事件,其行为根据具体的应用场景而定。
开关控件(Switch)属性设置示例
1. 设置开关控件名称 (name)
名称属性用于指定开关控件的唯一标识。
{
"name": "sw0",
"prop": {
"txt": "Switch 1"
}
}
2. 设置开关控件文本内容 (txt)
文本内容属性用于设置开关控件显示的文本信息。
{
"name": "sw0",
"prop": {
"txt": "Hello, World"
}
}
3. 设置开关控件颜色 (color)
颜色属性用于指定开关控件文本的颜色。
{
"name": "sw0",
"prop": {
"color": "#FF0000"
}
}
4. 设置开关控件背景色 (bgcolor)
背景色属性用于指定开关控件的背景颜色。
{
"name": "sw0",
"prop": {
"bgcolor": "#00FF00"
}
}
5. 设置开关控件横坐标 (x)
横坐标属性用于指定开关控件左上角的横坐标位置。
{
"name": "sw0",
"prop": {
"x": 200
}
}
6. 设置开关控件纵坐标 (y)
纵坐标属性用于指定开关控件左上角的纵坐标位置。
{
"name": "sw0",
"prop": {
"y": 100
}
}
7. 设置开关控件宽度 (w)
宽度属性用于指定开关控件的宽度。
{
"name": "sw0",
"prop": {
"w": 150
}
}
8. 设置开关控件高度 (h)
高度属性用于指定开关控件的高度。
{
"name": "sw0",
"prop": {
"h": 50
}
}
9. 设置开关控件可见性 (vis)
可见性属性用于设置开关控件是否可见,1 表示可见,0 表示隐藏。
{
"name": "sw0",
"prop": {
"vis": 1
}
}
10. 设置开关控件值 (val)
值属性用于设置开关控件的当前值,通常用于表示开关的状态。
{
"name": "sw0",
"prop": {
"val": 0
}
}
11. 执行开关控件点击事件 (do)
点击事件属性用于指定开关控件的点击事件,以响应用户的交互动作。
{
"name": "sw0",
"do": "click"
}
以上是关于Guition开关控件的完整属性说明和示例。