可视化元素：组合框、数组

象征：

类别：常用控件

该元素以列表框的形式显示数组的值。当可视化用户点击某个条目时，该条目的数组索引将写入一个整型变量。

注意

0_Sample_Project 关于列表框与数组和文本列表结合的示例项目

元素属性

所有元素属性都可用吗？

仅当您选择先进的选项或所有类别过滤特性。

元素名称	例子： `List_Product_Number` 提示为元素分配单独的名称，以便在元素列表中更快地找到它们。
元素类型	组合框，数组

位置

位置定义了元素在可视化窗口中的位置和大小。它基于笛卡尔坐标系。原点位于窗口的左上角。水平 X 轴正方向向右。垂直 Y 轴正方向向下。

X	元素左上角的 X 坐标（以像素为单位）例子：`10`
Y	元素左上角的 Y 坐标（以像素为单位）例子：`10`
宽度	以像素为单位例子：`150`
高度	以像素为单位例子：`30`

提示

您可以通过拖动运算块来更改值符号到编辑器中的其他位置。

专栏

“组合框，数组” 元素在表格视图中显示数组变量或结构变量。数组元素或结构成员的索引显示在列或行中。二维数组或结构数组显示在多列中。您可以在中指定显示的变量数据阵列财产。在那里分配变量时，您可以指定显示数组元素的表列的显示方式。您可以自定义分配给索引 n 的每列。

专栏 [<n>]	由于中定义的变量的结构数据阵列，列数是自动确定的，它们的索引为 n。示例：三列 `[0]`， `[1]`，以及 `[2]` 形成于： `StringTable : ARRAY [0..2, 0..4] OF STRING := ['BMW','Audi','Mercedes','VW','Fiat', '150','150','150','150','100','blue','gray','silver','blue','red'];`
最大数组索引	可选变量（整数数据类型）或值定义数据显示到哪个数组索引
行高	行的高度（以像素为单位）
计算可见行数	可选如果数组大于可见行数，则包括滚动条。
滚动条大小	垂直滚动条的宽度（以像素为单位）

表 10. Columns: Column [<n>] Element Property

宽度	列宽（以像素为单位）
图片专栏	：图像可以显示在列中。使用来自全局镜像池或自定义镜像池的镜像。图像 ID 按其在图像池中的定义显示在表格的单元格中。
镜像配置
填充模式	填充单元格在不固定高度/宽度比的情况下，图像会调整到单元格的大小。居中图像在单元格中居中并保持其比例（高/宽比）。
透明度	: 中指定的颜色透明的颜色显示为透明。
透明的颜色	当透明属性已启用，不显示此处指定的颜色。这种颜色的像素是透明的。
列中的文本对齐方式	左居中对
使用模板	：数组数据显示在表中。：表格单元格具有其他属性（每列可配置），即所有具有矩形的属性。这为表格单元格提供了与 a 相同的功能范围矩形。其他属性显示在模板财产。用例：为了处理用户输入（例如，在单元格中单击），该单元必须具有输入配置。这在以下情况下是可能的使用模板选项已激活。这个输入配置然后属性就可用了，可以为鼠标事件配置后续操作。示例：当用户在运行的可视化中点击以这种方式配置的单元格时，分配给该单元格的布尔变量将被切换。
模板中标题的文本对齐方式	：列标签是使用模板中的文本属性创建的。
模板	当使用模板属性已激活，此属性可见，矩形的所有属性均在其下方可用。提示的帮助中描述了这些属性及其选项矩形、圆角矩形、椭圆元素。

多变的

多变的	用户单击的列表条目的数组索引在运行时保存。变量（整数数据类型）例子： `PLC_PRG.iIndexComboboxEntry`
数据数组	显示为组合框。每个数组组件都成为一个组合框条目。数组变量 (`ARRAY[...] OF`) 例子： `PLC_PRG.astrCombobox` 宣言： `astrCombobox : ARRAY[0..4] OF STRING := ['First', 'Second', 'Third', 'Fourth'];`

文本

工具提示	字符串（不带单引号）例子： `Products of customer A` 文本作为工具提示输出。如果占位符 `%<format string>` 在文本中指定，然后在文本变量 → 工具提示属性在占位符的位置输出。

提示

使用 Ctrl+进入添加换行符的快捷方式。

提示

指定的文本会自动传输到全局文本列表文本列表。因此，这些文本可以本地化。

文本属性

这些属性获取文本属性的固定值，并作用于配置的文本文本 → 文本或者文本 → 工具提示。

的用法	默认样式值：使用可视化样式的值。个人设置：显示了 “单个文本属性” 属性组可以在那里自定义值。
单个文本属性要求：个人设置文本属性已定义。
字体	示例：默认 : 那个字体对话框打开。 : 带有样式字体的列表框
字体颜色	正常状态下的字体颜色示例：黑色 : 那个颜色对话框打开。 : 带有样式颜色的列表框
字体警报颜色	警报状态下处于活动状态的字体颜色重要它必须与正常状态下的字体颜色不同。示例：红色
透明度	整数（值范围为 `0` 到 `255`）。这决定了相应颜色的透明度。 `255`: 颜色不透明。 `0`:颜色完全透明。注意如果颜色是样式颜色并且已经具有透明度值，则此属性受到写保护。

状态变量

变量动态控制元素行为。

无形的

多变的（BOOL) 用于切换元素的可见性

TRUE：该元素在运行时不可见。

例子： bIsVisible 和 VAR bIsVisible : BOOL := FALSE; END_VAR

停用输入

多变的（BOOL) 用于切换元素的可操作性

TRUE：用户输入在运行时没有任何影响。该元素显示为已停用。

提示

这无形的 “客户端动画”功能支持属性。

中心

	这些属性包含旋转点坐标的固定值。旋转点在编辑器中显示为符号并作为旋转和缩放的中心。提示您还可以通过拖动符号移动到编辑器中的另一个位置。
X	旋转点的 X 坐标
Y	旋转点的 Y 坐标

绝对运动

这些属性可以分配给 IEC 变量，用于动态控制元素的位置。参考点是元素的左上角。运行时，整个元素都会移动。

移动
X	X 位置（以像素为单位）的变量（数字数据类型）例子：`PLC_PRG.iPos_X` 容器变量：`Container.Width` 有关详细信息，请参阅下列内容：优化调整位置和大小在运行时增加此值会将元素向右移动。
Y	Y 位置（以像素为单位）的变量（数字数据类型）例子：`PLC_PRG.iPos_Y` 容器变量：`Container.Height` 有关详细信息，请参阅下列内容：优化调整位置和大小在运行时增加此值会使元素向下移动。
旋转	旋转角度（以度为单位）的变量（数字数据类型）例子：`PLC_PRG.iAngle1` 元素的中点在中心点。该旋转点显示为象征。在运行时，元素的对齐方式相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。
内旋	旋转角度（以度为单位）的变量（数字数据类型）例子：`PLC_PRG.iAngle2` 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式根据可视化的坐标系旋转。在代码中增加该值会顺时针旋转。旋转点显示为象征。注意如果在位置 → 角度属性，则在执行可视化时，静态旋转角度会添加到可变旋转角度（偏移）中。

提示

您可以将变量组合成单位换算。

提示

这十，是，旋转，和内旋属性由“客户端动画”功能支持。

动画片

提示

仅当您选择了支持客户端动画和原生元素叠加选项可视化管理器。

动画持续时间

元素运行动画的持续时间（以毫秒为单位）的变量

变量（整数值）
例子：Menu.tContent和VAR tContent : INT := 500; END_VAR
整数文字
例子：500

. 可动画的属性

绝对运动，移动，十，是
绝对运动，旋转
绝对运动，内旋
绝对运动，外旋

当可动画属性的至少一个值发生变化时，就会执行动画移动。此时执行的移动不会出现抖动，而是在指定的动画时长内保持平滑。可视化元素会动态旋转并移动到指定位置。过渡非常流畅。

移至前台

多变的（BOOL）用于将元素设置在前景中

TRUE：在运行时，可视化元素显示在前台。

FALSE：在运行时，可视化元素显示在可视化编辑器中插入它的层中。

例子：bIsInForeground和VAR bIsInForeground : BOOL := FALSE; END_VAR

输入配置

提示

这配置按钮打开输入配置对话。您可以在此处为事件分配后续操作。

OnValueChanged

由于值的变化而触发后续动作的事件

触发哪些后续动作在输入配置对话。

定义的后续动作和相应的配置显示在元素属性下方。

这 OnValueChanged 事件可以被禁用 VISU_NO_VALUECHANGED 编译器在应用程序的属性对话框中定义。

权限

注意

仅当设置了用户管理以实现可视化时才可用。

访问权限按钮

打开访问权限对话框。您可以在那里编辑元素的访问权限。

. 状态消息：

未设置。完整权限。：所有用户组的访问权限：可操作
权利设定：有限权利：至少有一个组的访问受到限制。

本节内容如下:

X	元素左上角的 X 坐标（以像素为单位）例子：`10`
Y	元素左上角的 Y 坐标（以像素为单位）例子：`10`
宽度	以像素为单位例子：`150`
高度	以像素为单位例子：`30`

移动
X	X 位置（以像素为单位）的变量（数字数据类型）例子：`PLC_PRG.iPos_X` 容器变量：`Container.Width` 有关详细信息，请参阅下列内容：优化调整位置和大小在运行时增加此值会将元素向右移动。
Y	Y 位置（以像素为单位）的变量（数字数据类型）例子：`PLC_PRG.iPos_Y` 容器变量：`Container.Height` 有关详细信息，请参阅下列内容：优化调整位置和大小在运行时增加此值会使元素向下移动。
旋转	旋转角度（以度为单位）的变量（数字数据类型）例子：`PLC_PRG.iAngle1` 元素的中点在中心点。该旋转点显示为象征。在运行时，元素的对齐方式相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。
内旋	旋转角度（以度为单位）的变量（数字数据类型）例子：`PLC_PRG.iAngle2` 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式根据可视化的坐标系旋转。在代码中增加该值会顺时针旋转。旋转点显示为象征。注意如果在位置 → 角度属性，则在执行可视化时，静态旋转角度会添加到可变旋转角度（偏移）中。