3.1 TFT【位状态】指示灯控件

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

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

位状态指示灯

       

 

位状态指示灯是用于显示或控制开关量的控件，使值在0和1之间变换。通过图标或文本变化，直观反映设备开关量状态，用于设备启停、报警确认、IO 状态监控等"是否"、"对错"、"开关"之类的场景。

 

一、功能设置

1. 读取地址：控件将读取该地址的值。

2. 切换开关：选择[禁用、启用]。

• 启用，则控件可被点击切换状态。

2.1. 写入地址：控件将值写入该地址。

2.1.1 不同地址：选择写入地址。

2.2. 开关类型：设置 ON、设置 OFF、切换开关、点动开关。

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

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

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

  • 点动开关：按下目标地址写入 1，松开目标地址写入 0

3. 执行时机：选择[按下时、松开时、长按时]。

• 长按时

3.1 按压毫秒：长按的时长，单位ms，范围500~20000。

4. 播放声音：选择[禁用、启用]。

4.1声音文件：选择声音文件。更多选项通过[工程]-[声音]添加或删除。

二、状态设置

1. 使用图片：选择[否、是]。

1.1.状态图片：

• • 图库素材：内置一些SVG格式图片，可点击【颜色...】修改主颜色。
  • 插入图片...：选择外部图片(png/jpg/svg)，无法在这里修改颜色。注svg仅支持低于1.2tiny版

  • 状态 0 图库：控件状态为 0时， 显示的图片。

  • 状态 1 图库：控件状态为 1时， 显示的图片。

1.2裁剪：选择缩放图片以适应控件大小，即控件尺寸不变；缩放控件以适应图片大小，即按图片大小缩放控件。

2. 使用文字：选择[否、是]。

2.1默认字体：字体名称，通过[工程]-[字库]添加或删除。

2.2字体大小：字体尺寸，范围8~500。

2.3字间距：相邻字符之间的间距，范围0~255。

2.4使用标签：选择[否、是]。

2.5选择状态：选择[ALL、S0、S1]。

• • ALL：修改下面的子属性时，将同时修改所有状态对应的属性。
  • S0/S1：修改下面的子属性时，仅对选中状态有效。

2.5.1文字内容：不使用标签时，需输入文字内容。

        标签：使用标签时，指定标签，通过[工程]-[文字标签]添加或删除。

2.5.2颜色：文字颜色。

2.5.3对齐：仅支持水平对齐，选择[左、中、右]。

2.5.4闪烁：选择[无、0.5秒、1秒]。

2.5.5跑马灯：选择[无、左移动、右移动、下移动、上移动]。

2.5.5.1速度：文字跑马灯效果移动速度(像素/秒)：1~10000。

2.6详细设置：多语言多状态下指定不同的字体

修改ALL行时，将同时修改S0/S1的属性

当使用标签时，下方多语言表中，不可再指定标签

当不使用标签时，下方多语言表中，可输入内容

三、应用示例

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

第一行5个【文字】控件

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

第三行3个【位状态】

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

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

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

、

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

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

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

1.3 下图【位状态】指示灯控件属性

其中，【详细设置】<多语言多状态>如下

1.4 下图【数值】输入控件属性

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

1.6 运行

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

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

2.1 下图【位状态】指示灯控件属性

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

2.2 下图【位状态】指示灯控件属性

其中，【详细设置】<多语言多状态>如下

2.3 下图【数值】输入控件属性

2.4 运行

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

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

设置基本同2，要注意不同设置的属性有【读取地址】、【开关类型】，详见示例程序。