3.3 ApusTAI 位设置按钮控件

位设置按钮用于向指定位地址写入 0 或 1。它按按钮动作执行写入；若需要根据地址值持续显示状态，应使用位状态指示灯。

添加与设置

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

1. 写入地址：选择目标位地址。图中的 LW0300 仅为测试工程示例，实际工程应使用自己的地址。
2. 开关类型：选择“设为 ON”“设为 OFF”“切换开关”或“点动开关”；再设置执行时机。示例为“设为 ON”，在按下时写入 1。点动开关应同时检查按下与松开动作。
3. 使用图片：启用后分别指定状态 0 和状态 1 的图片，核对两张图与状态的对应关系。示例使用 Remix Icon（Apache-2.0）的电源图标制作两态按钮图。
4. 使用文字：启用后填写按钮文字，并按需要调整字号、颜色与对齐。选择 ALL 可统一编辑两个状态，选择 S0 或 S1 可单独修改。

保存并编译后，用模拟器或目标设备检查写入地址和按下、松开行为。不要把图中的示例地址直接用于实际控制。

属性图与练习工程对照

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

练习工程关键设置：位设置按钮的写入地址为 LW0302，开关类型为“设为 ON”，执行时机为按下；下方位状态灯读取同一地址。按钮使用松开、按下两张电源图。

逐步复现与排查

1. 进入第 3 页，观察下方状态灯的初始状态。
2. 按下电源图标，检查状态灯是否变为绿色；松开后确认按钮图片恢复松开态。
3. 在 IDE 中核对按钮写入地址、开关类型、执行时机，以及指示灯读取地址。

结果异常时：按钮变色但灯不变时，优先核对读写地址是否一致；按下和松开图反了则交换两张状态图。

 

可下载练习案例

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

打开第 3 页，按下电源图标按钮，检查 LW0302 是否写为 1，并观察下方状态灯；同时检查按下与释放两张图是否对应。

图片是本机模拟器的页面运行画面。工程已通过页面和控件回读、0 错误 0 警告编译以及编译产物校验。按钮写入时机和目标设备触摸反馈需逐项复核。