3.3 TFT【位设置】按钮控件

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

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

位设置按钮

【位设置】按钮控件与【位状态】指示灯控件类似，属于位操作。主要区别是，【位设置】只能写数据位，而不会读取该数据位来显示状态。

一、功能设置

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

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的属性

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

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

三、应用示例

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

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

1.1 下图【位设置】按钮控件属性

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

1.2 下图【位设置】按钮控件属性

1.3 下图第一个【数值】输入控件属性

 

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

1.5 运行

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

2. 演示【切换开关】

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

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

2.3 运行

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

3. 演示【点动开关】

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

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

3.3 运行

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