3.4 TFT【字设置】按钮控件

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

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

位设置按钮

【字设置】按钮控件与【多状态】指示灯控件类似，但只向寄存器写入值，而不会读取值来显示状态。

一、功能设置

写常量、点动设置、递增/递减的不同属性

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

2. 操作模式：选择[写常量、点动设置、递增、递减]。

2.1 写入常量

2.1.1 常量值：点击控件时写入该值。

2.2 点动设置

2.2.1 按下值：按下控件时写入该值。

2.2.2 松开值：松开控件时写入该值。

2.3 递增

2.3.1 步长：递增或递减模式下，每次点击增加或减少的值。

2.3.2 最小值：变量下限值。

2.3.3 最大值：变量上限值。

2.3.4 循环调节：选择[禁用、启用]。启用时，如递增达到上限，再加1即回到下限。

2.3.5 长按调节：选择[禁用、启用]。

2.3.5.1 迟滞时间：长按多少ms后开始连续执行，范围0~20000。

2.3.5.2 间隔时间：长按时每多少ms执行一次，范围0~20000 。

2.4 递减：同递增

3. 数据类型：选择[UINT16、INT16、UINT32、INT32]。

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

• 长按时

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

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

5.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. 演示【递增递减】

画面中放入2个【字设置】按钮控件和1个【数值】输入控件

1.1 左【字设置】按钮控件属性

注意：要先设置【执行时机】为【长按时】，才会显示【长按调节】属性

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

1.2 右【字设置】按钮控件属性

1.3 【数值】输入控件属性

1.4 运行

点击或长按两个字设置按钮控件，观察数值输入框变化情况

2. 演示【常量与点动】

画面中放入4个【字设置】按钮控件和1个【数值】输入控件

2.1【数值】输入控件属性

2.2 第1个【字设置】按钮控件属性

2.3 第2个【字设置】按钮控件属性

2.4 第3个【字设置】按钮控件属性

2.5 第4个【字设置】按钮控件属性

2.6 运行

点击四个字设置按钮控件，观察数值输入框变化情况