3.2 ApusTAI 多状态指示灯控件

多状态指示灯根据读取地址的数值显示预设的多个状态，可为各状态分别设置文字或图片。需要点击控件写入状态值时，再启用“切换开关”。

添加控件与读取地址

1. 在工程页面的“控件”选项卡点击“多状态”，然后点击画布放置控件。
2. 选中控件，在右侧“功能设置”中点击“读取地址”及其省略号，打开“设置地址”。选择实际的数据位置、数据类型和地址后确认。
3. 检查画布上的红色地址标识和属性面板中的“读取地址”。下图的 LW0200 仅为测试工程示例，实际工程应使用自己的地址分配。

属性设置

按下图的编号设置，示例仅用于说明字段位置和操作顺序。

1. 读取地址：绑定实际寄存器。示例为 LW0200，不应照搬到其他工程。
2. 切换开关：只用于显示时可关闭；需要点击控件改变状态时再启用，并核对写入地址、操作模式、执行时机、循环调节和数据类型。示例为与读取地址相同、递增、按下时、UINT16，循环调节关闭。
3. 状态数：示例设置为 3。需要自定义寄存器值与状态索引的对应关系时，启用“状态转换”并填写状态转换表。
4. 使用图片：启用后打开“多状态图片”，为 S0、S1、S2 分别指定待机、运行、告警状态图；检查列表顺序与状态索引一致。
5. 使用文字：启用后在“选择状态”中分别选择 S0、S1、S2，填写“待机”“运行”“告警”，并设置字体、字号、颜色及对齐方式。选择 ALL 可统一调整状态属性。

画布中的“待机”是编辑器预览，不代表设备当前的实时状态。需要触摸音效时，启用“播放声音”并选择已导入的声音文件。保存并编译工程后，使用测试数据分别核对各状态的显示；若启用了切换开关，还应检查点击动作与写入地址的数值变化。

属性图与练习工程对照

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

练习工程关键设置：读取地址绑定 LW0301，状态数为 3；S0、S1、S2 分别是待机、运行、告警图。页面下方的三个按钮分别写入 0、1、2。

逐步复现与排查

1. 从目录进入第 2 页，依次点击“待机 0”“运行 1”“告警 2”。
2. 每点一次核对图像：灰色待机、绿色运行、红色告警；最后再回到待机。
3. 在 IDE 中核对状态数为 3，三张图片的顺序与写入值一致。

结果异常时：若某一状态空白或错位，检查状态数、图片列表索引和地址类型；状态转换表只在需要自定义数值映射时使用。

 

可下载练习案例

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

打开第 2 页，依次点击“待机 0”“运行 1”“告警 2”，向 LW0301 写入 0、1、2，核对每个状态的图像与编号。

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