3.2 TFT多状态指示灯控件

版本	内 容 摘 要	日期
V1.0	首次发布	2026/6/14

**【例程下载】**[ApusTFT - 多状态指示灯控件(点击下载)]

什么是多状态指示灯？

多状态指示灯控件是一种用于可视化 Word 类型变量（如 16 位整数）的高级图形组件。与仅支持布尔值的位指示灯不同，该控件可根据寄存器的具体数值映射到预定义的多个状态，每个状态可配置独立的图标、颜色、文本标签，适用于模式识别、流程阶段指示、档位显示等复杂场景。

功能设置

1. 读取地址：控件变量读取绑定的地址；

2. 切换开关：启用状态切换开关；

3. 写入地址：控件变量写入绑定的地址；

4. 操作模式：状态切换改变的方式选择：递增、递减；

5. 循环调节：是否启动循环调节模式，启动后状态可循环切换；

6. 数据类型：变量数据类型选择，如 UINT16；

7. 执行时机：执行动作时的时机选择；

8. 播放声音：是或否；

• 声音文件：选择 MP3 或者 WAV 音频文件；

状态设置

1. 状态数：多状态的状态数量；

2. 转换状态：状态值默认 1，也可重新设置每位状态对应的数值；

• 状态转换表：设置状态索引和状态值的映射，例如：0;1;2;3;5；

3. 使用图片：是否启用图片，每张图片代表一个状态；

4. 使用文字：是否使用文字，多状态文字每一状态可设置分别应一个文字状态；

3.应用示例

如下图，放置3列控件分别为：

第1列，2个【文字】控件，仅用于显示文字

第2列，4个【多状态】指示灯控件

第3列，2个【数值】输入框控件

3.1 演示多状态指示灯【递增】

3.1.1 第1个【多状态】指示灯属性

注意：【状态图片】属性中插入图片

3.1.2 第2个【多状态】指示灯属性

其中【多语言多状态】属性如图

3.1.3 第1个【数值】输入控件属性

3.1.4 运行

点击【多状态】指示灯控件或修改【数值】输入控件，查看效果

3.2 演示多状态指示灯【递增】 及【状态转换】效果

3.2.1 第3个【多状态】指示灯属性

注意：【状态图片】属性中插入图片

3.2.2 第4个【多状态】指示灯属性

其中【多语言多状态】属性如图

3.2.3 第2个【数值】输入控件属性

3.1.4 运行

点击【多状态】指示灯控件或修改【数值】输入控件，查看效果。

注：状态转换后，【数值】输入控件显示为转换后的值。输入时，也应为转换后的值