3.1 TFT位状态指示灯控件

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

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

什么是位状态指示灯？

位状态指示灯控件是一种专用于可视化布尔型（Boolean）的图形化组件。通过图标或文本变化，直观反映设备开关量状态，广泛应用于设备启停、报警确认、IO 状态监控等场景。

核心功能

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

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

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

4. 开关类型：设置 ON、设置 OFF、切换开关、点动开关；

• 设为ON：点击控件向目标地址写入 1；

• 设为OFF：点击控件目标地址写入 0；

• 切换开关：按下时目标地址写入 1，弹起时目标地址写入 0；点击切换按下和弹起状态；

• 点动开关：按下目标地址写入 1，弹起目标地址写入 0；松开后自动弹起。

  5. 执行时机：可选按下时、弹起时执行；

  6. 播放声音：是或否；

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

2.状态设置

1. 使用图片：是或否：

• 状态 0 图库：状态 0 显示的图片文件；

• 状态 1 图库：状态 1 显示的图片文件；

• 裁剪：是或否，将选中的图片根据当前控件区域裁剪显示；

  2. 使用文字：是或否。

• 默认字体：默认字库文件；

• 字体大小：字体文字大小；

• 使用标签：是否使用文字标签，详细参考文字标签章节；

• 选择状态：修改指定状态 S1-Sn，全部状态选择 ALL；可设置状态的文字内容、颜色、对齐方式、是否闪烁、是否使用跑马灯效果等。

3.应用示例

如下图，放置4行控件分别为：

第一行5个【文字】控件

第二行4个【位状态】指示灯控件

第三行3个【位状态】

第四行4个【数值】输入控件

3.1 演示位状态指示灯【设为ON】、【设为OFF】

3.1.1 第二行第1个【位状态】指示灯控件属性

、

注：其中【状态图片】属性中，两个图片设为相同

3.1.2 第二行第2个【位状态】指示灯控件属性

注：其中【状态图片】属性中，两个图片设为相同

3.1.3 第三行第1个【位状态】指示灯控件属性

其中，设置如下

3.1.4 第四行第1个【数值】输入控件属性

3.1.5 第四行第4个【数值】输入控件属性

3.1.6 运行

点击三个【位状态】指示灯控件，观察两个【数值】输入控件变化

3.2 演示位状态指示灯【切换开关】

3.2.1 第二行第3个【位状态】指示灯控件属性

注：状态图片中，两个状态设置不同的图片，以便查看效果

3.2.2第三行第2个【位状态】指示灯控件属性

其中，设置如下

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

3.2.4 运行

点击这两个【位状态】指示灯控件，观察两个【数值】输入控件变化

3.3 演示位状态指示灯【点动开关】

设置基本同第3.2，要注意不同设置的属性有【读取地址】、【开关类型】。