外观
嵌入窗口
在当前页面的窗口区域内嵌入另一张画面,并可按偏移量平移显示,适合子界面、局部大图与分区导航。
用途
嵌入窗口指定要嵌入的画面,并用 变量存储地址(VP) 控制显示偏移:VP 为水平偏移,VP+1 为垂直偏移。MCU 通过 0x82 写这两个字即可平移嵌入内容;开启上传偏移时,用户滑动产生的偏移可通过 0x83 回传。
典型用法
- 单独设计好要嵌入的子画面(内容通常大于窗口可视区)
- 在主页面拖入「嵌入窗口」,选择 指定嵌入到窗口的画面
- 设置 变量存储地址:该地址存 X 偏移,下一字地址存 Y 偏移
- 选择背景模式(图片 / 透明 / 单色),按需开启触摸滑动与偏移上传
- 下载后滑动或由 MCU 用 0x82 写 VP / VP+1 验证平移

关键属性
| 属性 | 说明 |
|---|---|
| 变量存储地址(0x) | 偏移基址:VP=X 偏移,VP+1=Y 偏移;用 0x82 写入 |
| 嵌入页面ID | 被嵌入的工程画面 |
| 背景显示模式 | 跟随页面 / 图片背景 / 透明背景 / 单色背景 |
| 上传显示偏移量 | 滑动改偏移后是否经 0x83 上传 |
| 触摸滑动 | 是否支持手指拖动平移嵌入内容 |
| 动画方式切换 | 仅改 VP 切换且无触摸时,是否带动画 |
| 背景颜色 | 单色背景时的填充色 |
| 滚动条宽度 / 颜色 | 内容超出窗口时的滚动条样式 |
完整属性以 VGUS Next 属性面板为准。
注意事项
注意
- ⚠️ 嵌入画面与主画面是两套页面资源,改子页内容后需重新编译下载
- ⚠️ 务必预留连续两个字地址给 VP / VP+1,勿与其他变量冲突
- ⚠️ 窗口尺寸决定可视区域;偏移过大时只会看到嵌入页的边缘部分
交互示例
下面是浏览器里的示意:在窗口内拖动平移嵌入的子画面。VP 为水平偏移,VP+1 为垂直偏移。MCU 可用 0x82 连续写这两个字。外观与实机不完全一致,完整行为以下载后屏端为准。帧格式见 串口指令。