开关控件(Switch)

Guition 开关控件允许您在界面上添加开关按钮,用于控制某些功能或状态的开启和关闭,具有多种可设置的属性,使您能够自定义开关的外观和行为。

可设置的属性值说明:

  1. 颜色 (color):

    • 类型: 字符串(十六进制颜色代码)

    • 默认值: 无

    • 说明: 设置开关按钮的前景色,即开关处于开启状态时的颜色。

  2. 背景颜色 (bgcolor):

    • 类型: 字符串(十六进制颜色代码)

    • 默认值: 无

    • 说明: 设置开关按钮的背景色,即开关处于关闭状态时的颜色。

  3. 横坐标 (x):

    • 类型: 整数

    • 默认值: 0

    • 说明: 设置开关按钮左上角的横坐标位置。

  4. 纵坐标 (y):

    • 类型: 整数

    • 默认值: 0

    • 说明: 设置开关按钮左上角的纵坐标位置。

  5. 宽度 (w):

    • 类型: 整数

    • 默认值: 100

    • 说明: 设置开关按钮的宽度。

  6. 高度 (h):

    • 类型: 整数

    • 默认值: 30

    • 说明: 设置开关按钮的高度。

  7. 初始值 (val):

    • 类型: 整数(0 或 1)

    • 默认值: 0

    • 说明: 设置开关按钮的初始状态,0 表示关闭,1 表示开启。

  8. 可见性 (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开关控件的完整属性说明和示例。