3.14 ApusTAI 圆形进度条控件

圆形进度条用圆弧显示监视地址的数值，也可按需启用滑动调节。下图是编辑器预览，不代表设备当前的实测值。

添加与设置

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

1. 监视地址与数据类型：示例使用 LW0351、UINT16。地址应按工程实际分配，并与数值类型保持一致。
2. 数值区间与滑动调节：开始值和结束值分别对应圆弧两端，示例为 0～100。需要操作员拖动时启用“滑动调节”，再按需设置“松开时通知”和滑块图片；示例只作显示，未启用滑动。
3. 圆弧形状：用厚度、开始角度和占用角度确定外观。示例厚度 16、开始角度 225°、占用角度 270°。
4. 显示效果：示例采用纯色、圆帽和蓝色前景。使用图片效果时，应先把对应图片加入工程图库。

编译后在模拟器或目标设备上检查起点、终点和中间值；若启用滑动，再检查地址写入与通知时机。

属性图与练习工程对照

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

练习工程关键设置：圆形进度条监视 LW0311，UINT16、区间 0～100，起始角 225°、占用角 270°、厚度 14；此页只显示，不启用拖动，按钮分别写入 25 和 75。

逐步复现与排查

1. 进入第 15 页，观察初始圆弧约占设定跨度的四分之一。
2. 分别点击“75%”和“25%”，检查圆弧长度随数值变化。
3. 在 IDE 中核对监视地址、区间、角度和厚度。

结果异常时：圆弧方向或长度异常时，先查起始角、占用角和数值范围；此练习没有开启滑动调节。

 

可下载练习案例

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

打开第 15 页，点击“25%”“75%”向 LW0311 写入 25、75，核对圆弧长度变化；初始值为 25。

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