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