可视化元素：图像切换器

象征：

类别：灯/开关/位图

该元素显示三个引用图像之一。鼠标动作改变显示的图像。图像定义在图像设置元素属性。鼠标点击的效果定义在元素行为财产。

元素属性

所有元素属性都可用吗？

只有在您选择 “” 后，所有属性才可用高级选项或所有类别过滤特性。

元素名称	例子： `ImageSwitcher_1` 提示为元素指定单独的名称，以便更快地在元素列表中找到它们。
元素类型	图像切换器

位置

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

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

提示

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

多变的

多变的	多变的（`BOOL`）。变量的值根据用户输入而变化，它独立于元素行为元素属性。

图像设置

图像，如果“打开”	镜像池中指定镜像的ID 如果变量多变的财产有其价值 `TRUE`。提示您还可以使用输入助手选择图像。
图像，如果“关闭”	镜像池中指定镜像的ID 如果变量多变的财产有其价值 `FALSE`。提示您还可以使用输入助手选择图像。
图像，如果“推”	要求：元素行为被设定为图像切换器。镜像池中指定镜像的ID 在运行时，当单击元素（并按住鼠标按钮）时，可视化会显示引用的图像。提示您还可以使用输入助手选择图像。
透明度	：这透明色被选中。
透明色	要求：透明度被激活。具有透明颜色的图像像素显示为透明。：这颜色对话框打开。：带有颜色名称的列表框打开。
缩放类型	定义图像如何适合元素框架固定的：无论元素大小如何，都会保留图像的原始大小。各向同性：整个图像显示在元素框中，无论是放大还是缩小。结果，高度和宽度的比例被保留。各向异性：图像自动调整为元素框的尺寸，填充整个元素框。因此，比例不会保留。
水平对齐	要求：缩放类型是各向同性。元素框架或元素内图像的水平对齐左边居中正确的
垂直对齐	要求：缩放类型是各向同性。元素框架或元素内图像的垂直对齐顶部居中底部

元素行为

图像切换器: 每次点击鼠标都会切换图像。
图像窃听器：当可视化用户按住鼠标按钮时，图像打开显示属性。同时，价值 TRUE 被分配到多变的财产。

点击错误

standard icon : : 按下鼠标按钮时，图片属性显示和多变的属性获取值 FALSE 而不是价值 TRUE，然后回来。

要求：图像窃听器被选中在元素行为财产。

文本

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

提示

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

提示

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

闪烁

中的值眨眼间隔指定元素在打开状态的图像和关闭状态的图像之间变化的时间间隔（以毫秒为单位）。

要求：可视化运行为 WebVisu 和支持客户端动画和原生元素叠加可视化管理器中的选项已启用。该元素只能在这种情况下闪烁。

有关更多信息，请参阅：组：常规设置

眨眼间隔

传输到的图像的闪烁间隔（以毫秒 (ms) 为单位）图像设置

为 0（默认设置）时，元素不闪烁，但打开状态的图像 (图像，如果“on”属性）永久显示。

变量（类型 UDINT）用于程序控制的图像变化
例子： PLC_PRG.udiBlinking
文字（类型 UDINT),
定义打开状态图像变为关闭状态图像的时间间隔
例子： 1000 持续 1 秒

状态变量

变量动态控制元素行为。

无形的

多变的（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.iScaling` 参考点是中心财产。价值 `1` 将元素缩小一个因子 `0.001`.价值 `1000` 将元素返回到其原始大小。
内部旋转	旋转角度的变量（数字数据类型）（以度为单位）例子： `PLC_PRG.iAngle2`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。注意如果在位置→角度属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。

提示

您可以将变量组合到单位换算.

提示

这 X, 是, 回转，和内部旋转 “客户端动画”功能支持属性。

动画

提示

这些属性仅在您选择了支持客户端动画和原生元素叠加中的选项可视化管理器.

动画时长

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

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

. 动画属性

绝对运动, 移动, X, 是
绝对运动, 回转
绝对运动, 内部旋转
绝对运动, 外旋

当可动画属性的至少一个值发生变化时，将执行动画移动。然后执行的运动不是生涩的，而是在指定的动画持续时间内是平滑的。可视化元素在动态旋转的同时移动到指定位置。过渡很平滑。

移至前台

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

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

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

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

输入配置

属性包含使用鼠标或键盘时用户输入的配置。用户输入定义了一个事件和一个或多个在事件发生时执行的动作。

提示这配置按钮打开输入配置对话。您可以在那里创建或编辑用户输入。配置的用户输入列在事件下方。它们每个都包括触发的动作和简短形式的设置。例子：执行 ST 代码： `PLC_PRG.i_x := 0;`
OnDialogClosed	输入事件：用户关闭对话框。
鼠标点击	输入事件：用户在元素区域完全点击鼠标按钮。单击并释放鼠标按钮。
鼠标按下	输入事件：用户点击鼠标按钮。
OnMouseEnter	输入事件：用户将鼠标指针拖到元素上。
鼠标离开	输入事件：用户将鼠标指针拖离元素。
鼠标移动	输入事件：用户将鼠标指针移动到元素区域上。
OnMouseUp	. 输入事件：用户在元素区域内释放鼠标按钮。用户之前是否在元素区域内部或外部按下鼠标按钮是无关紧要的。用户在元素区域内按下鼠标按钮，离开元素区域，然后释放鼠标按钮。注意这 CODESYS- 特定的触发行为保证关键元素的动作完成。一个关键元素开始一个动作鼠标按下并结束动作 OnMouseUp. 示例：可视化用户在关键元素的元素区域内按下鼠标按钮，然后移动光标位置，使其位于元素区域之外。无论如何，该操作都结束了，因为 OnMouseUp 被触发。

轻敲	当鼠标点击事件发生时，定义在多变的在应用程序中进行了描述。编码取决于点击错误和如果捕获，请点击输入选项。
多变的	要求：点击错误选项未激活。多变的（`BOOL`) 用于鼠标点击事件 `TRUE`: 存在鼠标点击事件。只要用户在元素上按下鼠标按钮，它就会持续。它在按钮被释放时结束。 `FALSE`: 鼠标点击事件不存在。例子： `PLC_PRG.bIsTapped`
点击错误	: 鼠标点击事件导致一个互补值多变的. `TRUE`: 鼠标点击事件不存在。 `FALSE`: 当鼠标点击事件存在时。
如果捕获，请点击输入	：在用户输入过程中，还考虑在按下鼠标按钮时是否在元素区域内拖动鼠标指针。 `TRUE`: 当鼠标点击事件存在并且鼠标指针移动到元素区域时。 `FALSE`: 鼠标点击事件不存在。或者用户在按下鼠标按钮时将鼠标指针移到元素区域之外。值为 `TRUE` 一旦用户将指针移回元素区域，就会再次出现。然后捕获鼠标。

切换

随着鼠标点击事件的发生，变量被设置；当鼠标点击事件完成时，变量被重置。

多变的

多变的（BOOL) 用于在鼠标单击事件结束时进行切换

这是当鼠标指针位于元素区域上时用户释放鼠标按钮。如果用户在鼠标指针位于元素区域之外时释放鼠标按钮，则鼠标单击事件不会结束，值不会切换。

提示

用户可以通过将鼠标指针拖出元素区域来取消已启动的切换输入。

如果捕获则打开

standard icon ：无论释放鼠标按钮时鼠标指针在哪里，该值都会切换。然后捕获鼠标。

热键	用于触发特定输入操作的元素上的快捷方式当热键事件发生时，在活动属性被触发。这样，导致这个输入动作的不是输入动作本身，而是鼠标输入动作。
钥匙	按键输入动作。例子：吨选择键时会出现以下属性。
活动	没有鼠标向下: 按键触发输入动作鼠标按下财产。鼠标向上：松开按键会触发在 OnMouseUp 财产。鼠标向下/向上：按下和释放键触发在配置的输入动作鼠标按下财产和 OnMouseUp 财产。
切换	：与“Shift”键组合例子：转移+吨.
控制	: 与“Ctrl”键组合例子： Ctrl+吨.
Alt	：与“Alt”键组合例子： Alt+吨.

提示

可视化中配置的所有键盘快捷键及其操作都列在键盘配置标签。

访问权

注意

仅当为可视化设置用户管理时可用。

访问权按钮

打开访问权对话。您可以在此处编辑元素的访问权限。

. 状态消息：

没有设置。完全权利。：所有用户组的访问权限：可操作
权利已设定：有限权利: 至少有一组限制访问。

本节内容如下:

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.iScaling` 参考点是中心财产。价值 `1` 将元素缩小一个因子 `0.001`.价值 `1000` 将元素返回到其原始大小。
内部旋转	旋转角度的变量（数字数据类型）（以度为单位）例子： `PLC_PRG.iAngle2`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。注意如果在位置→角度属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。