Skip to main content

可视化元素：图像

象征：

_visu_img_picture.png

类别： 基本的

该元素将图像添加到可视化。显示的图像在图像池中进行管理，并通过静态 ID 在可视化元素中引用。您还可以使用变量而不是静态 ID 来动态更改显示的图像。

提示

随着 背景 命令，您可以为整个可视化定义背景。

提示

可以在项目设置中定义包含用于可视化的图像的目录（类别 可视化）。

元素属性

所有元素属性都可用吗？

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

元素名称

示例： Status bar

提示

为元素指定单独的名称，以便更快地在元素列表中找到它们。

元素的类型

图片

静态 ID

来自图像池的图像的静态 ID。图像池可以是项目的一部分，也可以来自库。如果您指定了完整的实例路径，则可以完全解析该 ID。

项目中带有图像池的图像的实例路径：

<namespace library>.<name of image pool>.<ID image>

示例：

MyLib.Imagepool.background

VisuSymbols.Symbols.Phone: 中包含图像池的图像的实例路径 VisuSymbols 图书馆

库的命名空间 (namespace library) 是可选的。如果缺失，则将在项目中搜索图像池。

图片集前面的圆点 (.) 是可选的。当指定圆点时，它表示项目中的实例路径。

.Imagepool.background

如果使用此方法找不到图像，则使用图像 ID 进行替代搜索。结果是第一个匹配的图片 ID。如果 ID 不明确，这可能会导致显示错误的图像。可以通过指定确切的实例路径来防止这种情况。

提示

指定完整实例路径以避免冲突：

<namespace path> . <name of image pool> . <image ID>

有关更多信息，请参阅： 对象：图像池

显示框架

standard icon：图像文件以边框显示。

剪报

要求： 缩放类型 属性是 已修复。

standard icon：仅显示适合元素框架的可视化部分。

透明

standard icon: 具有 透明的颜色 显示为透明。

透明的颜色

仅在以下情况下有效 透明 选项已激活。

这个 _cds_icon_button_threedots.png 按钮打开颜色选择对话框。您可以在此处选择透明颜色。

缩放类型

. 定义图像如何适应元素框架。

  • 各向同性的：整个图像显示在元素框架中，可以放大或缩小。因此，高度和宽度的比例得以保留。

    如果还应在缩放的框架元素内保持元素之间的对齐方式，则请注意以下几点。通过设置属性可以防止不必要的水平或垂直偏移量 水平对齐 和 垂直对齐 到 居中。元素的对齐保持不变，不会产生水平或垂直偏移

    示例：一盏灯位于开关上方的中央。即使调整了框架的大小，灯泡也应保持在水平居中位置

  • 各向异性：图像自动调整为元素框架的大小，填充整个元素框架。因此，比例没有保留。

  • 已修复：即使调整了元素边框的大小，图像也会保持其原始大小。还要注意的是 剪报 选项已选中。

    每次重新分配图像 ID 时，元素大小会自动适应图像大小。

水平对齐

. 元素在元素框架内的水平对齐：

  • 左

  • 居中

  • 对

要求：图像的缩放类型为 各向同性的 或者 已修复。

注意

如果引用了可视化效果，则水平对齐将在帧位置内生效。

_visu_icon_variable.png: 那个 变量 属性如下所示。

变量

枚举变量 (ENUM VisuElemBase.VisuEnumVerticalAlignment) 用于水平对齐

示例： PLC_PRG.eHorizontalAlignment

垂直对齐

. 元素在元素框架内的垂直对齐方式：

  • 顶部

  • 居中

  • 底部

要求：图像的缩放类型为 各向同性的 或者 已修复。

注意

如果引用了可视化效果，则水平对齐将在帧位置内生效。

_visu_icon_variable.png: 那个 变量 属性如下所示。

变量

枚举变量 (ENUM VisuElemBase.VisuEnumVerticalAlignment) 用于垂直对齐

示例： PLC_PRG.eVerticalAlignment

上表中用作示例的变量需要有效的声明。

枚举

TYPE VisuElemBase.VisuEnumHorizontalAlignment
    LEFT
    HCENTER
    RIGHT
END_TYPE

TYPE VisuElemBase.VisuEnumVerticalAlignment
    DOWN
    VCENTER
    BOTTOM
END_TYPE

声明

PROGRAM PLC_PRG
VAR
    eHorizontalAlignment : VisuElemBase.VisuEnumHorizontalAlignment := VisuElemBase.VisuEnumHorizontalAlignment.HCENTER;
    eVerticalAlignment : VisuElemBase.VisuEnumVerticalAlignment := VisuElemBase.VisuEnumVerticalAlignment.VCENTER;
END_VAR

有关更多信息，请参阅： 对象：图像池

位置

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

X

元素左上角的 X 坐标（以像素为单位）

例子： 10

Y

元素左上角的 Y 坐标（以像素为单位）

例子： 10

宽度

宽度（以像素为单位）

例子： 150

高度

高度（以像素为单位）

例子： 30

提示

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

角度

静态旋转角度（以度为单位）

例子： 35

该元素在编辑器中旋转显示。旋转点是元素的中心。正值顺时针旋转。

提示

您可以通过将元素聚焦到句柄来更改编辑器中的值。当光标显示为 _visu_icon_rotate_statically.png 旋转箭头，您可以将元素作为手柄绕其中心旋转。

_visu_img_selected_image_with_handle.png

(1)：手柄

注意

如果还配置了动态旋转角度 绝对运动→内旋转 属性，然后在运行时添加静态和动态旋转角度。静态旋转角度充当偏移量。

中心

属性包含旋转点坐标的固定值。旋转点在编辑器中显示为 _visu_icon_center_point.png 符号并用作旋转和缩放的中心。

提示

您也可以通过拖动 _visu_icon_center_point.png 符号到编辑器中的另一个位置。

X

旋转点的 X 坐标

Y

旋转点的 Y 坐标

颜色

属性包含用于设置颜色的固定值。

颜色

要求： 显示框架 属性被选中。

框架的颜色

注意

正常状态是有效的，如果在 颜色变量→切换颜色 属性未定义或具有值 FALSE.

要求： 显示框架 属性被选中。

处于报警状态的框架颜色

注意

如果 颜色变量→切换颜色 财产具有价值 TRUE.

透明度

用于定义所选颜色透明度的值（0 到 255）

例子：

255：颜色不透明。

0：颜色完全透明。

注意

如果颜色是样式颜色并且已经具有透明度值，则此属性受写保护。

外貌

属性包含用于设置元素外观的固定值。

行宽

值（以像素为单位）

例子： 2

注意

价值 0 和 1 两者都导致一个像素的线宽。如果不应显示任何行，则 线条样式 属性必须设置为 无形的 选项。

线条样式

线表示的类型

  • 坚硬的

  • 短跑

  • 点

  • 破折号

  • 点划线点

  • 无形的

提示

您可以在中分配变量 外观变量 用于动态控制外观的属性。固定值在此处定义。

文本

文本

字符串（不带单引号）

例子： Accesses: %i

该元素使用此文本进行标记。如果占位符 %<format string> 在文本中指定，然后在 文本变量 → 文本 属性在占位符的位置输出。

工具提示

字符串（不带单引号）

例子： Number of valid accesses %n

文本作为工具提示输出。如果占位符 %<format string> 在文本中指定，然后在 文本变量 → 工具提示 属性在占位符的位置输出。

提示

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

提示

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

图像 ID 变量

图像 ID

多变的 （STRING) 用于图像 ID

例子： PLC_PRG.stImageID

申请代码： PLC_PRG.stImageID := 'ImagePool_A.Bild3';

变量值形式上是指图像池中的特定图像，对应于图像池中的值。 静态 ID 财产。

文本属性

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

水平对齐

元素内文本的水平对齐

垂直对齐

元素内文本的垂直对齐方式

文本格式

. 显示过长文本的定义

  • 默认: 太长的文本被截断。

  • 越线：文本被分成几行。

  • 省略：可见文本以“...”结尾，表示不完整。

字体

例子： 默认

_cds_icon_three_dots.png： 这 字体 对话框打开。

_cds_icon_arrow_down.png: 带有样式字体的列表框

字体颜色

例子： 黑色的

_cds_icon_three_dots.png： 这 颜色 对话框打开。

_cds_icon_arrow_down.png：带有样式颜色的列表框

透明度

整数（值范围从 0 到 255)

透明值决定相应颜色的透明度。

255：颜色不透明。

0：颜色完全透明。

注意

如果颜色是样式颜色并且已经具有透明度值，则此属性受写保护。

动态图像

您可以使用此元素属性为一系列图像文件设置动画。

位图版本

包含图像版本的变量（整数数据类型）

如果变量发生变化，则可视化重新读取在 图像 ID 属性并显示它。

当控制器上的图像文件不断更新时，可视化会显示动画，从而增加版本变量。应用程序必须为此进行编程。

. 可能的应用

  • 显示应用程序生成的图形

  • 显示由相机刷新的图像

绝对运动

这些属性包含用于动态控制元素位置的 IEC 变量。参考点是元素的左上角。在运行时，整个元素被移动。

移动

X

  • X 位置的变量（数字数据类型）（以像素为单位）

    例子： PLC_PRG.iPos_X.

  • 容器变量： Container.Width

    有关详细信息，请参阅： 优化调整位置和大小

在运行时增加此值会使元素向右移动。

Y

  • Y 位置的变量（数字数据类型）（以像素为单位）

    例子： PLC_PRG.iPos_Y.

  • 容器变量： Container.Height

    有关详细信息，请参阅： 优化调整位置和大小

在运行时增加此值会使元素向下移动。

回转

旋转角度的变量（数字数据类型）（以度为单位）

例子： PLC_PRG.iAngle1.

元素的中点在 中心 观点。该旋转点显示为 _visu_icon_center_point.png 象征。

在运行时，元素的对齐相对于可视化的坐标系保持不变。增加该值会使元素向右旋转。

_visu_img_prp_rotation.png

缩放

用于触发中心拉伸的变量（整数数据类型）

例子： PLC_PRG.iScaling

参考点是 中心 财产。

价值 1 将元素缩小一个因子 0.001.价值 1000 将元素返回到其原始大小。

内部旋转

旋转角度的变量（数字数据类型）（以度为单位）

例子： PLC_PRG.iAngle2.

在运行时，元素围绕指定的旋转点旋转 中心 根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。

旋转点如图所示 _visu_icon_center_point.png 象征。

注意

如果在 位置→角度 属性，然后在执行可视化时将静态旋转角度添加到可变旋转角度（偏移量）中。

_visu_img_prp_inner_rotation.png

提示

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

提示

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

相对运动

属性包含用于移动元素的变量。参考点是元素的位置（位置 财产）。元素的形状可以改变。

左上运动

X

  • 变量（整数数据类型）的数字（以像素为单位） 剩下 边缘水平移动

    例子： PLC_PRG.iDeltaX

增加值会将元素向右移动。

Y

  • 变量（整数数据类型）为数字（以像素为单位） 最佳 边缘垂直移动

    例子： PLC_PRG.iDeltaY

增加值会使元素向下移动。

右下运动

X

  • 变量（整数数据类型）的数字（以像素为单位） 正确的 边缘水平移动。

    例子： PLC_PRG.iDeltaWidth

  • 容器变量： Container.Width

    有关详细信息，请参阅： 优化调整位置和大小

增加值会将元素向右移动。

Y

  • 变量（整数数据类型）为数字（以像素为单位） 底部 边缘垂直移动

    例子： PLC_PRG.iDeltaHeight

  • 容器变量： Container.Height

    有关详细信息，请参阅： 优化调整位置和大小

增加值会使元素向下移动。

文本变量

文本变量

变量（数据类型符合 格式化规范) 中的占位符 属性：文本 → 文本

例子： PLC_PRG.iAccesses

变量值替换元素文本中的占位符。在运行时，元素用文本标记，变量值不断更新。

注意

如果您指定一个支持文本列表的枚举类型变量，则枚举数据类型的名称会自动添加到变量名称后的尖括号中。例子： PLC_PRG.enVar <enumeration name>.然后在打印文本时打印枚举组件的符号值而不是数值。有关枚举，请参阅帮助页面。

工具提示变量

变量（数据类型符合 格式化规范) 中的占位符 文本 → 工具提示 财产

例子： PLC_PRG.iAccessesInTooltip

变量值替换元素工具提示中的占位符。在运行时，会显示工具提示并不断更新变量值。

动态文本

动态文本是文本列表的可变索引文本。在运行时，显示当前在变量中索引的文本。

文本列表

. 文本列表的名称

  • 作为变量（字符串）

  • 作为带有单直引号的固定字符串文字

    例子： 'Errorlist'

_cds_icon_arrow_down.png: 带有文本列表中可用对话框的列表框

注意：如果将项目中的文本列表传输到库中的可视化，则必须在文本列表的名称前面添加一个点。

文本索引

. 引用所需输出文本的文本列表 ID

  • 作为带有单直引号的 ID 的固定字符串

    例子： '1'

  • 作为变量 (STRING) 用于动态控制文本输出

    例子： strTextID

    样本分配： PLC_PRG.strTextID := '1';

工具提示索引

. 引用所需输出文本的文本列表 ID

  • 作为带有单直引号的 ID 的固定字符串

    例子： '2'

  • 作为变量 (STRING) 用于动态控制文本输出

    例子： strToolTipID

    样本分配： PLC_PRG.strToolTipID := '2';

颜色变量

Element 属性用作项目变量的接口，以在运行时动态控制颜色。

切换颜色

该属性控制运行时切换的颜色。

. 赋值：

  • FALSE: 元素以指定的颜色显示 颜色 财产。

  • TRUE: 元素以指定的颜色显示 报警颜色 财产。

. 分配属性：

  • 用户输入变量的占位符

    • <切换/点击变量>

    • <不切换/点击变量>

    颜色的变化不是由它自己的变量控制的，而是由一个用户输入的变量控制的。

    注意

    为鼠标事件指定一个变量 轻敲 要么 切换 在元素的输入配置中。只有这样才能设置占位符。如果您在两者中都配置了一个变量 切换 和 轻敲, 然后是指定的变量 轻敲 用来。

    提示

    点击 _visu_icon_linked_variable.png 插入符号 <切换/点击变量> 占位符。当您激活 输入配置, 点击错误 财产，那么 <不切换/点击变量> 显示占位符。

  • 项目变量的实例路径 (BOOL)

    例子： PLC_PRG.xColorIsToggeled

    注意

    在代码中，声明并实现此处指定的变量。它的赋值决定了颜色何时改变。

颜色

框架的颜色变量

  • 多变的 （DWORD) 颜色

    例子： PLC_PRG.dwColor

  • 颜色字面量

    灰色和不透明的示例： 16#FF888888

要求： 显示框架 属性被激活。

注意

如果表达式中的正常状态有效 颜色变量 → 切换颜色 属性未定义或具有值 FALSE。

报警颜色

处于警报状态的框架的颜色变量

  • 多变的 （DWORD) 用于报警颜色

    例子： PLC_PRG.dwAlarmColor

  • 颜色字面量

    红色和不透明的示例： 16#FFFF0000

注意

如果表达式中的正常状态有效 颜色变量 → 切换颜色 属性未定义或具有值 TRUE。

提示

仅在以下情况下评估颜色值的透明度部分 激活半透明绘图 的选项 可视化管理器 被选中。

提示

在工具栏中 特性, 选择 先进的 选项。然后所有元素属性都是可见的。

看变量

属性包含用于动态控制元素外观的变量。

行宽

线宽（以像素为单位）的变量（整数数据类型）

注意

值 0 和 1 都产生一个像素的线宽。如果不应显示任何行，则 线条样式 属性必须设置为 无形的 选项。

线条样式

线型的变量 (DWORD)

. 编码：

  • 0： 实线

  • 1: 虚线

  • 2: 虚线

  • 3：线型“点划线”

  • 3：线型“Dash Dot Dot”

  • 8：不可见：不画线。

提示

固定值可以在 外貌 财产。这些值可以在运行时被动态变量覆盖。

字体变量

这些变量允许对文本显示进行动态控制。

字体名称

多变的 （STRING) 用于文本的字体

例子： PLC_PRG.stFontVar := 'Arial';

提示

您可以找出标准中可用的字体 字体 对话。

尺寸

字体大小（以像素或点为单位）的变量（数字数据类型）

应用的单位在变量名后面的括号中指定。

  • <pt>：点（默认）

    例子： PLC_PRG.iFontHeight <pt>

    代码： iFontHeight : INT := 12;

  • <px>：像素

    例子： PLC_PRG.iFontHeight <px>

    代码： iFontHeight : INT := 19;

提示

字体大小以磅为单位指定（例如：Arial 12）。当可变字体大小应与字体匹配时使用点，例如，如果在 文本属性 → 字体 财产。

提示

如果单击值字段，则 _cds_img_dropdownlist_unit_font_size.png 右侧打开列表框以设置单位。

标志

多变的 （DWORD) 用于确定字体显示的标志

. 标志：

  • 1: 斜体

  • 2： 大胆的

  • 4: 下划线

  • 8: 删除线

注意

您可以通过添加标志的编码来组合字体显示。例如，粗体和带下划线的文本： PLC_PRG.dwFontType := 6;

字符集

多变的 （DWORD) 为字体的字符集编号

字符集编号的选择对应于 脚本 标准的制定 字体 对话。

颜色

多变的 （DWORD) 用于文本的颜色

例子： PLC_PRG.dwColorFont:= 16#FF000000;

文本对齐的标志

用于编码文本对齐的变量（整数数据类型）

例子： PLC_PRG.dwTextAlignment

. 编码：

  • 0： 左上方

  • 1: 水平中心

  • 2： 正确的

  • 4: 垂直中心

  • 8： 底部

注意

您可以通过添加标志的编码来组合文本对齐方式。例如，垂直和水平居中的文本： PLC_PRG.dwFontType := 5;

提示

显示文本的固定值设置在 文本属性。

状态变量

变量动态控制元素行为。

无形的

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

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

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

停用输入

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

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

提示

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

输入配置

属性包含使用鼠标或键盘时用户输入的配置。用户输入是从元素的角度来看的用户事件。

这 配置 按钮打开 输入配置 用于创建或修改用户输入配置。

配置包含针对相应输入事件的一个或多个输入操作。现有输入操作显示在其下方。

例子： 执行 ST 代码： _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

输入事件：用户关闭对话框。

OnMouseClick

输入事件：用户完全点击元素。单击并释放鼠标按钮。

OnMouseDown

输入事件：用户仅单击元素。

OnMouseEnter

输入事件：用户将鼠标指针拖到元素上。

OnMouseLeave

输入事件：用户将鼠标指针拖离元素。

OnMouseMove

输入事件：用户将鼠标指针移到元素区域上。

OnMouseUp

输入事件：用户在元素区域内释放鼠标按钮。

OnValueChanged

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

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

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

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

热键

用于触发特定输入操作的元素上的快捷方式

当热键事件发生时， 活动 属性被触发。

钥匙

按键输入动作

例子： 吨

活动

  • 没有

  • 鼠标向下: 按键触发输入动作 鼠标按下 财产。

  • 鼠标向上：松开按键会触发在 OnMouseUp 财产。

  • 鼠标向下/向上：按下和释放键触发在配置的输入动作 鼠标按下 财产和 OnMouseUp 财产。

切换

standard icon：与“Shift”键组合

例子： 转移+吨.

控制

standard icon: 与“Ctrl”键组合

例子： Ctrl+吨.

Alt

standard icon：与“Alt”键组合

例子： Alt+吨.

提示

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

动画

提示

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

动画时长

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

  • 变量（整数值）

    例子： Menu.tContent 和 VAR tContent : INT := 500; END_VAR

  • 整数字面量

    例子： 500

. 动画属性

  • 绝对运动, 移动, X, 是

  • 绝对运动, 回转

  • 绝对运动, 内部旋转

  • 绝对运动, 外旋

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

移至前台

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

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

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

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

访问权

注意

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

访问权 按钮

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

. 状态消息：

  • 没有设置。完全权利。：所有用户组的访问权限： 可操作

  • 权利已设定：有限权利: 至少有一组限制访问。

本节内容如下: