3.13 ApusTAI 进度条控件

进度条从指定地址读取数值，并按设定范围显示填充比例。下图是编辑器中的控件预览，填充长度不代表设备当前的实测值。

添加与设置

在“控件”选项卡放置“进度条”，选中控件后按下图编号配置。

1. 读取地址与数据类型：地址中的数据类型应与控件一致。示例读取 LW0350，类型为 UINT16；实际工程请使用自己的地址。
2. 范围限制：固定范围直接填写最小值和最大值，示例为 0～100。可变范围则分别选择下限地址和上限地址。
3. 外观：示例采用圆帽、纯色前景和浅色背景。显示效果还可选择渐变或图片；图片模式需要在工程图库中指定进度图及背景图。控件宽度小于高度时，预览和编译输出自动改为从下向上填充的竖向进度条。
4. 范围报警：可按需选择固定范围或可变范围报警，并设置上下限及对应颜色；示例未启用。

编译后在模拟器或目标设备上检查 0、上限及越界值，确认填充方向和报警颜色符合预期。

属性图与练习工程对照

上方带编号的属性图用于说明设置项，图中示例为 LW0350；下方可下载练习工程位于第 14 页，使用 LW0310。两套设置不能混用，复现时以下载工程的实际属性为准。

练习工程关键设置：进度条读取 LW0310，UINT16、固定范围 0～100；脚本启动时写入 25，下方两个按钮写入 25 和 75。

逐步复现与排查

1. 进入第 14 页，观察初始进度接近四分之一。
2. 点击“75%”，确认填充长度增加；点击“25%”，确认缩短。
3. 在 IDE 中核对读写地址一致，范围为 0～100，并检查前景色和填充方向。

结果异常时：填充不动时核对按钮地址和进度条读取地址；数值到顶却没填满时检查上下限。

 

可下载练习案例

下载 DocControlsTest.apustai，使用 ApusTAI 的“打开范例工程”导入。工程型号 E043C4827，画面 480×272，协议 DCBUS；导入后先编译，再运行“虚拟屏调试”。本例地址仅供练习，连接实际控制器时按现场协议重新分配。

打开第 14 页，点击“25%”“75%”向 LW0310 写入 25、75，观察进度条长度变化。脚本在工程启动时将该地址初始化为 25。

图片是本机模拟器的页面运行画面。工程已通过页面和控件回读、0 错误 0 警告编译以及编译产物校验。写值按钮及进度变化需在导入后复核。