### 开关控件（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"。具体的事件动作取决于应用场景的需求。

**通过串口指令设置属性示例：**

```json
{
    "name": "sw0",
    "prop": {
        "color": "#FF0000",
        "bgcolor": "#00FF00",
        "x": 200,
        "y": 100,
        "w": 150,
        "h": 50,
        "val": 0,
        "vis": 1
    },
    "do": "open"
}

```

**说明:**

在上面的示例中，设置了一个开关控件的属性，包括颜色、背景颜色、位置、大小、初始值和可见性。 当开关被打开时，执行打开事件，其行为根据具体的应用场景而定。

#### 开关控件（Switch）属性设置示例

**1. 设置开关控件名称 (name)**

名称属性用于指定开关控件的唯一标识。

```json
{
    "name": "sw0",
    "prop": {
        "txt": "Switch 1"
    }
}

```

**2. 设置开关控件文本内容 (txt)**

文本内容属性用于设置开关控件显示的文本信息。

```json
{
    "name": "sw0",
    "prop": {
        "txt": "Hello, World"
    }
}

```

**3. 设置开关控件颜色 (color)**

颜色属性用于指定开关控件文本的颜色。

```json
{
    "name": "sw0",
    "prop": {
        "color": "#FF0000"
    }
}

```

**4. 设置开关控件背景色 (bgcolor)**

背景色属性用于指定开关控件的背景颜色。

```json
{
    "name": "sw0",
    "prop": {
        "bgcolor": "#00FF00"
    }
}

```

**5. 设置开关控件横坐标 (x)**

横坐标属性用于指定开关控件左上角的横坐标位置。

```json
{
    "name": "sw0",
    "prop": {
        "x": 200
    }
}

```

**6. 设置开关控件纵坐标 (y)**

纵坐标属性用于指定开关控件左上角的纵坐标位置。

```json
{
    "name": "sw0",
    "prop": {
        "y": 100
    }
}

```

**7. 设置开关控件宽度 (w)**

宽度属性用于指定开关控件的宽度。

```json
{
    "name": "sw0",
    "prop": {
        "w": 150
    }
}

```

**8. 设置开关控件高度 (h)**

高度属性用于指定开关控件的高度。

```json
{
    "name": "sw0",
    "prop": {
        "h": 50
    }
}

```

**9. 设置开关控件可见性 (vis)**

可见性属性用于设置开关控件是否可见，1 表示可见，0 表示隐藏。

```json
{
    "name": "sw0",
    "prop": {
        "vis": 1
    }
}

```

**10. 设置开关控件值 (val)**

值属性用于设置开关控件的当前值，通常用于表示开关的状态。

```json
{
    "name": "sw0",
    "prop": {
        "val": 0
    }
}

```

**11. 执行开关控件点击事件 (do)**

点击事件属性用于指定开关控件的点击事件，以响应用户的交互动作。

```json
{
    "name": "sw0",
    "do": "click"
}

```

以上是关于Guition开关控件的完整属性说明和示例。