3.16 ApusTAI 二维码控件

二维码控件读取指定地址中的文本并显示为二维码。编辑器画布上的图案是控件预览；使用时应写入实际文本，再在运行环境中扫码核对。

添加控件

1. 打开工程页面，在顶部“控件”选项卡中点击“二维码”，再点击画布放置控件。
2. 选中二维码，在右侧属性面板设置位置和尺寸。截图中的 100 × 100 是测试工程的当前尺寸，可根据页面布局调整。

绑定文本地址

1. 在“功能设置”中点击“读取地址”右侧的省略号。
2. 在“设置地址”窗口选择地址所在位置、数据类型和实际使用的地址，确认后检查属性面板显示的地址。
3. 设置“文本长度”。该字段在当前界面中以字节计，须覆盖要编码的文本，同时不要越过所分配的地址区域。

图中 HMI 本机、LW0100 和文本长度 16 仅为测试工程示例；请按自己的数据来源和地址分配设置。

外观与检查

在“外观设置”中选择“纠正错误”级别和二维码颜色。纠错级别越高，二维码可能越密；应结合控件尺寸和实际扫码距离检查识别效果。

保存并编译工程，向绑定地址写入测试文本，在模拟器或目标屏幕上核对二维码显示，再扫码检查结果。包含中文等多字节字符时，应按实际编码后的字节长度核对“文本长度”；不要只按字符个数计算。

属性图与练习工程对照

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

练习工程关键设置：二维码读取 LW0320，文本长度 16；工程启动脚本向该地址写入 APUSTAI，第 8 页文本输入也写入同一地址。

逐步复现与排查

1. 进入第 17 页，观察二维码是否完整显示，四周是否留有空白边缘。
2. 去第 8 页输入另一段短文本，再返回第 17 页，观察图形是否变化。
3. 使用扫码设备分别读取两次内容，并与输入文本逐字核对；多字节文本按编码后的字节长度计算。

结果异常时：图形未变化时检查第 8 页与二维码的地址；无法扫码时检查尺寸、对比度和文本长度。当前只核对了运行图，尚未完成扫码内容实测。

 

可下载练习案例

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

打开第 17 页查看 LW0320 对应二维码。工程启动时先写入 APUSTAI；在第 8 页修改文本后返回，观察图形是否变化。

图片是本机模拟器的页面运行画面。工程已通过页面和控件回读、0 错误 0 警告编译以及编译产物校验。只检查了运行图，尚未扫码核验实际编码内容。