对话框“XY图表配置”

符号：

功能：该对话框包含笛卡尔XY图表的配置，该图表将数组中的数据可视化。

调用：在笛卡尔XY图表属性中单击XY图表。

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

对话框左侧的树状视图可视化了XY图表的配置并充当导航器。如果选择了顶层条目（1）或根本没有选择任何内容，则在右侧可以看到元素设置组。此配置包括图表刷新频率。此外，可以使用影响图表外观和功能的设置。

如果在曲线节点（2）下选择了一个条目，则曲线设置组在右侧可见。此配置包括分配给所选曲线的Y坐标轴和该曲线可视化的数组数据。此外，可以使用影响所选曲线外观和功能的设置。该条目显示曲线的名称，并在括号中分配了坐标轴。例如，Curve1 [AxisY1]表示将纵坐标轴AxisY1分配给曲线Curve1。

如果在轴节点（3）下选择了一个条目，则轴设置组在右侧可见。此配置包括图表中Y坐标轴的位置。此外，可以使用影响所选坐标轴外观和功能的设置。该条目显示轴的名称，并在括号中带有其功能。轴可以充当X轴或Y轴。例如，AxisX（X）表示轴AxisX充当水平横坐标轴X。

添加	将新条目添加到视图。结果: 新曲线或轴旁边将显示一个空配置。在此编辑设置。
删除	删除选定的条目。
上移	将所选条目上移一个位置。
下移	将所选条目下移一个位置。

确定	保存设置，关闭对话框，并根据设置显示元素。

组“元素设置”

.更新

类型

自动: 如果影响图表呈现或数组元素的数组数据发生更改，则图表将自动刷新。
提示：扩展变量中提供了设置启用自动更新，以通过编程方式控制自动更新。
变量：如果变量值更改，则刷新图表。

变量

变量(整数数据类型)

如果选择类型变量，则可用。

参见示例变量

.示例：变量

.声明


PROGRAM Sine
VAR_INPUT 
   uiUpdate : UINT;
END_VAR

.分配


Sine.uiUpdate

.背景

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

.主光标

类型	光标显示为未使用功能垂直大十字小十字拦截器
线型	示例：点如果选择类型，则不可用。
颜色	下拉列表中的样式颜色。示例：浅绿在颜色对话框中选择的固定值。
X 位置变量	写入光标X位置的变量（整数数据类型）。示例：PLC_PRG.iPosition 如果选择类型，则不可用。

.扩展变量

元素变量

来自VisuStructXYChart 库的数据类型为VisuElemXYChart的变量

此处配置的变量使用静态配置初始化。在 runtime 模式下，元素笛卡尔 XY 图表响应此结构中的更改。其结果是，可以在 runtime 模式下以编程方式控制该元素。

参见示例元素变量

自动更新使能

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

TRUE: 更改后，该图表的显示将自动刷新。

示例：PLC_PRG.bIsUpdating

注意：在更新中选择自动类型时可用。

.示例：元素变量

.声明


PROGRAM Sine
VAR_INPUT 
   XYGraph : VisuStructXYChart;
END_VAR

.分配


Sine.XYGraph

.第二光标

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

.网格

类型	网格显示为未使用功能大网格窄网格大标记点状网格小标记点状网格
线型	示例：点如果选择类型或，则不可用。
颜色	下拉列表中的样式颜色。示例：浅绿在颜色对话框中选择的固定值。
曲线后的网格	：网格显示在曲线后面的图层中。例如，如果曲线显示为区域图表，则在填充颜色的区域中网格不可见。但是，如果填充颜色具有透明度值（例如： 128）因此是半透明的，则网格仍然可见。：网格位于曲线上。例如，如果曲线显示为区域图表，则在填充颜色的区域中将始终显示为网格

.零线

位置	零线显示未使用功能 Y 轴显示 X 轴显示同时显示
线型	示例：点
线宽	示例：2
颜色	下拉列表中的样式颜色。示例：浅绿在颜色对话框中选择的固定值。

组“曲线设置”

设置与在树形视图中选择的曲线有关。

附于 Y 轴

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

示例：Y

.数据X/数据Y

变量

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

复杂数据类型:

基本数据类型的一维数组变量：
ARRAY [ <lower index bound> .. <upper index bound> ] OF <basic data type>
基本数据类型的二维数组变量：
ARRAY [ <lower index bound 1> .. <upper index bound 1> , <lower index bound 2> .. <upper index bound 2> ] OF <basic data type>
<lower index bound 1> .. <upper index bound 1>: 第一维
<lower index bound 2> .. <upper index bound 2>: 第二维
自定义数据类型的一维数组变量：
ARRAY [ <lower index bound> .. <upper index bound> ] OF <DUT name>
枚举的一维数组变量
ARRAY [ <lower index bound> .. <upper index bound> ] OF <enumeration name>
功能块的一维数组变量
ARRAY [ <lower index bound> .. <upper index bound> ] OF <function block name>

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

参见：示例

使用的元素

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

.如果变量的数据类型是复杂数据类型（由多个元素组成）的数组，则可用：

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

：打开包含所有数组元素的下拉列表。

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

.声明


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

数据

变量：Curve.aDataXY

使用的元素：[1]

数据 Y

变量：Curve.aDataXY

使用的元素：[2]

然后，在此曲线中显示100个数组值。

.示例：自定义数据类型的一维数组：

.声明


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

数据

变量：aDataXY.iX

使用的元素：iX

数据Y

变量：aDataXY.rY

使用的元素：rY

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


PLC_PRG
VAR
    aPoints_1: ARRAY[0..99] OF POINT; // POINT是具有iX和iY的结构体 
END_VAR

数据X

变量：PLC_PRG.aPoints_1

使用的元素：iX

数据Y

变量：PLC_PRG.aPoints_1

使用的元素：iY

然后有200个X和Y值可用，这些值在图表中以100个曲线点显示。

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

.声明


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

.属性数组索引

数组索引将曲线的显示限制为局部区域。而不是在XY图表中显示所有点，而是仅显示从最小到最大的点。最小值和最大值是不得违反索引限制的索引。编译器也对此进行监视。选择数组声明的索引限制。

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

此外，您可以在VisuStructXYChartCurve实例中以编程方式限制显示。为此可以使用结构体元素diIndexMin和diIndexMax。它们具有与最小和最大相同的功能。在 runtime ，将值复制到这些结构体元素中。

此外，您只能将显示区域限制为一侧，并且只能指定一个最小值或一个最大值。当您在此处或结构体中未指定限制时，曲线将完全显示。

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

最小

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

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

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

最大

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

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

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

.图标

类型	折线图：数据被显示为一个连续的线。此外，数据可以显示为点。为此提供了输入字段。柱状图：数据被显示为竖条。提供了用于颜色和透明度的输入字段。区域图：数据显示为带有彩色填充区域的连续线。此外，数据可以显示为点。为此提供了输入字段。

选择折线图类型时，可以使用以下设置。
线色：	：轴线颜色下拉列表中的样式颜色。示例：浅绿色在颜色对话框中选择的固定值。
线型	线步低步高无仅点
线宽	示例： 2
线型	示例：点
点样式	无点十字小圆大圆

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

选择柱状图类型时，可以使用以下设置。
线色	示例：蓝：颜色配置已禁用，因此应用了轴颜色。
填充类型	用于填充曲线之间区域的颜色。无填充素色：单色区渐变:：充满颜色渐变的区域
填充颜色	示例：灰色：打开颜色对话框。要求：在填充类型中选择纯色。：颜色配置已禁用，因此应用了线颜色。
透明度	颜色的透明度值（0-255）。示例：128 要求：在填充类型中选择纯色。
渐变	充满颜色渐变的区域：打开渐变对话框。要求：在填充类型中选择渐变。
线宽	示例： 2
线型	示例：点
点样式	数据在图表中以点样式显示为点。无点十字小圆大圆

光标捕获的曲线值

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

示例：Sine.Cursor_Pos_Y

.扩展变量

曲线变量	变量（来自VisuElemXYChart库的数据类型为VisuStructXYChartCurve) 此处配置的变量使用静态配置初始化。在 runtime 模式下，笛卡尔XY图表元素响应此结构体中的更改。其结果是，可以在 runtime 模式下以编程方式控制该元素。参见示例曲线变量

.示例：曲线变量

.声明


PROGRAM Sine
VAR_INPUT 
   Curve : VisuStructXYChartCurve;
END_VAR

.分配


Sine.Curve

.参考曲线

曲线	所参考的曲线曲线之间的区域以颜色填充。
颜色	用于填充曲线之间区域的颜色。下拉列表中的样式颜色。示例：Light gray 在颜色对话框中选择的固定值。示例：0 ;0 ;0

组“轴设置”

设置与在树形视图中选择的轴相关。

.显示模式

位置

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

注意：仅在禁用自动缩放时可见。

自动缩放

：轴自动缩放。最小和最大设置不可见。

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

.背景

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

.扩展变量

轴变量	变量（来自VisuElemXYChart库的数据类型为VisuStructXYChartAxis) 此处配置的变量使用静态配置初始化。在runtime模式下，笛卡尔XY图表元素响应此结构中的更改。其结果是，可以在runtime模式下以编程方式控制该元素。参见示例轴变量

.示例：轴变量

.声明


PROGRAM Sine
VAR_INPUT 
   AxisX : VisuStructXYChartAxis;
END_VAR

.分配


Sine.AxisX

.扩展显示参数

显示标尺

轴原点重叠

显示数字

显示最大数量

显示最小数量

在中间显示数字

覆盖数字

：相应地显示轴。

.标签

文本ID	<text list name>.<ID> 示例：Texts.mm（文本列表Texts已在工程中可用。）
颜色	：轴颜色上的标签下拉列表中的样式颜色。示例：浅绿色在颜色对话框中选择的固定值。如果测试ID已初始化，则可用。
旋转	0°: 平行于轴 90°: 绕轴旋转 270°: 绕轴旋转如果测试ID已初始化，则可用。
字体	下拉列表中的字体样式。示例：注解在默认的字体对话框中选择的固定值。如果测试ID已初始化，则可用。

.水平线

沿轴的线。该线对于Y轴是水平的，对于X轴是垂直的。最多可以有10条线。

线号

对该线进行寻址，并导致在该线的线参数<n>下方的窗口区域中显示该线的相应参数设置。

示例：3

线参数<n>
值	示例：3
	最多可以有10条线。
线型	示例：点
线宽	示例：2
颜色	：轴颜色中水平线值的线下拉列表中的样式颜色。示例：浅绿色在颜色对话框中选择的固定值。
标签文本ID	<text list name>.<ID> 示例：Texts.mm（文本列表Texts已在工程中可用。）
标签位置	. 内嵌上方下方左侧右侧
标签旋转	0°: 平行于轴 90°: 绕轴旋转 270°: 绕轴旋转如果标签的测试ID已初始化，则可用。
字体	下拉列表中的字体样式。示例：注解在默认的字体对话框中选择的固定值。如果标签的测试ID已初始化，则可用。

.另请参见