## 复合指令功能和用法

### 1. 介绍

复合指令是一种在 Guition 平台中使用的功能，允许用户一次性发送多个指令来控制界面中的多个控件，从而实现复杂的界面操作和交互效果，其本质就是将多个基本指令或控件指令组合为一个json数组，数组内的指令会顺序执行。

### 2. 功能

复合指令允许用户在一个指令中包含多个控件的设置和操作，可以同时设置这些控件的属性值或执行特定的事件。

### 3. 用法

下面是一个复合指令的示例，包含了多个控件的设置和操作：

```json
[
    {
        "name": "dd0",
        "prop": {
            "txt": "hello1\nhello2\nhello3",
            "color": "#FF0000",
            "bgcolor": "#00FF00",
            "bgopa": 60,
            "opa": 100,
            "font": 0,
            "x": 200,
            "y": 100,
            "w": 150,
            "h": 50,
            "vis": 1,
            "val": 0
        },
        "do": "select"
    },
    {
        "name": "sw0",
        "prop": {
            "color": "#FF0000",
            "bgcolor": "#00FF00",
            "x": 200,
            "y": 100,
            "w": 150,
            "h": 50,
            "val": 0,
            "vis": 1
        },
        "do": "open"
    },
    {
        "name": "Text_QeQP_Mi46",
        "prop": {
            "txt": "hello,world",
            "color": "#FF0000",
            "bgcolor": "#00FF00",
            "bgopa": 60,
            "opa": 100,
            "font": 0,
            "xcen": 0,
            "x": 200,
            "y": 100,
            "w": 150,
            "h": 50,
            "vis": 1
        }
    },
    {
        "name": "arc0",
        "prop": {
            "color": "#FF0000",
            "bgcolor": "#00FF00",
            "bgopa": 60,
            "color2": "#0000FF",
            "val": 50,
            "x": 200,
            "y": 100,
            "h": 10,
            "w": 30,
            "vis": 1
        },
        "do": "value"
    },
    {
        "page": [
            "page1",
            0
        ]
    }
]

```

### 4. 示例说明

*   第一个指令设置了名为 `dd0` 的控件的属性，并执行了 `select` 事件。
*   第二个指令设置了名为 `sw0` 的控件的属性，并执行了 `open` 事件。
*   第三个指令设置了名为 `Text_QeQP_Mi46` 的控件的属性。
*   第四个指令设置了名为 `arc0` 的控件的属性，并执行了 `value` 事件。
*   最后一个指令跳转至名为 `page1` 的页面。

### 5. 提示

通过使用复合指令，用户可以在一次性操作中实现多个控件的设置和事件执行，提高了界面控制的灵活性和效率。使用复合指令时，请保证文本长度不要超过最大串口缓冲区的长度。