3.4 ApusTAI 字设置按钮控件

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

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

适用版本：ApusTAI 1.0.27。

字设置按钮向寄存器写入数值，可用于写常量、点动设置、递增或递减。它执行写入动作；需要持续显示寄存器当前值时，应另用数值显示或输入控件。

添加与设置

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

1. 写入地址：选择目标寄存器。图中的 LW0301 是测试工程示例。
2. 操作模式：“写常量”写入固定值；“点动设置”分别指定按下值和松开值；“递增”“递减”需指定步长、最小值和最大值，可按需开启循环调节或长按调节。示例为递增、步长 1、范围 0 至 100。根据目标寄存器设置 UINT16、INT16、UINT32 或 INT32 数据类型，并核对执行时机。
3. 使用图片：可为松开和按下分别设置图片。示例使用 Remix Icon（Apache-2.0）的加号图标制作两态按钮图。
4. 使用文字：设置按钮文字、字体和对齐；ALL 用于统一编辑，松开/按下状态可分别调整。

保存并编译后，分别验证点击与长按时目标寄存器的值，尤其检查范围、循环调节和有符号数据类型是否符合实际需求。

属性图与练习工程对照

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

练习工程关键设置：练习工程使用“写常量”模式，向 LW0303 写入 UINT16 值 50；下方数值控件读取 LW0303。属性示意图中的“递增 1”是另一种操作模式。

逐步复现与排查

1. 进入第 4 页，读取按钮下方的当前数值。
2. 点击“设为 50”，确认下方读数变为 50。
3. 在 IDE 中核对操作模式是写常量、常量值为 50，读数控件与按钮共用 LW0303。

结果异常时：读数不变时，检查按钮的写入地址、数据类型和执行时机；不要把属性示意图的递增设置当成此页工程配置。

 

可下载练习案例

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

打开第 4 页，点击“设为 50”，检查 LW0303 的下方读数是否为 50。

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