3.3 TFT位设置按钮控件

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

**【例程下载】**[ApusTFT - 位设置按钮控件(点击下载)]

位设置按钮

【位设置】按钮控件是一种专用于对布尔型（Boolean）的交互式操作组件。其核心特点是仅执行写操作，不同步寄存器当前状态，每次点击即向目标地址发送预设的 ON（1） 或 OFF（0） 指令，常用于触发瞬时动作（如复位、启动、确认等）。

功能设置

(1)写入地址：控件写入绑定的地址；

(2)开关类型：设为 ON、设为 OFF、切换开关、点动开关，本文以切换开关为例：

• 设为 ON：按下时目标地址写入 1；

• 设为 OFF：按下时目标地址写入 0；

• 切换开关：点击一下向目标地址写入 1，在点击一下向目标地址写入 0；

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

  (3)执行时机：执行动作时的状态选择；

  (4)播放声音：是或否；

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

状态设置

1. 使用图片：是否使用图库。

•  松开时图片：选择按钮松开状态下显示的图片文件；

•  按下时图片：选择按钮按下状态下显示的图片文件；

•  裁剪：是或否，将上一选项选中的图片按照当前控件区域裁剪显示；

1. 使用文字：是否使用文字；

•  默认字体：选择默认字体；

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

•  使用标签：选择设定的文字，详细参考标签章节；

•  选择状态：修改指定状态：按下时、松开时，全部状态选择 ALL；可设置状态的文字内容、

•  颜色、对齐方式、是否闪烁、是否使用跑马灯效果等；

状态设置

1. 使用图片：是否使用图库。按钮仅2个状态，分别表示松开和按下

• 松开时(状态0)图片：选择按钮松开状态下显示的图片文件；

• 按下时(状态1)图片：选择按钮按下状态下显示的图片文件；

• 裁剪：是或否，将上一选项选中的图片按照当前控件区域裁剪显示；

2. 使用文字：是否使用文字；

• 默认字体：选择默认字体；

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

• 使用标签：选择设定的文字，详细参考标签章节；

• 选择状态：修改指定状态：按下时、松开时，全部状态选择 ALL；可设置状态的文字内容、

• 颜色、对齐方式、是否闪烁、是否使用跑马灯效果等；

3.应用示例

如下图，放置【文字】控件、【位设置】按钮控件、【数值】输入控件：

演示【设为ON】、【设为OFF】

1. 第1个【位设置】按钮控件属性

   

   

   在状态图片中，设置自己的图片

2. 第2个【位设置】按钮控件属性

   

   

3. 【数值】输入控件属性

   

4. 最后一个【数值】输入控件属性

   

   

5. 运行

   ON按钮按下时，按钮的图片切换到OFF；松开时，图片切回到ON，数值显示为1，与执行时机【松开时】一致。

   

演示【切换开关】

1. BIT1的【位设置】按钮控件属性

   

   

2. BIT1的【数值】输入控件属性

   

   

3. 运行

   按下、松开，观察数值显示情况

   

演示【点动开关】

1. BIT2的【位设置】按钮控件属性

   

   

2. BIT2的【数值】输入控件属性

   

   

3. 运行

   按下、松开，观察数值显示情况