3.5 ApusTAI 动态按钮控件

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

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

适用版本：ApusTAI 1.0.27。

动态按钮是带滑动外观的开关控件，绑定一个读写地址。它在关闭与开启状态之间切换，并用颜色和圆形位置显示状态。此控件使用内置外观，没有单独的图片属性。

添加与设置

在“控件”选项卡放置“动态按钮”，选中后按下图编号配置。

1. 读写地址：绑定实际开关变量。图中的 LW0302 是测试工程示例。
2. 圆圈颜色：设置滑动圆圈的颜色，使其与开关底色有足够对比。
3. 未选时：设置关闭状态的底色。示例为中性灰。
4. 选中时：设置开启状态的底色。示例为绿色。

“禁用时”颜色用于不可操作状态。保存并编译后，检查运行时读写地址与开关显示是否一致；如需触摸音效，可在声音属性中启用并选择已导入的声音文件。

属性图与练习工程对照

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

练习工程关键设置：动态按钮读写 LW0304，下方状态灯也读取 LW0304。该控件使用内置开关外观，关闭和开启通过颜色及圆圈位置区分。

逐步复现与排查

1. 进入第 5 页，记录开关和状态灯的初始状态。
2. 点击开关一次，观察圆圈位置、底色和状态灯是否一起变化；再点一次，观察是否返回。
3. 在 IDE 中核对动态按钮和状态灯使用同一地址。

结果异常时：开关变化而灯不变时检查地址；颜色不易区分时增加开关两态的明度差。

 

可下载练习案例

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

打开第 5 页，点击动态开关，观察 LW0304 对应的状态灯；再次点击，核对开关是否返回初始状态。

图片是本机模拟器的页面运行画面。工程已通过页面和控件回读、0 错误 0 警告编译以及编译产物校验。双向切换需在导入后复核。