文档手册

多语言绑定：Language Key、Default Text 和保存检查

在 PowerPoint 当前页选择一个支持文本的组件，打开 Behavior Browser，在 Text 分类中绑定 Localized Text，或打开该文本组件对应的 Language binding 编辑窗口。窗口标题区会提示 Connect this text component to a language key while keeping a readable fallback。

多语言

多语言: 多语言绑定：Language Key、Default Text 和保存检查

本节说明如何把当前文本组件绑定到语言键。只讲界面入口、字段填写、保存结果和常见失败，不展开翻译运行机制。

从文本组件进入多语言绑定

先选中文本框、带文字的图形或支持文字的模板对象。
普通线条、图片等不支持文本的对象不能绑定文本行为。
已有绑定：双击左侧组件下的 Localized Text 重新编辑。
新绑定：从右侧 Text 分类拖到左侧组件节点。

Enable language binding 怎么选

勾选 Enable language binding 后，该组件使用 Language Key 查找当前语言文本；取消勾选后，不再使用这条语言绑定。需要临时停用多语言但保留键名和默认文案时，可以取消勾选后保存。

需要运行时切换语言：保持勾选。
暂时只显示固定文案：取消勾选。
勾选状态改变后必须点击 OK 才会写回当前组件。

填写 Language Key 和 Default Text

Language Key 填翻译表中稳定、唯一的键名，例如 screen.pump.start。Default Text 填查不到翻译时仍能让现场人员理解的默认文案，例如启动。两个字段都按显示需要填写，不要把 PLC Tag、模板变量或整段脚本放进 Language Key。

同一含义在不同页面重复出现时，复用同一个稳定键名。
键名大小写必须和语言字典一致。
Default Text 不留空，确保翻译缺失时页面仍可读。
Default Text 的换行和首尾空格会被保留，保存前检查排版。

Language Key: screen.pump.start
Default Text: 启动

保存后怎么确认成功

点击 OK 后关闭窗口，再双击该行为重新打开，确认 Enable language binding、Language Key 和 Default Text 都保持不变。导出页面后，在 HQControl 中切换至少两种已有语言；已有翻译时应显示对应语言，缺少翻译时应显示 Default Text。

重新打开编辑器，确认字段已保存。
导出后切换语言，检查目标组件是否刷新。
故意使用缺少翻译的语言环境，确认 Default Text 能显示。
同页多个文本使用同一个键时，确认它们的默认文案没有互相冲突。

翻译不生效时按顺序排查

先确认绑定开关已启用，再逐字核对 Language Key，之后确认当前语言字典确实包含该键，最后确认宿主已经切换语言并触发页面刷新。若仍显示键名或空白，先补正确的 Default Text，再回到语言字典修正缺失项。

编辑器重新打开后开关是否仍为启用。
Language Key 是否有拼写或大小写差异。
目标语言是否包含该键。
Default Text 是否为空。
页面是否在语言切换后重新刷新文本。