XY 历史数据曲线控件

一、绘制 XY 历史数据曲线

在绘图工具栏中，选择“图形控件”按钮，弹出“图形控件选择”对话框，如下图示：

选择“窗口控件”中的“XY 历史数据曲线”，用鼠标左键双击或选择按“确定”按钮，画面上出现绘制控件的光标，移动光标到画面中需要绘制的位置，单击鼠标左键即可。如下图示：

二、XY 历史数据曲线的设置

用鼠标左键双击 XY 历史数据曲线，弹出设置 XY 历史数据曲线设置对话框，如下图示：

XY 历史数据曲线名称：设置 XY 历史数据曲线控件名称，可以为中文名或英文名。

标注位置：上边、下边、左边、右边等四个位置可选。

颜色

标注背景：XY 历史数据曲线的标注显示颜色。

曲线背景：XY 历史数据曲线的背景显示颜色。

X轴、Y轴参数：

主分割线：主分割线的数量及颜色。

次分割线：次分割线的数量及颜色。

标注数量：标注数量的数量及颜色。

最大值：标注的最大值。

最小值：标注的最小值。

小数位：标注的小数位数。

选项（以下四个选都是可选的）

显示网格线：是否显示网格线。

显示边框：是否显示边框。

显示游标：是否显示游标。

游标颜色：设定游标显示颜色。

最大采集点：允许的最大采集点，范围为1～2147483647。

访问权限：范围为0～9999。

曲线1～8：用于关联8条曲线对应的 X 轴和 Y 轴变量，同时设置8条曲线显示的颜色。

三、显示采样点值方法

鼠标左键双击，游标自动找到最近的采样点，并显示采样点值。

用鼠标左键双击曲线边框，弹出对话框，如下所示：

显示网格线：是否显示网格线

显示边框：是否显示边框

标记采样点：是否标记采样点

连接采样点：是否连接采样点

显示游标：是否显示游标。

四、XY 历史数据曲线控件使用示例

1、调用函数 xyHDStartDateTime() 设置控件的起始日期和时间

xyHDStartDateTime( "XYHDControl", Year, Month, Day, Hour, Minute, Second );

2、调用函数 xyHDSetTimeLength() 设置控件的时间长度

xyHDSetTimeLength( "XYHDControl", TimeLength );

3、调用函数 xyHDUpdateChart() 刷新控件

xyHDUpdateChart( "XYHDControl" );

4、调用函数 xyHDSetMinMaxValue() 调整控件曲线显示的区域

xyHDSetMinMaxValue( "XYHDControl", XMinValue, XMaxValue, YMinValue, YMaxValue );

5、调用函数 xyHDClear() 或 xyHDSelectPen() 选择查看部分或全部控件曲线

xyHDClear( "XYHDControl", Index );

xyHDSelectPen( "XYHDControl", Index );

五、XY 历史数据曲线控件函数

1、xyHDClear( )：在指定的 XY 历史数据曲线控件中清除指定索引号的曲线。

2、xyHDLoadFile( )：从指定的文件的数据调入 XY 历史数据曲线控件数据。

3、xyHDSaveFile( )：保存 XY 历史数据曲线控件数据到指定的文件中。

4、xyHDSelectPen( ) ：将指定索引号的曲线选择到 XY 历史数据曲线控件中，即在 XY 历史数据曲线控件中显示指定索引号的曲线。

5、xyHDSetMinMaxValue( )：动态设定 XY 历史数据曲线 X 轴和 Y 轴的最大值和最小值。

6、xyHDStartDateTime( )：设定 XY 历史数据曲线起始日期和时间。

7、xyHDSetTimeLength( )：设定 XY 历史数据曲线控件显示曲线数据的时间长度。

8、xyHDSelectTagname( )：弹出历史曲线变量选择对话框，用于选择 XY 历史数据曲线控件关联的变量。

9、xyHDGetTagname( )：获取 XY 历史数据曲线控件关联的变量名称。

10、xyHDUpdateChart( )：刷新 XY 历史数据曲线控件。

下载测试工程：XY 历史数据曲线控件测试工程