3.6 ApusTAI 功能按钮控件

功能按钮用于切换画面、打开或关闭对话框和菜单、发送虚拟按键，以及批量传输寄存器。先确定按钮用途，再配置该用途需要的目标或地址。

添加与设置

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

1. 按钮用途：可选择切换画面、打开对话框、关闭对话框、虚拟按键、打开菜单、关闭菜单或批量传输。不同用途会显示相应的配置项。
2. 目标画面：切换画面或打开对话框、菜单时选择目标页面。示例为切换到“0-首页”。其他用途需填写对应的按键、菜单返回值或源/目标地址，不能照用此例。
3. 使用图片：可分别指定松开和按下图片。示例使用 IconPark（Apache-2.0）的首页图标制作两态按钮图。
4. 使用文字：设置按钮名称、字体和对齐；可分别配置松开及按下状态文字。

按需设置执行时机、条件触发、通知或声音。保存并编译后，在模拟器中确认目标页面、弹窗或按键动作；涉及寄存器传输的用途，还需检查源地址、目标地址和寄存器数量。

属性图与练习工程对照

上方带编号的属性图用于说明设置项，图中示例为 0-首页；下方可下载练习工程位于第 6 页，使用 第 0 页“控件目录”。两套设置不能混用，复现时以下载工程的实际属性为准。

练习工程关键设置：此页功能按钮的按钮用途为“切换画面”，目标为第 0 页“控件目录”；练习工程并未演示弹窗、虚拟按键或批量传输。

逐步复现与排查

1. 从目录打开第 6 页，确认页面标题为“3.6 功能按钮”。
2. 点击“返回目录”，确认回到包含 18 个练习入口的第 0 页。
3. 在 IDE 中核对按钮用途和目标画面。

结果异常时：点击后仍留在原页时，检查目标画面是否选为第 0 页，以及按钮是否被其他控件遮挡。

 

可下载练习案例

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

从目录打开第 6 页，点击“返回目录”，核对页面切换到第 0 页。

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