VGUS Next

外观

滚动文本 ​

滚动文本

在指定区域内以滚动方式显示较长文本（跑马灯效果），适合公告、报警提示、状态说明等。

用途 ​

滚动文本按设定方向与间距在控件区域内循环滚屏。文本内容存放在变量存储器中，MCU 通过 0x82 写入即可刷新。注意：文本实际从「变量存储地址 +3」开始存放，前 3 个字单元保留不用；写入须以 0xFFFF 作为结束标志。

典型用法 ​

  1. 在页面上拖入「滚动文本」，调整区域大小以覆盖跑马灯显示范围
  2. 设置 变量存储地址、字长度、字库与颜色，并选择 滚屏模式（左/右/上/下）
  3. 下载工程后，MCU 从「地址 +3」起写入文本，并以 0xFFFF 结尾
  4. 文本超出显示区时按滚屏模式滚动；不足一屏时按对齐方式静止显示

滚动文本属性设置面板

关键属性 ​

属性说明
变量存储地址(0x)字地址 0000~FFFF；文本从该地址 +3 开始存储，0x82 写此地址刷新
初始值上电初值；仅当屏参启用「变量初值由配置文件决定」时有效
字长度用于工具分配与冲突检查；实际显示以 0xFFFF、字长度或框尾先到者为准
滚屏模式从右向左 / 从左向右 / 从上向下 / 从下向上
滚屏间距每个刷新周期滚动的像素点阵数
文本颜色 / 对齐方式颜色与不足一屏时的对齐
FONT0 / FONT1 IDASCII 与中文字库；需先加入工程字库列表
FONT1 编码方式GB2312 / GBK / UTF8 等
Y方向点阵数字体高度，须为偶数

完整属性以 VGUS Next 属性面板为准。

注意事项 ​

注意

  • ⚠️ 用 0x82 写文本时必须从「变量存储地址 +3」开始，并以 0xFFFF 结尾
  • ⚠️ 字长度大于实际内容时，若未写结束符，尾部可能显示垃圾数据
  • ⚠️ 最大允许长度约 1024 字；汉字计 1、ASCII 计 0.5
  • ⚠️ 描述指针 默认 FFFF（关闭）；启用后勿与业务地址重叠

交互示例 ​

下面是浏览器里的示意：文本从变量地址 +3 起存放；MCU 写入后超出显示区会滚动。外观与实机不完全一致，完整行为以下载后屏端为准。帧格式见 串口指令。

相关内容 ​