可视化元素：饼图

象征：

类别：基本的

该元素绘制任意角度的饼图。

元素属性

所有元素属性都可用吗？

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

元素名称	例子： `Error_rate_part_1` 提示为元素指定单独的名称，以便更快地在元素列表中找到它们。
元素类型	馅饼

位置

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

X	元素左上角的 X 坐标（以像素为单位）例子： `10`
Y	元素左上角的 Y 坐标（以像素为单位）例子： `10`
宽度	宽度（以像素为单位）例子： `150`
高度	高度（以像素为单位）例子： `30`
	提示您还可以通过拖动框来更改值符号到编辑器中的其他位置。
角度	静态旋转角度（以度为单位）例子： `35` 该元素在编辑器中旋转显示。旋转点是元素的中心。正值顺时针旋转。提示提示：您可以通过将元素聚焦到句柄来更改编辑器中的值。当光标显示为旋转箭头，您可以将元素作为手柄绕其中心旋转。 (1)：手柄注意如果还配置了动态旋转角度绝对运动→内旋转属性，然后在运行时添加静态和动态旋转角度。静态旋转角度充当偏移量。

`Variable`

开始	饼图的起始角度如果您还为起点定义了一个变量，则起点角度是根据以下值的总和计算得出的开始和开始变量.	. 例子：开始: 330 结尾: 90
结尾	饼图的结束角度如果您还为结束定义了一个变量，则结束角度是根据以下值的总和计算得出的结尾和结束变量. 饼图从起始角度顺时针绘制到结束角度。
开始变量	扇区的开始由变量动态定义。
结束变量	扇区的末端由变量动态定义。
只显示圆线	：绘制的饼图没有半径线或填充颜色。

中心

显示中心坐标。

注意

您不能在此处的属性中修改这些值。

如果在编辑器中选择了饼图，则饼图的中心（以及信封框的中心）将显示为象征。此外，该元素装饰有可以移动的位置、开始和结束框。

：移动时中心坐标发生变化编辑器中的中心符号。这也改变了饼图的大小，使得位置框保持其位置，并且中心保持在元素的中间。

颜色

正常状态	正常状态是有效的，如果变量在颜色变量→切换颜色未定义或具有值 `FALSE`.
框架颜色	变量对应状态的边框和填充颜色
填充颜色
透明度	用于定义所选颜色透明度的值（0 到 255） 255：颜色不透明。 0：颜色完全透明注意如果颜色是样式颜色并且已经具有透明度值，则此属性受写保护。
报警状态	如果变量在颜色变量→切换颜色有价值 `TRUE`.
使用渐变色	：元素以两种颜色的渐变显示。
渐变设置	这渐变编辑器对话框打开。

外貌

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

行宽

值（以像素为单位）

例子： 2

注意

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

填充属性

元素是如何填充的

填充：元素填充了来自的颜色颜色 → 填充颜色财产。
无形的: 填充颜色不可见。

线条样式

线表示的类型

坚硬的
短跑
点
破折号
点划线点
无形的

提示

您可以在外观变量用于动态控制外观的属性。此处的固定值被覆盖。

文本

字符串（不带单引号）

例子： Accesses: %i

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

工具提示

字符串（不带单引号）

例子： Number of valid accesses %n

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

提示

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

提示

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

文本属性

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

水平对齐	元素内文本的水平对齐
垂直对齐	元素内文本的垂直对齐方式
文字格式	. 显示过长文本的定义默认: 太长的文本被截断。换行：文本分成几行。省略号: 可见文字以 “...” 结尾“表明它不完整。
字体	示例：默认 : 那个字体对话框打开。 : 带有样式字体的列表框
字体颜色	正常状态下的字体颜色示例：黑色 : 那个颜色对话框打开。 : 带有样式颜色的列表框
字体警报颜色	警报状态下处于活动状态的字体颜色重要它必须与正常状态下的字体颜色不同。示例：红色
透明度	整数（值范围为 `0` 到 `255`) 透明值决定相应颜色的透明度。 `255`: 颜色不透明。 `0`:颜色完全透明。注意如果颜色是样式颜色并且已经具有透明度值，则此属性受写保护。

绝对运动

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

移动
X	X 位置的变量（整数数据类型）（以像素为单位）例子： `PLC_PRG.iPos_X`. 容器变量： `Container.Width` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向右移动。
Y	Y 位置的变量（整数数据类型）（以像素为单位）例子： `PLC_PRG.iPos_Y`. 容器变量： `Container.Height` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向下移动。
缩放	用于触发中心拉伸的变量（整数数据类型）例子： `PLC_PRG.iScaling` 参考点是中心财产。价值 `1` 将元素缩小一个因子 `0.001`.价值 `1000` 将元素返回到其原始大小。
内部旋转	旋转角度的变量（整数数据类型）（以度为单位）例子： `PLC_PRG.iAngle2`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。如果在中指定了静态旋转角度位置→角度，然后添加静态旋转角度和旋转角度。

提示

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

提示

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

文本变量

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

例子： PLC_PRG.iAccesses

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

注意

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

工具提示变量

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

例子： PLC_PRG.iAccessesInTooltip

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

动态文本

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

文本列表

. 文本列表的名称

作为变量（字符串）
作为带有单直引号的固定字符串文字
例子： 'Errorlist'

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

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

文本索引

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

作为带有单直引号的 ID 的固定字符串
例子： '1'
作为变量 (STRING) 用于动态控制文本输出
例子： strTextID
样本分配： PLC_PRG.strTextID := '1';

工具提示索引

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

作为带有单直引号的 ID 的固定字符串
例子： '2'
作为变量 (STRING) 用于动态控制文本输出
例子： strToolTipID
样本分配： PLC_PRG.strToolTipID := '2';

字体变量

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

字体名称	变量 (`STRING`) 用于文本的字体示例： `PLC_PRG.stFontVar := 'Arial';` 提示你可以找出标准中有哪些字体可用字体对话框。
大小	字体大小的变量（数字数据类型）（以像素或点为单位）应用单位在变量名称后的方括号中指定。 <pt>: Points (default) Example: `PLC_PRG.iFontHeight <pt>` 代码： `iFontHeight : INT := 12;` <px>: Pixels Example: `PLC_PRG.iFontHeight <px>` 代码： `iFontHeight : INT := 19;` 提示字体大小以点为单位指定（例如：Arial 12）。当可变字体大小应与字体匹配时使用分数，例如，如果在中设置了字文本属性 → 字体财产。提示如果您在值字段中单击，列表框在右侧打开，用于设置单位。
旗帜	变量 (`DWORD`) 让标志决定字体显示 . 标志： `1`: 斜体 `2`: 粗体 `4`: 下划线 `8`: 删除线注意您可以通过添加标志的编码来组合字体显示屏。例如，粗体和带下划线的文本： `PLC_PRG.dwFontType := 6;`
字符集	变量 (`DWORD`) 表示字体的字符集编号字符集数字的选择对应于脚本标准的设定字体对话框。
颜色	变量 (`DWORD`) 表示文本的颜色示例： `PLC_PRG.dwColorFont:= 16#FF000000;`
警报颜色	变量 (`DWORD`) 用于警报期间的文字颜色重要此颜色会覆盖静态字体警报颜色（在属性中：文本属性 → 字体警报颜色) 它必须与正常状态下的字体颜色不同。
文本对齐标志	用于编码文本对齐方式的变量（整数数据类型）示例： `PLC_PRG.dwTextAlignment` . 编码： `0`: 左上角 `1`: 水平中心 `2`: 对 `4`: 垂直中心 `8`: 底部注意您可以通过添加标志编码来组合文本对齐方式。例如，垂直和水平居中的文本： `PLC_PRG.dwFontType := 5;`

提示

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

颜色变量

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

切换颜色	颜色切换的变量 . 赋值： `FALSE`: 元素以指定的颜色显示颜色财产。 `TRUE`：元素以指定的颜色显示报警颜色财产。 . 分配选项：用户输入变量的占位符 <切换/点击变量> <不切换/点击变量> 颜色的变化不是由它自己的变量控制的，而是由一个用户输入的变量控制的。注意为鼠标事件指定一个变量轻敲要么切换在元素的输入配置中。只有这样才能设置占位符。如果您在两者中都配置了一个变量切换和轻敲, 然后是指定的变量轻敲用来。提示点击插入符号 <切换/点击变量> 占位符。当您激活输入配置, 点击错误财产，那么 <不切换/点击变量> 显示占位符。项目变量的实例路径 (`BOOL`) 例子： `PLC_PRG.xColorIsToggeled` 注意在代码中，声明并实现此处指定的变量。它的赋值决定了颜色何时改变。
正常状态报警状态	下面列出的属性根据状态控制颜色。正常状态是有效的，如果变量在颜色变量, 切换颜色未定义或具有值 `FALSE`.如果变量在颜色变量, 切换颜色有价值 `TRUE`.
框架颜色	. 分配选项：多变的（`DWORD`) 为框架颜色例子： `PLC_PRG.dwBorderColor` 颜色字面量绿色和不透明的示例： `16#FF00FF00`
填充颜色	. 分配选项：多变的（`DWORD`) 用于填充颜色例子： `PLC_PRG.dwFillColor` 颜色字面量灰色和不透明的示例： `16#FF888888`

提示

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

闪烁

中的值眨眼间隔指定元素在正常状态和警报状态之间切换其颜色的时间间隔（以毫秒 (ms) 为单位）。

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

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

眨眼间隔

正常颜色和警报颜色的闪烁间隔（以毫秒 (ms) 为单位），如下面定义的颜色元素属性

为 0（默认设置）时，元素不闪烁。该元素仅以正常颜色显示。

变量（类型 UDINT）用于程序控制的颜色变化
例子： PLC_PRG.udiBlinking
文字（类型 UDINT）这会导致颜色在固定时间间隔后发生变化。
例子： 1000 持续 1 秒

看变量

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

行宽	线宽（以像素为单位）的变量（整数数据类型）
填充属性	多变的（`DWORD`) 用于切换元素的可见性变量值 `= 0`：填充变量值 `> 0`：无形的;没有填充颜色
线条样式	多变的（`DWORD`) 用于切换线型 . 编码： `0`：实线 `1`: 虚线 `2`: 虚线 `3`：线型“点划线” `3`：线型“Dash Dot Dot” `8`：无形的;没有线

提示

您可以在中设置固定值外貌财产。但是，这些值会在运行时被动态变量覆盖。

状态变量

变量动态控制元素行为。

无形的

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

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

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

停用输入

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

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

提示

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

动画

提示

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

动画时长

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

变量（整数值）
例子： 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 被触发。
OnValueChanged	由于值更改而触发后续操作的事件。在对话框中指定触发哪些后续动作输入配置配置。定义的后续操作和相关配置显示在元素属性下方。事件 OnValueChanged 可以由编译器定义 VISU_NO_VALUECHANGED 在应用程序的属性对话框中停用。

轻敲	当鼠标点击事件发生时，定义在多变的在应用程序中进行了描述。编码取决于点击错误和如果捕获，请点击输入选项。
多变的	要求：点击错误选项未激活。多变的（`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`
	提示您还可以通过拖动框来更改值符号到编辑器中的其他位置。
角度	静态旋转角度（以度为单位）例子： `35` 该元素在编辑器中旋转显示。旋转点是元素的中心。正值顺时针旋转。提示提示：您可以通过将元素聚焦到句柄来更改编辑器中的值。当光标显示为旋转箭头，您可以将元素作为手柄绕其中心旋转。 (1)：手柄注意如果还配置了动态旋转角度绝对运动→内旋转属性，然后在运行时添加静态和动态旋转角度。静态旋转角度充当偏移量。

移动
X	X 位置的变量（整数数据类型）（以像素为单位）例子： `PLC_PRG.iPos_X`. 容器变量： `Container.Width` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向右移动。
Y	Y 位置的变量（整数数据类型）（以像素为单位）例子： `PLC_PRG.iPos_Y`. 容器变量： `Container.Height` 有关详细信息，请参阅：优化调整位置和大小在运行时增加此值会使元素向下移动。
缩放	用于触发中心拉伸的变量（整数数据类型）例子： `PLC_PRG.iScaling` 参考点是中心财产。价值 `1` 将元素缩小一个因子 `0.001`.价值 `1000` 将元素返回到其原始大小。
内部旋转	旋转角度的变量（整数数据类型）（以度为单位）例子： `PLC_PRG.iAngle2`. 在运行时，元素围绕指定的旋转点旋转中心根据变量的值。此外，元素的对齐方式会根据可视化的坐标系进行旋转。增加代码中的值会顺时针旋转。旋转点如图所示象征。如果在中指定了静态旋转角度位置→角度，然后添加静态旋转角度和旋转角度。