下拉框控件 (ComboBox)
Guition 下拉框控件是一种常用于选择列表中的选项的界面元素,它具有灵活的属性设置,可以通过串口指令动态配置其外观和行为。下面是该控件的各个可设置属性值的说明:
txt: 文本内容
类型: 字符串
说明: 指定下拉框中的选项文本内容,多个选项之间使用换行符(
\n
)分隔。
color: 文本颜色
类型: 字符串 (十六进制颜色代码)
说明: 设置下拉框中文本的颜色。
bgcolor: 背景颜色
类型: 字符串 (十六进制颜色代码)
说明: 设置下拉框的背景颜色。
bgopa: 背景透明度
类型: 整数 (0-255)
说明: 设置下拉框的背景透明度,取值范围为 0(完全透明)到 255(完全不透明)。
opa: 透明度
类型: 整数 (0-100)
说明: 设置下拉框的透明度,取值范围为 0(完全透明)到 100(完全不透明)。
font: 字体样式
类型: 整数
说明: 设置下拉框中文本的字体样式。
x: 横坐标
类型: 整数
说明: 设置下拉框的横坐标位置。
y: 纵坐标
类型: 整数
说明: 设置下拉框的纵坐标位置。
w: 宽度
类型: 整数
说明: 设置下拉框的宽度。
h: 高度
类型: 整数
说明: 设置下拉框的高度。
vis: 可见性
类型: 整数 (0 或 1)
说明: 控制下拉框的可见性,0 表示隐藏,1 表示显示。
val: 当前选中值的索引
类型: 整数
说明: 设置下拉框中当前选中的选项索引。
do: 事件执行命令
类型: 字符串
说明: 指定当选择下拉框中的选项时执行的事件命令,比如 “select”。
串口指令示例:
{
"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"
}
在上面的示例中,通过串口指令设置了一个下拉框控件的所有属性值,包括文本内容、文本颜色、背景颜色、背景透明度、透明度、字体样式、位置、大小、可见性、当前选中的值的索引以及事件执行命令。
下拉框控件 属性设置示例
1. 设置文本内容 (txt)
{
"name": "dd0",
"prop": {
"txt": "hello1\nhello2\nhello3"
}
}
说明: 在上面的示例中,设置了下拉框中的文本内容为 “hello1”、”hello2” 和 “hello3”。
2. 设置文本颜色 (color)
{
"name": "dd0",
"prop": {
"color": "#FF0000"
}
}
说明: 该示例将下拉框中的文本颜色设置为红色。
3. 设置背景颜色 (bgcolor)
{
"name": "dd0",
"prop": {
"bgcolor": "#00FF00"
}
}
说明: 在此示例中,将下拉框的背景颜色设置为绿色。
4. 设置背景透明度 (bgopa)
{
"name": "dd0",
"prop": {
"bgopa": 60
}
}
说明: 该示例将下拉框的背景透明度设置为 60。
5. 设置透明度 (opa)
{
"name": "dd0",
"prop": {
"opa": 100
}
}
说明: 在此示例中,将下拉框的透明度设置为 100。
6. 设置字体样式 (font)
{
"name": "dd0",
"prop": {
"font": 0
}
}
说明: 该示例将下拉框中的文本字体样式设置为默认样式。
7. 设置横坐标 (x)
{
"name": "dd0",
"prop": {
"x": 200
}
}
说明: 在此示例中,将下拉框的横坐标位置设置为 200。
8. 设置纵坐标 (y)
{
"name": "dd0",
"prop": {
"y": 100
}
}
说明: 该示例将下拉框的纵坐标位置设置为 100。
9. 设置宽度 (w)
{
"name": "dd0",
"prop": {
"w": 150
}
}
说明: 在此示例中,将下拉框的宽度设置为 150。
10. 设置高度 (h)
{
"name": "dd0",
"prop": {
"h": 50
}
}
说明: 该示例将下拉框的高度设置为 50。
11. 设置可见性 (vis)
{
"name": "dd0",
"prop": {
"vis": 1
}
}
说明: 在此示例中,将下拉框设置为可见状态。
12. 设置当前选中值的索引 (val)
{
"name": "dd0",
"prop": {
"val": 0
}
}
说明: 该示例将下拉框中当前选中的值的索引设置为 0。
13. 设置事件执行命令 (do)
{
"name": "dd0",
"do": "select"
}
说明: 在此示例中,设置了当选择下拉框中的选项时执行的事件命令为 “select”。