Localized Text 多语言文本

Localized Text(多语言文本)是 HQ VISU 的一类「文本行为」(Text 行为),在 Behavior Browser 里绑定到文本组件上。它不显示固定文字,而是显示一个「语言键」对应的翻译:运行时根据当前语言,从全局翻译表里取出该键的文本并显示出来。切换语言时,绑定了该行为的所有文本会自动换成对应语言,不需要为每种语言单独做一页。适合界面上那些“内容固定、但要随语言变化”的文案,比如按钮名、标题、状态提示、菜单项。

文本

文本: Localized Text 多语言文本

把文本组件绑定到一个语言键(Text Key),运行时按当前语言自动显示对应翻译;查不到翻译时回退到 Default Text,再回退到键本身。用于按钮、标题、状态、菜单等需要随语言切换的固定文案。

功能说明

Localized Text(多语言文本)是 HQ VISU 的一类「文本行为」(Text 行为),在 Behavior Browser 里绑定到文本组件上。它不显示固定文字,而是显示一个「语言键」对应的翻译:运行时根据当前语言,从全局翻译表里取出该键的文本并显示出来。切换语言时,绑定了该行为的所有文本会自动换成对应语言,不需要为每种语言单独做一页。适合界面上那些“内容固定、但要随语言变化”的文案,比如按钮名、标题、状态提示、菜单项。

使用方法:编辑器里填的字段

在 Behavior Browser 中给文本组件添加 Localized Text 行为,编辑器只有两个填写项(这是纯查表显示,没有脚本、没有 Quality Border):

  • Text Key:语言键,例如 pump.start。运行时用这个键去全局翻译表里查当前语言的文本。
  • Default Text:兜底文本。翻译表里查不到该键时显示它(也可作为编辑期占位)。
  • 回退顺序:① 当前语言包里的翻译 → ② Default Text → ③ 直接显示键本身(说明没匹配到翻译)。
  • 导出提示:编辑器会提示“文本会被压平成一行”,多行内容会被合并成单行。
Text Key:     pump.start
Default Text: 启动泵

适用场景

当同一画面要支持多语言、又不想为每种语言复制页面时使用。典型场景:

  • 一个「启动/Start」按钮,配一个 Text Key(如 pump.start),中文环境显示“启动”,英文环境显示“Start”。
  • 画面标题、设备状态提示、导航菜单项等固定文案统一走语言键,运行时切换语言后同步更新。

边界与易错点

翻译要生效,前提是这个 Text Key 在全局翻译表里确实存在、且当前语言已正确切换;否则会回退到 Default Text,键名拼错时甚至直接把键本身显示出来。另外注意:这里行为里的字段叫 Text Key,和组件「多语言设置」(Language Settings) 对话框里的 Enable language binding / Language Key 是两套入口,不要把两者混在一起配置。运行时语言由宿主切换,可用 qtedit.useLanguage(...) 配合 qtedit.notifyLanguageChange() 触发刷新。

Localized Text 多语言设置
图示 1: 多语言设置 Language Settings

把文本组件绑定到语言键,运行时按当前语言显示对应翻译,查不到时回退。