3.13 TFT进度条控件

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

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

动态按钮

一、功能设置

1.读取地址：控件读取绑定的寄存器地址

2.数据类型：支持"UINT16"、"INT16"、"UINT32"、"INT32"、"UINT64"、"INT64"、"FLOAT"、"DOUBLE"的数据格式

3.数据范围：进度条的范围值，可选择固定范围和可变范围。

• 固定范围：可设置最小值和最大值。必须为整数

• 可变范围：可设置最小值地址和最大值地址

外观设置

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

1.显示效果：设置进度条的显示效果，可选择纯色、渐变色、图片

(1)颜色：

• 前景颜色：设置进度条的前景颜色为纯色

• 显示背景色：可设置为纯色或渐变色时，设置进度条的背景显示颜色

• 范围报警：设置进度条报警时的范围值，可设置固定范围和可变范围，并设置报警上下限的颜色

  (2)渐变色：设置进度条的颜色从开始颜色渐变为结束颜色。

  • 开始颜色：设定起始颜色

  • 结束颜色：设定终止颜色

  • 显示背景颜色：可设置为无或纯色背景色

  • 范围报警：设置进度条报警时的范围值，可设置固定范围和可变范围，并设置报警上下限的进度条颜色

    (3)贴图：设置进度条显示为图片，需设置进度条和背景的图库文件

三、应用示例

1.【固定范围】演示

如下图，依次放入控件：

【文字】、【数值】

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

1. 【数值】控件属性

   

   

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

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

   

   

   1.3 【进度条】控件属性

   

   

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

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

   

   

   1.5 运行

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

【可变范围】演示

如下图，依次放入控件：

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

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

【文字】、【数值】

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

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

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

2.4 【进度条】控件属性

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

2.6 运行

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