外观
按钮
基础触摸按钮:按下反馈、切页、播音效,或作为弹出菜单/键盘中的子键使用。
用途
按钮处理点击类人机操作。可配置按下效果图、抬起后页面切换与动画、音频,以及键值编号。普通按钮没有独立变量存储地址,一般不通过 0x83 直接回传键值(见注意)。
典型用法
- 拖入「按钮」,调整热区大小;需要时设置按下效果图
- 若用于切页:配置 页面切换 与可选 动画效果
- 若用于弹出菜单或键盘:配置 键值
- 下载到屏后在真机或预览中验证按下反馈与切页

关键属性
| 属性 | 说明 |
|---|---|
| 按钮效果 | 按下时显示同位置另一张图;选「无」则无切图效果 |
| 页面切换 | 抬起后跳转到指定页面;选「无」不切换。选定页面后可再配切页动画 |
| 音频文件 | 按下播放指定音频(来自工程树或 音效库);选「无」时可用蜂鸣器 |
| 按键键码 | 外接键盘或寄存器触发用;同页内不可重复 |
| 键值(0x) | 双字节编号,供弹出菜单或键盘录入场景使用 |
完整属性以 VGUS Next 属性面板为准。
注意事项
注意
- ⚠️ 按钮本身无变量地址,不能直接靠 0x83 返回键值
- ⚠️ 作为弹出菜单子按钮时,可借用父控件变量地址存键值,再通过 0x83 读取
- ⚠️ 弹出菜单场景:键值高字节须为 0(范围 0000~00FF);
00FF表示不返回键值 - ⚠️ 同一页面内 按键键码不可重复
交互示例
下面是浏览器里的示意:普通按钮没有变量地址;本例演示按下反馈与切页。外观与实机不完全一致,完整行为以下载后屏端为准。帧格式见 串口指令。