第三章 ApusTAI 组态控件

文档版本：ApusTAI 1.0.27；更新日期：2026-10-09。

版本说明：本次同步文档版本与安装入口。保留的截图、视频及案例测试记录来自 ApusTAI 1.0.21；未逐项重测的结果按原记录说明，升级后请重新编译并复核。

适用版本：ApusTAI 1.0.27。先选控件用途，再按教程设置资源、地址与属性。各页截图以图注所示 IDE 版本为准；新版界面可能存在差异。

按用途选择控件

截图中的设计时占位值与运行时数据不同。涉及通信的控件还须检查地址、数据类型和目标控制器的实际收发。

图片轮选：点击与拖动

图片轮选用于从一组图片中选择当前项。新版固件与模拟器支持拖动翻动，也支持点击控件范围内可见的旁侧图片，让该图片移动到中心。

先检查图片资源和绑定地址，再核对触摸使能、权限与控件范围。透视或缩放效果超出控件边界的图片部分不属于输入区域；被其他图片覆盖的区域按实际可见图片处理。

如果仍只能拖动，请确认实际运行的是包含旁图点击修复的固件或模拟器，重新加载当前工程后测试。下方旧版练习工程的 18 页不包含这个新增说明项，不应据此假定它已经覆盖图片轮选测试。

阅读与复现顺序

1. 先按控件用途打开对应文章，查看控件外观、带编号的属性图及其版本说明。
2. 属性图来自单项设置示例；文章下方的运行图来自统一练习工程。两者的地址、选项或外观参数可能不同，复现时以文章中的“属性图与练习工程对照”为准。
3. 下载练习工程并打开第 0 页目录，再进入对应练习页，按文章中的步骤操作并核对预期结果。
4. 涉及 PLC 通信、实体屏触摸、RTC 保持或二维码扫码的结果，还需在目标设备上逐项核验；页面截图和编译成功不等于这些行为已实测。

18 页可运行练习

下载 DocControlsTest.apustai，在 ApusTAI 1.0.21 中打开范例工程。第 0 页是目录，第 1～18 页对应下列控件；型号 E043C4827，画面 480×272，协议 DCBUS。

1. 3.1 位状态指示灯：第 1 页
2. 3.2 多状态指示灯：第 2 页
3. 3.3 位设置按钮：第 3 页
4. 3.4 字设置按钮：第 4 页
5. 3.5 动态按钮：第 5 页
6. 3.6 功能按钮：第 6 页
7. 3.7 数值输入：第 7 页
8. 3.8 文本输入：第 8 页
9. 3.9 滑动条：第 9 页
10. 3.10 下拉框与列表框：第 10、11 页
11. 3.11 滚轮：第 12 页
12. 3.12 动画：第 13 页
13. 3.13 进度条：第 14 页
14. 3.14 圆形进度条：第 15 页
15. 3.15 仪表指针：第 16 页
16. 3.16 二维码：第 17 页
17. 3.17 日期时间：第 18 页

工程页面和控件属性已回读，编译为 0 错误、0 警告，产物校验通过；位状态与仪表的部分交互已实测。其余交互请按对应文章逐项操作，目标设备上的触摸与通信仍需实机复核。