VGUS Next

外观

文字标签 ​

文字标签

多语言/多条目文本显示控件：既可绑定工程文字标签表（TextTag.csv），也可绑定变量存储器中的字符串。

用途 ​

文字标签适合界面文案、多语言切换与统一改字。数据来源为「文字标签工具」时，从标签表取文；为「变量存储器」时，行为接近文本变量，可通过 0x82 更新。

典型用法 ​

  1. 在窗口顶部「工程」页的 工具 分组点 文字标签，打开文字标签工具，维护词条（多语言列）。多语言工程建议勾选 启用多语言全局字库，步骤见 字库
  2. 拖入「文字标签」，选择 数据来源
  3. 来源=文字标签工具：选 标签名称，并把 语言索引的变量存储地址 配好（与全局字库索引地址相同时自动用全局矢量字库，不必再设 FONT0/FONT1）
    来源=变量存储器：设地址、字长度与初始值
  4. 按需启用滚动显示或触摸录入；下载验证切换语言或刷新变量后的显示

文字标签属性设置面板

关键属性 ​

属性说明
数据来源文字标签工具 或 变量存储器
标签名称来源=文字标签工具时，选择表中标签
变量存储地址(0x)来源=变量存储器时的字地址
初始值仅变量存储器来源时可编辑的上电文本
文本的字地址长度变量模式下占用长度
语言索引的变量存储地址(0x)来源=文字标签工具时，与工具中的语言列对应；与全局字库索引地址相同时走全局矢量字库
显示模式多行显示 / 滚动 / 循环滚动
水平对齐方式 / 垂直对齐方式文本在框内对齐
透明背景是否透明显示
启用录入是否支持触摸弹出键盘改字
FONT编码方式未走全局字库时的编码；匹配全局字库后不必再设

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

注意事项 ​

注意

  • 💡 来源为文字标签工具时，内容来自 TextTag.csv，不是属性里直接写死长文
  • ⚠️ 初始值仅在「变量存储器」来源下可编辑
  • 💡 矢量字库或全局字库预览时，编码可能强制为 UNICODE/UTF8
  • 💡 走全局矢量字库时：改词条或改语言字体后须重新点 生成矢量字库并添加到项目；固件需 2026-05-23 及之后
  • 💡 变量模式下写入规则与文本变量类似，注意字长度与 0xFFFF 结束符

交互示例 ​

下面是浏览器里的示意：本例数据来源为文字标签工具，右侧按钮模拟 MCU 0x82 写 语言索引，切换中文 / English / 日本語。外观与实机不完全一致，完整行为以下载后屏端为准。帧格式见 串口指令。

相关内容 ​