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

象征：

类别：常用控件

该元素以列表框的形式显示值。当用户点击某个条目时，该条目的 ID 会被写入一个整型变量。列表框中的条目可以来自列表，也可以包含来自图像池的图像。

注意

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

元素属性

所有元素属性都可用吗？

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

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

位置

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

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

提示

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

多变的

通过组合框编辑的变量

要显示与列表匹配的文本，还必须配置相应的文本列表。

使用支持文本列表的枚举时，无需配置其他文本列表。

变量（整数数据类型）。只允许使用数字 ID 。
例子：
PLC_PRG.iIDComboboxEntry
PLC_PRG.eStateTrafficLight (参见下面的例子 ”TrafficLight“)
带有文本列表支持的枚举变量
例子： PLC_PRG.eMyCombobox
选择枚举变量后，数据类型会自动补充。

文本列表

扩展组合框中显示的文本列表的名称。

最多可显示 32766 个条目。

文本列表标识符作为字符串
例子：
'TextList_A'
'TrafficLight' （看 TrafficLight 示例如下）
文本列表的 ID 必须在以下值范围内： DWORD 或者 DINT。
空白的
- 当在中指定了支持文本列表的枚举变量时多变的财产
- 仅显示一个图像池时

图像池

图像池的名称，其图像显示为组合框中的条目

例子： 'ImagePool_A'

例 28. 例子

TrafficLight

列表的设置

当可视化用户单击元素时展开的显示列表。

行数设置	从风格：显式: 那么可见行数属性出现在其下方。
计算可见行	此处定义的组合框列表的可见行数整数字面量例子： `5` 变量（整数数据类型）例子： `PLC_PRG.iNumberOfVisibleRows` 注意该物业仅在以下情况下可用行数设置属性设置为显式.
行高	从风格：文字例子： `20`
图像高度	列表框条目中显示的图像的图像高度（以像素为单位）从风格：整数字面量例子： `30` 注意仅当在图像池财产。
图像宽度	列表框条目中显示的图像的图像宽度（以像素为单位）从风格：文字例子： `30` 注意仅当在图像池财产。
图像偏移	使列表框中的图像显示为从左边距偏移（以像素为单位）。偏移量 `0` 表示图像直接显示在边缘。从风格：文字例子： `4` 注意仅当在图像池财产。
滚动条大小	滚动条的大小（以像素为单位）当列表框中指定的条目多于列表框中的条目时，将显示滚动条可见行数. 默认： `20`

文本

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

提示

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

提示

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

数值范围

限值范围	要求：在文本列表财产。：仅由最小值最大值属性显示为列表框。将文本列表限制为一个子范围。该子范围由组合框显示。
最小值	显示组合框条目的文本列表条目的 ID 字面量 (`ANY_NUM`) 例子： `5` 变量（整数数据类型）例子： `PLC_PRG.iFirstEntry`
最大值	显示组合框条目的文本列表条目的 ID 字面量 (`ANY_NUM`) 例子： `10` 变量（整数数据类型）例子： `PLC_PRG.iLastEntry`
过滤缺失的文本条目	要求：在文本列表财产。：刷新文本列表并删除所有未使用的文本 (ID)。

文本属性

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

的使用	默认样式值，则接受可视化样式的值个人设置这单个文本属性显示属性组。可以在此处自定义值。

单个文本属性
水平对齐	元素内文本的水平对齐
垂直对齐	元素内文本的垂直对齐方式
字体	例子：默认：这字体对话框打开。 : 带有样式字体的列表框
字体颜色	例子：黑色的：这颜色对话框打开。：带有样式颜色的列表框
透明度	整数（值范围从 `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` 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式根据可视化的坐标系旋转。在代码中增加该值会顺时针旋转。旋转点显示为象征。注意如果在位置 → 角度属性，则在执行可视化时，静态旋转角度会添加到可变旋转角度（偏移）中。