复合指令功能和用法

1. 介绍

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

2. 功能

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

3. 用法

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

[
    {
        "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. 提示

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