下拉框控件 (ComboBox)

Guition 下拉框控件是一种常用于选择列表中的选项的界面元素,它具有灵活的属性设置,可以通过串口指令动态配置其外观和行为。下面是该控件的各个可设置属性值的说明:

  1. txt: 文本内容

    • 类型: 字符串

    • 说明: 指定下拉框中的选项文本内容,多个选项之间使用换行符(\n)分隔。

  2. color: 文本颜色

    • 类型: 字符串 (十六进制颜色代码)

    • 说明: 设置下拉框中文本的颜色。

  3. bgcolor: 背景颜色

    • 类型: 字符串 (十六进制颜色代码)

    • 说明: 设置下拉框的背景颜色。

  4. bgopa: 背景透明度

    • 类型: 整数 (0-255)

    • 说明: 设置下拉框的背景透明度,取值范围为 0(完全透明)到 255(完全不透明)。

  5. opa: 透明度

    • 类型: 整数 (0-100)

    • 说明: 设置下拉框的透明度,取值范围为 0(完全透明)到 100(完全不透明)。

  6. font: 字体样式

    • 类型: 整数

    • 说明: 设置下拉框中文本的字体样式。

  7. x: 横坐标

    • 类型: 整数

    • 说明: 设置下拉框的横坐标位置。

  8. y: 纵坐标

    • 类型: 整数

    • 说明: 设置下拉框的纵坐标位置。

  9. w: 宽度

    • 类型: 整数

    • 说明: 设置下拉框的宽度。

  10. h: 高度

  • 类型: 整数

  • 说明: 设置下拉框的高度。

  1. vis: 可见性

  • 类型: 整数 (0 或 1)

  • 说明: 控制下拉框的可见性,0 表示隐藏,1 表示显示。

  1. val: 当前选中值的索引

  • 类型: 整数

  • 说明: 设置下拉框中当前选中的选项索引。

  1. 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”。