3.13 TFT【进度条】控件

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

**【例程下载】**[ApusTFT - 进度条控件(点击下载)]

动态按钮

一、功能设置

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

2.数据类型：选择[UINT16、INT16、UINT32、INT32、UINT64、INT64、FLOAT、DOUBLE]。

3.数据范围：选择[固定范围、可变范围]。

• 固定范围

3.1下限值：可输入数值的最小值。

3.2上限值：可输入数值的最大值。

• 可变范围：

3.1 下限地址：最小值从该地址获取。

3.2 上限地址：最大值从该地址获取。

外观设置

**显示方向：只需将控件的高度大于宽度，自动转为垂直方向

1.圆帽：选择[否、是]。是，则两端为半圆形。

2.显示效果：选择[颜色、渐变、图片]。

• 颜色：

2.1前景颜色：进度指示条的颜色。

2.2显示背景颜色：选择[否、是]。否，则背景为透明。

2.2.1背景颜色：背景颜色。

2.3范围报警：选择[无、固定范围、可变范围]。

2.3.1下限值：进度值小于该值时，指示条显示为下限颜色。

2.3.2上限值：进度值大于该值时，指示条显示为上限颜色。

2.3.3下限颜色：进度值小于下限值时，指示条的颜色。

2.3.4上限颜色：进度值大于上限值时，指示条的颜色。

• 渐变：（渐变方向自左向右）

2.1开始颜色：最左边的颜色

2.2结束颜色：最右边的颜色

2.3显示背景颜色：略，同上。

2.4范围报警：略，同上。

• 图片：

2.1进度图片：进度图片。

2.2背景图片：背景图片。

三、应用示例

1.【固定范围】演示

如下图，依次放入控件：

【文字】、【数值】

【字设置】、【进度条】、【字设置】

1. 【数值】控件属性

   

   

2. 左【字设置】控件属性

   注：【长按调节】属性，需要先把【执行时机】属性设为【长按时】

   

   

   1.3 【进度条】控件属性

   

   

   1.4 右【字设置】控件属性（进度条设置为图片后，显示相应的图片）

   注：【长按调节】属性，需要先把【执行时机】属性设为【长按时】

   

   

   1.5 运行

   点击【字设置】按钮或修改【数值】输入框的值，观察效果

【可变范围】演示

如下图，依次放入控件：

【文字】、【数值】、【文字】、【数值】

【字设置】、【进度条】、【字设置】

【文字】、【数值】

2.1 最小值【数值】控件属性

2.2 最大值【数值】控件属性

2.3 递减【字设置】控件属性

2.4 【进度条】控件属性

2.5 递增【字设置】控件属性

2.6 运行

点击【字设置】按钮或修改各【数值】输入框的值，观察效果