文本列表

概述

文本列表是一种对象，在应用程序树的全局节点中全局对其进行管理，或将其分配至应用程序树中的应用程序。

它用于以下用途：

• 对于可视化和警报处理中的静态和动态文本及工具提示的多语言支持

• 动态文本交换

可导出并重新导入文本列表。如果必须为目标可视化提供 XML 格式的语言文件，则必须进行导出，但是也可用于转换。

可用的文本列表格式：

• 文本

• XML

您可激活对 Unicode 的支持。

每个文本列表唯一地由其命名空间定义。它包含由标识符（ID，由任何字符序列组成）在列表中唯一引用的文本字符串以及语言标识符。在配置可视化元素的文本时指定要使用的文本列表。

根据在可视化中设置的语言，将于在线模式下显示相应的文本字符串。可视化中使用的语言通过更改语言输入来更改。这通过您在给定可视化元素上配置的鼠标操作来完成。每个文本列表必须至少包含一种缺省语言，您可选择定义其他语言。如果未找到与 EcoStruxure Machine Expert 中当前设置的语言相匹配的条目，将使用该文本列表的缺省语言条目。每项文本可包含格式化定义。

文本列表的基本结构

文本列表类型

有两类文本可在可视化元素中使用，并且相应地有两类列表：

• 静态文本的 GlobalTextList

• 动态文本的文本列表

静态文本的全局文本列表

全局文本列表是一种特殊的文本列表，其中特定文本条目的标识符以隐式方式处理，并且不可编辑。可导出该列表，在外部进行编辑，然后重新导入。

与动态文本相比，在线模式下可视化中的静态文本不通过变量交换。用于交换可视化元素的语言的唯一选项是通过更改语言输入。将通过类别文本中的属性文本或工具提示将静态文本分配至可视化元素。一旦在项目中定义了第一个静态文本，则会将名称为全局文本列表的文本列表对象添加至应用程序树的全局节点。它包含定义的文本字符串（可在缺省列中找到），以及一个自动分配的整数，作为文本标识符。对于之后创建的每个静态文本，标识符编号逐一增加并分配给可视化元素。

如果将静态文本输入可视化元素（例如，如果在属性类别文本的矩形中，指定了文本示例字符串），将在全局文本列表中查找该文本。

• 如果找到了文本（例如 ID 4711，文本示例），TextId 的元素值 4711 将分配至内部变量。这将在元素和全局文本列表中对应的行之间建立关系。

• 如果未找到文本，将在全局文本列表中插入新行（例如 ID 4712，文本示例）。在元素中，值 4712 将分配至内部变量。

如果已导出、编辑并重新导入了全局文本列表，将验证标识符是否仍匹配在相应可视化元素的配置中使用的那些标识符。如果必要，将实现在配置中使用的标识符的隐式更新。

如要更新为可视化定义的文本的 ID 号，您可以右键单击节点，然后执行删除命令，从而删除全局文本列表。然后打开可视化，执行命令可视化 > 创建全局文本列表。在应用程序树中便会创建新的全局文本列表节点，其中包含项目中可用的可视化的静态文本。

全局文本列表的示例

创建全局文本列表

动态文本的文本列表

可于在线模式下动态修改动态文本。属于字符组成的字符串的文本索引 (ID) 必须在文本列表中为唯一。与全局文本列表不同，您必须定义它。同样与全局文本类别相比，显式创建动态文本的文本列表的方式为：选择全局节点，单击绿色加号按钮，并执行命令添加其他对象 > 文本列表...。

在通过属性动态文本 / 文本列表配置可视化元素时，会提供可用的动态文本列表。如果您指定具有文本索引 (ID)（该索引可直接输入或通过输入定义 ID 字符串的项目变量来输入）的文本列表名称，则可于在线模式下修改文本。

如果需要将动态文本列表作为语言文件用于目标可视化中的语言切换，则必须导出动态文本列表。在 Visualization Options 中指定文件路径。和全局文本列表类似，也可导出动态文本列表用于外部编辑，然后重新导入。和全局文本列表不同的是，在重新导入动态文本列表时，将不会自动检查和更新标识符。

名为 ErrorList 的动态文本列表的示例

ErrorList 示例

详细示例

该示例说明了如何配置可视化元素，当在处理错误事件（通过分配给整型变量 ivar_err 的数字 ID 标识）的应用程序中检测到错误时，该元素会显示相应的消息。

提供名为 ErrorList 的动态文本列表，其中错误 ID O 到 4 的消息文本以语言德语、英语和缺省值定义：

在表格的单元格中，您可以按键盘快捷键 Ctrl + Enter，以此添加换行符。

要在可视化配置中使用错误 ID，可定义 STRING 变量，例如 strvar_err。要将整型值 ivar_err 分配给 strvar_err，可使用 strvar_err:=INT_TO_STRING(ivar_err);。

strvar_err 现在可作为 Textindex 参数在可视化元素的动态文本属性的配置中输入。该元素将显示在线模式下相应的信息。

下面是使用项目变量和可视化元素的配置（属性）处理错误 ID 的示例，将显示相应消息：

创建文本列表

• 要为动态文本创建文本列表，可将文本列表对象添加至应用程序树中的项目。要创建特定于应用程序的文本列表，可选择应用程序代码；要创建全局文本列表，可选择全局节点。然后单击所选节点的绿色加号按钮，并执行命令添加其他对象 > 文本列表...。如果您已经指定了列表名称并确认了添加文本列表对话框，新的列表将插入所选节点下，并将打开文本列表编辑器视图。

• 要获取静态文本的文本列表（全局文本列表），可在虚拟化对象的类别文本的属性文本中分配文本，或通过命令创建全局文本列表显式创建它。

• 要打开现有文本列表进行编辑，可在应用程序树或应用程序树的全局节点中选择列表对象。右键单击文本列表节点并执行命令编辑对象，或双击文本列表节点。有关文本列表结构方式的信息，请参阅文本列表的基本结构。

• 对于在文本列表中新增缺省文本，可使用命令插入文本，或者在列表的空行中编辑相应字段。要编辑文本列表中的字段，可单击字段将其选中，然后再次单击字段或按 SPACE 得到编辑框。输入所需的字符并通过 RETURN 关闭编辑框。

Unicode 格式支持

要使用 Unicode 格式，在可视化管理器中激活相应选项。接下来，为应用程序设置特殊编译指令：在设备树中选择应用程序，打开属性对话框的生成选项卡：在编译器定义字段中，输入 VISU_USEWSTRING。

带编辑器定义的对话框

文本列表的导出和导入

静态和动态文本列表可用 CSV 格式导出。导出的文件也可用于在外部添加文本，例如通过外部转换器来操作。但是，仅可重新导入文本格式 (*.csv) 的文件。

请参阅相应文本列表命令的说明。

在对话框文件 > 项目设置 > 可视化对话框中指定应当保存导出文件的文件夹。

文本格式化

文本可包含特定格式化定义（%s,%d、...），这些定义允许包含文本中变量的当前值。有关可用格式化字符串的信息，请参阅 EcoStruxure Machine Expert 在线帮助的可视化部分。

当使用含有格式化字符串的文本时，采用以下顺序完成替换：

• 通过列表名称和 ID 搜索要使用的实际文本字符串。

• 如果文本包含格式化定义，这些定义将由相应变量的值替代。

转换的文本的后续提供

通过在用于加载文本文件的目录中插入 GlobalTextList.csv，可进行已转换文本的后续集成。当启动项目启动时，固件会检测到其他文件可用。该文本将与现有文本列表文件中的文本相比较。然后，新增和修改的文本会应用到文本列表文件。更新的文本列表文件将在下一次启动时应用。

为文本输入列出组件

通过对话框工具 > 选项 > 可视化，可以指定文本模板文件。该文件缺省值列的所有文本都将复制至一个列表，该列表将用于列出组件功能。可使用模板文件，该文件在之前已通过导出命令创建。

多用户操作

通过使用源控制，多个用户可同时在同一项目上工作。如果多个用户在可视化元素中修改了某静态文本，将导致全局文本列表的修改（参阅全局文本列表）。在这种情况下，文本 Id 将不再与可视化元素相关联。使用以下错误检测和校正方法：

• 使用命令检查可视化文本 Id，可能在可视化中检测到这类错误。

• 使用命令更新可视化文本标识部分，可自动解决这些检测到的错误。受影响的可视化以及全局文本列表必须有写入权限。

使用文本列表来更改可视化中的语言

如果有适合的文本列表可用并且该文本列表为文本定义了数个语言版本，则在线模式下通过在可视化元素上进行输入，可切换用于可视化中文本的语言。元素的动态文本属性必须指定要使用的文本列表，以及 OnMouse.. 输入操作，必须配置更改语言，以指定在执行鼠标操作后使用的语言。