Skip to content

嵌入窗口

嵌入窗口

在当前页面的窗口区域内嵌入另一张画面,并可按偏移量平移显示,适合子界面、局部大图与分区导航。

用途

嵌入窗口指定要嵌入的画面,并用 变量存储地址(VP) 控制显示偏移:VP 为水平偏移,VP+1 为垂直偏移。MCU 通过 0x82 写这两个字即可平移嵌入内容;开启上传偏移时,用户滑动产生的偏移可通过 0x83 回传。

典型用法

  1. 单独设计好要嵌入的子画面(内容通常大于窗口可视区)
  2. 在主页面拖入「嵌入窗口」,选择 指定嵌入到窗口的画面
  3. 设置 变量存储地址:该地址存 X 偏移,下一字地址存 Y 偏移
  4. 选择背景模式(图片 / 透明 / 单色),按需开启触摸滑动与偏移上传
  5. 下载后滑动或由 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 连续写这两个字。外观与实机不完全一致,完整行为以下载后屏端为准。帧格式见 串口指令

相关内容