对话框：XY 图表配置

象征：

功能：对话框包含配置笛卡尔 XY 图它显示数组中的数据。

称呼：在里面笛卡尔 XY 图属性，点击 XY 图表.

要求：在活动的可视化编辑器中选择了一个 XY 图表，相应的特性视图已打开。

对话框左侧的树视图显示 XY 图表的配置并充当导航器。如果您选择了顶级条目 (1) 或根本没有选择，那么元素设置组在右侧可见。这包括图表刷新频率的配置。此外，还提供影响图表外观和功能的设置。

如果您在下方选择了一个条目曲线节点（2），然后曲线设置组在右侧可见。此配置包括分配给选定曲线的 Y 坐标轴和曲线显示的数组数据。此外，还提供影响所选曲线的外观和功能的设置。该条目显示曲线的名称，括号中为指定的坐标轴。例如， Curve1 [AxisY1] 表示纵坐标轴 AxisY1 分配给曲线 Curve1.

如果您在下方选择了一个条目轴节点（3），然后轴设置组在右侧可见。此配置包括图表中 Y 坐标轴的位置。此外，还提供影响所选坐标轴外观和功能的设置。该条目在括号中显示轴的名称及其功能。轴可以充当 X 轴或 Y 轴。例如， AxisX(X) 意味着轴 AxisX 作为水平横坐标轴 X.

添加	向视图添加新条目结果：新曲线或轴旁边显示一个空配置。您在那里编辑设置。
删除	删除选定的条目
提升	将所选条目上移一位
下移	将所选条目下移一位

好的	保存设置，关闭对话框，根据设置显示元素

组：元素设置

表 132. 更新

类型

自动的：如果影响图表渲染的数组数据或数组元素发生变化，则图表会自动刷新。
提示：设置自动更新启用可在扩展变量以编程方式控制自动更新。
多变的：如果变量值发生变化，则刷新图表。

多变的

变量（整数数据类型）

如果类型可用多变的被选中。

参见示例：变量

例 50. 示例：变量

宣言

PROGRAM Sine
VAR_INPUT
   uiUpdate : UINT;
END_VAR

任务

Sine.uiUpdate

表 133. 背景

类型	无背景素色：在输入字段中配置的颜色背景颜色和透明度. 坡度: 带渐变的背景。打开渐变编辑器。图片：带图像的背景；在输入字段中配置图像 ID. 从风格：样式中定义的背景。
颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。可用时素色类型被选中
透明度	用于定义所选颜色透明度的值（0 到 255）例子 `255`：颜色不透明。 `0`：颜色完全透明。可用时图片类型被选中。
图像 ID	`<image pool name> . <ID>` 例子： `Images.Logo` 可用时图片类型被选中。
透明色	：以透明色显示的背景。列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。可用时图片类型被选中。
缩放类型	各向同性：整个图像显示在元素框架中，或大或小。结果，保留了高度和宽度的比例。各向异性：图像自动调整到元素框架的尺寸，填充整个元素框架。结果，不保留比例。固定的：即使元素框架调整大小，图像仍保持其原始大小。另请注意，选择了裁剪选项。可用时图片类型被选中。

表 134. 主光标

类型	未使用垂直的大十字架小十字架十字路口
线条样式	例子：点不可用时类型被选中。
颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。
X 位置变量	写入光标 X 位置的变量（整数数据类型）。例子： `PLC_PRG.iPosition` 不可用时类型被选中。

表 135. 扩展变量

元素变量

具有数据类型的变量 VisuStructXYChart 来自 VisuElemXYChart 图书馆

此处配置的变量使用静态配置进行初始化。在运行时，笛卡尔 XY 图元素响应此结构的变化。因此，可以在运行时以编程方式控制元素。

注意：当以编程方式控制此结构时，分配顺序可能会出现问题。因此，应用程序应仅在初始化可视化元素和结构变量时分配其初始值 iInitialized 已切换到 1。

这 iInitialized 变量仅适用于 CODESYS 版本 SP16。对于旧版本，订单问题不能很好地解决。

参见示例：元素变量

自动更新启用

变量（数据类型 BOOL) 以编程方式控制图表的自动刷新。

TRUE：图表的显示在更改后自动刷新。

例子： PLC_PRG.bIsUpdating

注：可用时类型自动的被选中更新.

例 51. 示例：元素变量

宣言

PROGRAM PLC_PRG
VAR
   XYChart : VisuStructXYChart;
END_VAR

任务

IF XYChart.iInitialized > 0 THEN
   XYChart.eBackgroundType := VisuEnumXYChartBGType.PLAIN;     // plain color
   XYChart.diColorBg := 16#00000080;                           // blue
   XYChart.eGrid := VisuEnumXYChartGridType.NO;                // no grid
END_IF

表 136. 辅助光标

附加游标的游标类型对应于主游标。
线条样式	例子：点
颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。

表 137. 网格

类型	网格显示为未使用大网格窄网格大标记上的虚线网格小标记上的虚线网格
线条样式	例子：点如果类型不可用要么被选中。
颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。
曲线后面的网格	：网格显示在曲线后面的图层中。例如，如果曲线显示为面积图，则网格在填充颜色的区域中不可见。但是，如果填充颜色具有透明度值（例如： `128`)，因此是半透明的，那么网格仍然可见。 : 网格在曲线上。例如，如果曲线显示为面积图，则填充颜色的区域始终显示为网格。

表 138. 零线

位置	显示零线未使用 Y轴显示 X轴显示两者都显示
线条样式	例子：点
行宽	例子： `2`
颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。

组：曲线设置

这些设置与树视图中选择的曲线相关。

附在 Y 轴上

分配给选定曲线的 Y 轴。 Y 轴可以分配多条曲线。列表框包括在元素中创建的所有轴。

例子：是

表 139. 数据 X / 数据 Y

多变的

基本数据类型、自定义数据类型或功能块的数组变量。该变量包含 X 或 Y 数据的曲线数据。

基本数据类型的一维数组变量：
ARRAY [ <下索引限制> .. <上限索引> ] OF <基本数据类型>
基本数据类型的二维数组变量：
ARRAY [ <下索引限制 1> .. <上限索引限制 1> , <下索引限制 2> .. <上限索引限制 2> ] OF <基本数据类型>
<下索引限制 1> .. <上限索引限制 1> : 第 1 维
<下索引限制 2> .. <上限索引限制 1> : 第二维
用户定义数据类型的一维数组变量
ARRAY [ <下索引限制> .. <上限索引> ] OF <DUT 名称>
枚举的一维数组变量
ARRAY [ <下索引限制> .. <上限索引> ] OF <枚举名称>
功能块的一维数组变量
ARRAY [ <下索引限制> .. <上索引限制> ] OF <功能块名称>

注意：只有在您知道值范围的情况下才能为轴设置固定比例。否则，我们建议您设置自动缩放。

请参阅：示例

要使用的元素

使用的复杂数据类型的数组元素。

. 当数据类型为多变的是复杂数据类型的数组（由多个元素组成）：

多维数组
自定义数据类型
功能块

：打开一个包含所有数组元素的列表框。

例 52. 示例：基本类型的二维数组 REAL

宣言

PROGRAM Curve
VAR
   aDataXY : ARRAY [1..2, 1..50] OF REAL;
END_VAR

数据 X

多变的： Curve.aDataXY

要使用的元素： [1]

数据 Y

多变的： Curve.aDataXY

要使用的元素： [2]

结果，该曲线中显示了 100 个数组值。

例 53. 示例：用户定义数据类型的一维数组

宣言

TYPE STRUCT_A :
STRUCT
        iX: INT;
        rY: REAL;
        bResult: BOOL;
END_STRUCT
END_TYPE

PLC_PRG
VAR
        aDataXY : ARRAY [1..50] OF STRUCT_A;
END_VAR

数据 X

多变的： aDataXY.iX

要使用的元素： iX

数据 Y

多变的： aDataXY.rY

要使用的元素： rY

例 54. 示例：结构的一维数组 POINT

PLC_PRG
VAR
        aPoints_1: ARRAY[0..99] OF POINT; // POINT ist eine Struktur mit iX und iY
END_VAR

数据 X

多变的： PLC_PRG.aPoints_1

要使用的元素： iX

数据 Y

多变的： PLC_PRG.aPoints_1

要使用的元素： iY

因此，有 200 个 X 和 Y 值可用，它们在图表中以 100 个曲线点显示。

例 55. 示例：功能块的一维数组

宣言

FUNCTION_BLOCK FB_A
VAR_INPUT
        iIn: INT;
END_VAR
VAR_OUTPUT
        iOut: INT;
END_VAR
PROGRAM PLC_PRG
VAR
        aDataXY : ARRAY [1..50] OF FB_A;
END_VAR

数据 X

多变的： PLC_PRG.aDataXY

要使用的元素： iIn

数据 Y

多变的： PLC_PRG.aDataXY

要使用的元素： iOut

表 140. 属性：数组索引

数组索引将曲线的显示限制在部分区域。而不是所有点都显示在 XY 图表中，只有来自最低限度到最大被显示。最低限度和最大是不得违反索引限制的索引。编译器也会对此进行监控。选择数组声明的索引限制。

例子： <variable name> : ARRAY [ <lower index bound> .. <upper index bound> ] OF <data type>;

此外，您可以在以下实例中以编程方式限制显示 VisuStructXYChartCurve.结构元素 diIndexMin 和 diIndexMax 可用于此目的。它们具有相同的功能最低限度和最大.在运行时，这些值会在此处复制到这些结构元素中。

另外，您可以只限制一侧的显示区域，并且只指定一个最低限度或只有一个最大.如果您未在此处或在结构中指定限制，则完全显示曲线。

将变量（数值数据类型）指定为数组索引时，可以使显示动态化。

最低限度

最小索引为文字、变量（数值数据类型）或常量变量（数值数据类型）

指定显示曲线的索引。索引大于等于索引限制 <lower index bound>.

例子： 10, PLC_PRG.uiLowerIndex, GVL.c_diMIN

最大

最大索引为文字、变量（数值数据类型）或常量变量（数值数据类型）

例子： 20, PLC_PRG.uiUpperIndex, GVL.c_diMAX

包含显示曲线的索引。索引小于或等于索引限制 <upper index bound>.

表 141. 图表

类型	折线图：数据显示为实线。此外，数据可以显示为点。为此目的提供了输入字段。笔记：折线图中每条曲线最多可绘制 32,767 个点。当超过这个数字时，会发出警告，并且只绘制曲线的前 32,767 个点。条形图：数据显示为竖线。为颜色和透明度提供了输入字段。面积图：数据显示为带有彩色填充区域的实线。此外，数据可以显示为点。为此目的提供了输入字段。

以下设置可用时折线图类型被选中。
线条颜色	: 轴线颜色列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。
线型	线步低步高无仅点
行宽	例子： `2`
线条样式	例子：点
点样式	没有点叉小圆圈大圆圈

以下设置可用时条形图类型被选中。
条形	固定宽度：条形图以固定宽度显示。可变宽度：条形宽度取决于值之间的距离。
主色	列表框中的样式颜色。例子：元素-XYChart-轴-背景在颜色对话框中选择的固定值。例子： `0; 0; 0`
替代颜色
框架颜色

以下设置可用时面积图类型被选中。
线条颜色	例子：蓝色：颜色配置被禁用，因此应用轴颜色。
灌装类型	用于填充曲线之间区域的颜色。无填充素色：单色区域坡度：用颜色渐变填充的区域
填充颜色	例子：灰色的 : 打开颜色对话要求：素色被选中灌装类型. ：颜色配置被禁用，因此应用了线条颜色。
透明度	纯色的透明度值 (0–255)。例子： `128` 要求：素色被选中灌装类型.
坡度	用颜色渐变填充的区域。 : 打开渐变编辑器对话要求：坡度被选中灌装类型.
行宽	例子： `2`
线条样式	例子：点
点样式	数据在图表中显示为点样式的点。没有点叉小圆圈大圆圈

光标捕捉到的曲线值

将光标的 Y 位置写入曲线的变量（整数数据类型）。

例子： Sine.Cursor_Pos_Y

表 142. 扩展变量

曲线变量	变量（数据类型 `VisuStructXYChartCurve` 来自 `VisuElemXYChart` 图书馆）此处配置的变量使用静态配置进行初始化。在运行时，笛卡尔 XY 图元素响应此结构的变化。因此，可以在运行时以编程方式控制该元素。注意：当以编程方式控制此结构时，分配顺序可能会出现问题。因此，应用程序应仅在初始化可视化元素和结构变量时分配其初始值 `iInitialized` 已切换到 1。这 `iInitialized` 变量仅适用于 CODESYS 版本 SP16。对于旧版本，订单问题不能很好地解决。参见示例：曲线变量

例 56. 示例：曲线变量

宣言

PROGRAM PLC_PRG
VAR
   XYCurve : VisuStructXYChartCurve;
END_VAR

任务

IF XYCurve.iInitialized > 0 THEN
   XYCurve.diColor    := 16#00FF0000;           // red
   XYCurve.iLineWidth := iLineWidth;            // line width
END_IF

表 143. 参考曲线

曲线	被引用的曲线。曲线之间的区域用颜色填充。
颜色	用于填充曲线之间区域的颜色。列表框中的样式颜色。例子： `Light gray` 在颜色对话框中选择的固定值。例子： `0; 0; 0`

组：轴设置

这些设置与树视图中选择的轴相关。

表 144. 显示设置

位置

X轴：选择 X 轴。 XY 图表中只有一个 X 轴。
在左侧：选择 Y 轴并显示在图表的左侧。
在右侧：选择 Y 轴并显示在图表的右侧。

最低限度

最大

显示曲线的轴值的最小和最大限制

. 限制指定为

变量（数值数据类型）
例子： PLC_PRG.iMinX, PLC_PRG.iMaxX
常量变量（数值数据类型）
GVL 中的声明： VAR_GLOBAL CONSTANT c_iMINX : INT; c_iMAXX : INT; END_VAR
例子： GVL.c_iMINX, GVL.c_iMAXX
固定值（数字文字）
例子： -1000, 1000

注意

仅当自动缩放已禁用。

自动缩放

standard icon ：轴自动缩放。这最低限度和最大设置不可见。

轴颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值。

表 145. 背景

类型	无背景素色：在输入字段中配置的颜色背景颜色和透明度坡度: 带渐变的背景。打开渐变编辑器。图片：带图像的背景；在输入字段中配置图像 ID
颜色	列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值可用时素色类型被选中
透明度	用于定义所选颜色透明度的值（0 到 255）例子 `255`：颜色不透明。 `0`：颜色完全透明。可用时素色类型被选中
图像 ID	`<image pool name> . <ID>` 例子： `Images.Logo` 可用时图片类型被选中
透明色	: 背景以透明色显示列表框中的样式颜色例子：浅绿色在颜色对话框中选择的固定值可用时图片类型被选中
缩放类型	各向同性：整个图像显示在元素框内，或大或小。因此，高度和宽度的比例保持不变。各向异性：图像会自动调整大小以适应元素框架的尺寸，填满整个元素框架。因此，比例不会保留。固定的：即使元素框架被调整大小，图像仍保持其原始大小。还请注意，已选择剪辑选项。可用时图片类型被选中

表 146. 扩展变量

轴变量	变量（数据类型 `VisuStructXYChartAxis` 来自 `VisuElemXYChart` 图书馆）此处配置的变量使用静态配置进行初始化。在运行时，笛卡尔 XY 图元素响应此结构的变化。因此，可以在运行时以编程方式控制该元素。注意：当以编程方式控制此结构时，分配顺序可能会出现问题。因此，应用程序应仅在初始化可视化元素和结构变量时分配其初始值 `iInitialized` 已切换到 1。这 `iInitialized` 变量仅适用于 CODESYS 版本 SP16。对于旧版本，订单问题不能很好地解决。参见示例：轴变量

例 57. 示例：轴变量

宣言

PROGRAM PLC_PRG
VAR
   XYAxis : VisuStructXYChartAxis;
END_VAR

任务

IF XYCurve.iInitialized > 0 THEN
   XYAxis.rMin := 12.0;           // minimum axis value
   XYAxis.rMax := 36.0;           // maximum axis value
END_IF

表 147. 扩展显示参数

显示标尺轴在原点重叠显示数字最大数量显示显示最小数量中间显示数字覆盖数字	: 相应地显示轴。
数字旋转角度	角度（以度为单位），指定轴标签的数字旋转多少度例子： `45` 旋转是顺时针的，因此零度位置是通常的显示位置。度数可以是负数。注意当设置旋转时，设置不被考虑覆盖数字. 因此，显示的数字可能会重叠。
旋转对齐标记	：显示数字的假想框的一侧与参考标记对齐。：显示数字的假想框的中心与参考标记对齐。
数字替换文本	这样做时，文本列表的索引必须等于被替换的数字。索引可以是负数和小数（带小数位）。旋转功能也可用于文本。提示我们强烈建议您准备简短的文本列表。该元素最多可以处理每个轴的 100 个文本。
格式字符串	用于格式化轴的输出文本。直接指定格式字符串例子： `dd:MM:yyyy HH:mm:ss:ms` 引用本地化格式字符串的文本列表条目例子： `TextList.ID` 在文本列表中，可以为不同的语言指定不同的格式字符串。因此，文本将根据语言进行显示。如果此轴的数据为 DATE/TIME/TOD/DT 类型，则使用日期/时间的格式字符串。然后日期和时间会分两行显示。日期和时间格式之间会有一个换行符。

表 148. 标签

文字编号	`<text list name> . <ID>` 例子： `Texts.mm` （文字列表 `Texts` 已在项目中可用。）
颜色	: 轴颜色的标签列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值何时可用测试编号被初始化
回转	0°: 平行于轴 90°: 绕轴旋转 270°: 绕轴旋转何时可用测试编号被初始化。
字体	列表框中的字体样式。例子：注解默认选择的固定值字体对话何时可用测试编号被初始化

表 149. 水平线

沿轴线的线

Y 轴的线为水平线，X 轴的线为垂直线。最多可以有 10 条线。

电话号码

寻址该行并导致在下面的窗口区域中显示该行的相应参数设置 <n> 行的参数.

例子： 3

<n> 行的参数
价值	例子： `3`
	最多可以有 10 行。
线条样式	例子：点
行宽	例子： `2`
颜色	: 轴颜色中水平线值的线列表框中的样式颜色。例子：浅绿色在颜色对话框中选择的固定值
标签文本 ID	`<text list name> . <ID>` 例子： `Texts.mm` （文字列表 `Texts` 已在项目中可用。）
标签位置	排队更多以下剩下正确的
标签旋转	0°: 平行于轴 90°: 绕轴旋转 270°: 绕轴旋转何时可用标签的测试 ID 被初始化
字体	列表框中的字体样式。例子：注解默认选择的固定值字体对话何时可用标签的测试 ID 被初始化

本节内容如下:

参见:

对话框：XY 图表配置

组：元素设置

组：曲线设置

组：轴设置

注意

注意

提示

搜索结果