第14章 曲线及图表

1、 第十四章 曲线与图表 14-85第十四章 曲线与图表F 教您如何使用趋势曲线F 教您如何使用XY曲线图素F 教您如何使用棒图14.1 趋势曲线 趋势曲线用来反应数据变量随时间的变化情况。趋势曲线有两种：实时趋势曲线和历史趋势曲线。这两种曲线外形都类似于坐标纸，X轴代表时间，Y轴代表变量值。所不同的是，在画面程序运行时，实时趋势曲线随时间变化自动卷动，以快速反应变量的变化，但是不能随时间轴“回卷”，不能查阅变量的历史数据；历史趋势曲线可以完成历史数据的查看工作，但它不会自动卷动，而需要通过命令语言来辅助实现查阅功能。一个画面中可定义数量不限的趋势曲线，在同一个趋势曲线中最多可同时显示64个变量

2、的变化情况。下面将具体介绍趋势曲线的使用方法。14.1.1 创建趋势曲线在KingSCADA画面编辑器中打开任一画面，单击“对象”菜单 “扩展”“趋势曲线”命令或直接单击工具箱中的图标 鼠标移到画面中，光标呈+状，按住鼠标左键并拖动即可生成趋势曲线窗口，如图所示：图14- 1 趋势曲线图素趋势曲线由三部分组成，分别是： 标题区 绘图区：包括网格区、曲线、图例区和数据轴 时间轴：包括游标除了图素本身的属性外，每个区域都有自己的属性，下面将分别介绍这些属性的使用方法。14.1.2 趋势曲线图素属性在画面中选择趋势曲线图素，右侧会弹出图素属性对话框，如图所示： 图14- 2 趋势曲线图素属性Name

3、：趋势曲线的名称MemberAccess：设置该图素能否能在脚本中访问。true：能在脚本中访问，false：不能在脚本中访问Comment：可以加注描述信息，缺省为空Size：通过设置宽度和高度的像素值确定图素的大小Location：位置，通过设置X轴和Y轴的像素值确定图素在画面中的位置BorderStyle：边框风格，设置趋势趋线图素边框的显示风格Background：背景，设置趋势曲线图素背景显示颜色及风格ChartAreaCount：绘图区数目，一个趋势曲线图素可最多划分为4个绘图区TimeAxis Count：时间轴数目，设置趋势曲线图素时间轴的数目，最多为2个RefreshFreq

4、uance：趋势曲线实时模式下，曲线刷新的频率，以毫秒为单位。TopHeight：绘图区距离趋势曲线图素上边缘的高度，最小设置为10。BottomHeight：绘图区距离趋势曲线图素下边缘的高度，最小设置为10。EditLock：编辑锁定，设置在开发环境该图素是否可以编辑。EditVisible：编辑可见，设置在开发环境该图素显示与否SecurityPriority：设置趋势曲线的安全级别SecuritySection：设置趋势曲线的安全域RefreshMode：趋势曲线实时模式下，曲线绘制的方向，可设置为自右刷新和自左刷新。LButtonZoomMode：趋势曲线历史模式下，通过鼠标左键框选

5、进行区域放大，单击鼠标右键进行还原。有四个选项：无、X轴方向、Y轴方向、XY轴方向。无：不支持鼠标左键框选区域放大；X轴方向：鼠标左键框选完，鼠标弹出时，该绘图区的时间轴的最大最小值变为框选区域的X轴方向的最大最小时间。Y轴方向：鼠标左键框选完，鼠标弹出时，该绘图区的数据轴的最大最小值变为框选区域的Y轴方向的最大最小值。XY轴方向：鼠标左键框选完，鼠标弹出时，该绘图区的时间轴的最大最小值变为框选区域的X轴方向的最大最小时间，数据轴的最大最小值变为框选区域的Y轴方向的最大最小值。即框选区域填充整个绘图区。当趋势曲线设置为历史模式的情况下，属性里才会出现LButtonZoomMode属性。Tren

6、dsMode：曲线模式，设置此图素显示曲线的模式，包括实时模式和历史模式ShowBorder：显示边框，设置趋势曲线图素的边框显示与否Visible：可见性，设置趋势曲线图素在运行环境中显示与否Enable：可用性，设置趋势曲线图素在运行环境中是否可以进行操作TabIndex：Tab键索引号，即在开发环境中使用Tab键切换图素的顺序HotKey：热键EnableTooltip：设置显示提示文本Tooltiptext：提示文本内容，当鼠标移动到图素对象上时显示的文本提示信息，最大长度128字符14.1.3 趋势曲线标题区选中趋势曲线窗口 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 单击标题

7、区，右侧弹出属性对话框，如图所示：图14- 3 趋势曲线标题区属性Name：标题区对象的名称，该名称不可编辑Location：通过设置X轴和Y轴的像素值确定标题区在趋势曲线图素中的位置，此位置是个相对位置，是相对趋势曲线图素的位置，范围为趋势曲线图素边界Size：通过设置宽度和高度的像素值确定标题区的大小，范围为趋势曲线图素边界BackColor：背景颜色，设置标题区的背景颜色Font：字体，设置标题区文字的字体TextBrush：字体颜色，设置标题区文字的颜色BorderStyle：边框风格，设置标题区的边框显示风格Text：文字，设置标题区显示的文本内容，长度限制为128个字符FillBa

8、ckground：显示背景颜色，设置标题区的背景颜色显示与否ShowBorder：显示边框，设置标题区边框显示与否AutoFit：自动调整边框大小，当选择true时，边框大小随字体的大小自动调整，但是不能手动拉伸边框，选择false时，可以手动拉伸边框大小Visible：设置在运行环境中标题区显示与否14.1.4 趋势曲线绘图区趋势曲线的绘图区可以划分多个区域，每个区域都可以作为一个独立的绘图区来使用，且每个区域都可以设置自己的属性，绘图区包括： 网格区 曲线 图例区 数据轴 绘图区属性选中趋势曲线图素 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 单击绘图区，如图所示：图

9、14- 4 趋势曲线绘图区绘图区属性对话框，如图所示：图14- 5 趋势曲线绘图区属性Name：绘图区对象的名称，该名称不可编辑CurveCount：曲线数目，设置绘图区中的曲线条数，最多支持曲线条数为16DataAxisCount：数据轴数目，设置绘图区中的数据轴的数量，最多支持数量为4Visible：设置在运行环境绘图区显示与否。Location：通过X轴和Y轴的像素值确定绘图区在趋势曲线图素中的位置，此位置是系统自动确定的，不可手动修改Size：通过宽度和高度的像素值确定标题区的大小，系统自动确定，不可手动修改注：在绘图区处于编辑的状态下（即选中绘图区），单击鼠标右键，出现的右键菜单包括

10、“添加绘图区”、“删除绘图区”（若当前绘图区没有曲线，则没有该命令）、“添加曲线”“添加数据轴”。多个绘图区效果如图所示：图14- 6多个绘图区效果 网格区属性选中趋势曲线图素 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 在绘图区内单击网格区，如图所示：图14- 7 网格区网格区属性对话框，如图所示：图14- 8 网格区属性Name：网格区对象的名称，该名称不可编辑Background：设置网格区的背景颜色ShowMajorGrid：显示主网格，设置在网格区中是否显示主网格，true表示显示，false表示不显示。选择true时下列属性有效：MajorGridColor：

11、设置主网格线显示的颜色，ShowMajorGrid属性为true时有效MajorGridStyle：设置主网格线显示的风格，ShowMajorGrid属性为true时有效MajorGridColumns：设置主网格线显示的列数，ShowMajorGrid属性为true时有效，可设置的数值范围是2100MajorGridRows：设置主网格线显示的行数，ShowMajorGrid主网格属性为true时有效，可设置的数值范围是2100ShowMinorGrid：显示副网格，设置在绘图区中是否显示副网格，true表示显示，false表示不显示MinorGrid Color：设置副网格线的颜色，Sho

12、wMinorGrid属性为true时有效MinorGrid Style：设置副网格线显示的风格，ShowMinorGrid属性为true时有效MinorGrid Columns：设置副网格线显示的列数，ShowMinorGrid属性为true时有效，可设置的数值范围是0100MinorGrid Rows：设置副网格线显示的行数，ShowMinorGrid属性为true时有效，可设置的数值范围是0100FillBackground：设置网格区的背景颜色显示与否Visible：设置在运行环境中网格区显示与否Location：位置，通过设置X轴和Y轴的像素值确定绘图区在趋势曲线图素中的位置，此位置是

13、个相对位置，是相对趋势曲线图素的位置，范围为：趋势曲线图素边界。Size：大小，通过设置宽度和高度的像素值确定网格区的大小，范围为趋势曲线图素边界。注：在网格区处于编辑的状态下（即选中网格区），单击鼠标右键，右键菜单中包括“添加曲线”、“删除曲线”命令。 曲线属性选中网格区 单击鼠标右键 在弹出的右键菜单中执行“添加曲线”命令 在网格区内单击曲线，曲线属性对话框，如图所示。图14- 9 曲线属性Name：曲线对象的名称，该名称不可编辑，默认为Curve1、Curve2CurveStyle：设置曲线的显示风格，包括模拟、阶梯、逻辑和棒图TimeAxis：在下拉列表框中选择该曲线对

14、应的时间轴，时间轴最多为2个，是在趋势曲线图素属性对话框中的“时间轴数目”中设定的DataAxis：在下拉列表框中选择该曲线对应的数据轴，数据轴最多为4个，是在绘图区属性对话框中的“数据轴数目”中设定的DataSource：数据源，设置曲线对应的变量，单击按钮，在弹出的变量列表中选择该曲线所对应的变量，或者单击按钮，在弹出的属性选择对话框中选择字符串类型的自定义属性作为曲线的数据源，比如“localTag1”ShowLabel：显示标签，设置在曲线上是否显示曲线点的数值。true表示显示，false表示不显示，效果如图所示。选择true时下列属性有效： 不显示标签 显示标签LabelTextC

15、olor： 标签文本颜色，设置曲线点数值的颜色，“ShowLabel”属性为true时有效LabelFont：设置曲线点数值的字体，“ShowLabel”属性为true时有效DecimalNum：设置曲线点数值显示的小数位数，可设置的最大位数是10。“ShowLabel”属性为true时有效Visible：设置曲线在运行系统下是否可见，该属性只在运行系统下起作用，在开发系统下即使设置为false也不会隐藏曲线（当在开发系统下Visible设置为false时，该曲线对应的图例前的复选框中的会取消，如图所示：）图14- 10开发系统下Curve1曲线Visible属性为falseInvalidDr

16、awType：无效数据绘制方式，设置曲线在下面情况下显示的方式。 曲线关联的变量的采集设备通讯失败； 曲线关联的变量的质量戳为坏； 运行系统退出。显示方式可以选择如下方式中的一种： 不绘制：从上一个有效数据点到下一个有效数据点间不采用任何连线方式。 直线：从上一个有效数据点到下一个有效数据点间采用直线进行绘制，并可在“InvalidLineStyle”属性中配置无效数据区域的线型。 区域填充：从上一个有效数据点到下一个有效数据点间采用填充区域的方式进行绘制，并可在“InvalidAreaStyle”属性中配置无效区域的填充颜色。InvalidLineStyle：无效数据线型InvalidAre

17、aStyle：无效数据区域风格Line Style：当曲线连线可见时，设置连线的线型。说明：趋势曲线是没有起始箭头的，即设置的起始箭头在开发态和运行态下都不显示。注：在曲线处于编辑的状态下（即选中曲线），单击鼠标右键，右键菜单中包括“添加曲线”、“删除曲线”命令。 图例区属性图例区是显示曲线说明信息的区域，每一个绘图区均包含一个图例区，且该区域是随着曲线的添加自动生成的。选中趋势曲线窗口 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 单击图例区，如图所示：图14- 11图例区图例区属性对话框，如图所示：图14- 12图例区属性Name：图例区对象的名称，该名称不可编辑Bru

18、sh：画刷，设置图例区背景颜色。BorderStyle：设置边框显示的样式，“ShowBorder”属性为true时有效FillBackgroud：设置图例区的背景颜色是否显示ShowBorder：设置图例区边框显示与否，true表示可见，false表示不可见AutoFit：自动调整边框大小，当选择true时，边框大小随字体的大小自动调整，但是不能手动拉伸边框，选择false时，可以手动拉伸边框大小Visible：设置在系统在运行环境下，图例区是否可见，true表示可见，false表示不可见。Location：通过设置X轴和Y轴的像素值确定图例区在趋势曲线图素中的位置，此位置是个相对位置，是相

19、对趋势曲线图素的位置，范围为趋势曲线图素边界。Size：通过设置宽度和高度的像素值确定图例区的大小，范围为趋势曲线图素边界。以上是图例区的属性介绍，下面介绍一下图例区中的图例项属性，在图例区可以单独选中某一图例项，如图所示：图14- 13选中图例项Curve2在图例区处于编辑的状态下（即选中图例区），单击图例项，弹出属性对话框，如图所示：图14- 14图例项属性Name：图例项对象的名称，该名称不可编辑LabelFont：设置图例项文本字体及颜色LabelColor：设置图例项文本的颜色Text：设置图例项文本内容，可设置的字符长度为64个字符ShowCheckBox：显示复选框，设置在该图例

20、项中是否显示复选框，当选择true时，显示复选框，单击复选框，该框中的消失，在开发系统中该图例项对应的曲线不会消失，仍然可见，只有在运行系统中该图例项对应的曲线会消失。如果不希望操作人员在运行环境中改变曲线的可见性，开发人员可以将此项设置为falseInformationMode：设置图例项显示的文本内容。默认：显示数据源，自定义：显示图例项的Text属性值Visible：设置在运行环境中该图例项显示与否。Location：该项是由系统自动确定的，不可手动修改。Size：该项是由系统自动确定的，不可手动修改。 数据轴属性数据轴是用来标识曲线数值范围的坐标轴，属于绘图区的一部分。

21、每个绘图区最多可以设置4个数据轴，是在绘图区属性对话框中的“DataAxisCount”属性中设置的。选中趋势曲线窗口 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 单击数据轴，如图所示：图14- 15数据轴数据轴属性对话框，如图所示：图14- 16数据轴属性Name：数据轴对象的名称，该名称不可编辑LineColor：设置轴线的颜色LabelTextColor：设置标记文本显示的颜色LabelFont：设置标记文本的字体ScaleMarkCount：设置数据轴刻度的数目，范围：2100MinValue：设置数据轴的显示最小值，参考可设定范围-2147483648, 2147483648M

22、axValue：设置数据轴的显示最大值，参考可设定范围-2147483648, 2147483648ScaleCountPerLable：设置数据轴每个标记包含的刻度数目DecimalNum：设置标记文本显示的小数位数，可设置的最大位数是10LabelDock：设置标签所在的位置，即标签字体位于数据轴左侧或右侧，通过鼠标拖曳操作，能够使数值轴沿时间轴水平方向进行调整ZoomRatio：缩放比例，按照百分比对数值轴进行缩放，默认为100%，即不进行缩放ShowType：显示方式，设置数据轴显示数据的方式，包括百分比显示、实际值显示和自适应显示 百分比显示：曲线的数值按照对应变量值在工程值范围中的

23、百分比数进行显示，数据轴的显示范围是0-100。例如变量的工程值范围为0-200，而曲线的某一点的值为50，则显示的坐标值为25（即（50 / （200-0）* 100 = 25），系统自动将工程值变为百分数值画出历史曲线 实际值显示：曲线的数值按照实际值显示，数据轴的显示范围是属性对话框中设置的“最小值”最大值”，只有曲线的数值处于这个设置区间的线段才能显示 自适应显示：按照当前的曲线值自适应调整Y轴显示范围ShowUnit：设置数据轴的单位是否显示Unit：设置数据轴的单位，可设置字符长度为15个字符ShowLine：设置数据轴线是否显示ShowLabel：设置数据轴标记是否显示Visib

24、le：设置运行环境中数据轴显示与否Location：通过X轴和Y轴的像素值确定数据轴在趋势曲线图素中的位置，此位置是个相对位置，是相对趋势曲线图素的位置，范围为趋势曲线图素边界，其中X轴坐标可以设置，Y轴坐标不可以手动设置Size：通过宽度和高度的像素值确定数据轴的大小，系统自动确定，不可手动修改。注：在数值轴处于编辑的状态下（即选中数值轴），单击鼠标右键，出现的右键菜单包括“添加数值轴”、“删除数值轴”，执行“增加数值轴”命令会自动添加一个数值轴。14.1.5 趋势曲线时间轴时间轴是用来标识曲线所展示的时间段的坐标轴，在历史趋势图素中最多可以显示两个时间轴。注：在时间轴处于编辑的状态下（即选

25、中时间轴），单击鼠标右键，出现的右键菜单包括“添加时间轴”、“删除时间轴”，执行“添加时间轴”命令会自动添加一个时间轴。 时间轴属性选中趋势曲线窗口 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 单击时间轴，如图所示：图14- 17时间轴时间轴属性对话框，如图所示：图14- 18时间轴属性Name：设置时间轴对象的名称，默认为TimeAxis1、TimeAxis2，不允许编辑LineColor：设置轴线的颜色LabelTextColor：设置标记文本显示的颜色LabelFont：设置标记文本的字体TimeParams：设置时间轴的时间参数，单击按钮，弹出对话框，如图所示：图

26、14- 19时间参数设置对话框上面的“设置时间参数”对话框提供了2种设置时间轴范围的方法。1. 固定的时间跨度：不设置起止时间，只设置时间跨度。运行态下，历史曲线保留首次查询时间，首次查询的时间为当前时间向前一个时间跨度，该跨度即为这里设置的时间跨度。2. 固定的时间参数：设置时间跨度和绝对的起止时间。运行态下，历史曲线按照该处的时间跨度查询起始时间和结束时间之间的数据。ScaleMarkCount：设置时间轴刻度的数目，范围：2100ScaleCountPerLable：设置时间轴每个标记包含的刻度数目LabelFormat：在下拉列表框中选择时间轴显示的风格LabelDock：为标签所在的

27、位置，即标签字体位于时间轴上端还是时间轴下端，通过鼠标拖曳操作，能够使时间轴沿数据轴垂直方向进行调整TextAngle：设置时间轴标记文字显示方向，即倾斜角度，范围是0359度。在开发态的设置：运行态设置：TrendChart1.TimeAxis1.TextAngle=20;ShowLine：设置时间轴线是否显示ShowLabel：设置时间轴标记是否显示Visible：设置运行环境中时间轴显示与否Location：通过X轴和Y轴的像素值确定时间轴在趋势曲线图素中的位置，此位置是个相对位置，是相对趋势曲线图素的位置，范围为趋势曲线图素边界，其中Y轴坐标可以设置，X轴坐标不可以手动设置Size：通

28、过设置宽度和高度的像素值确定时间轴的大小，由系统自动确定，不可手动修改 游标属性游标是附着在时间轴上的，帮助用户查看趋势曲线某一具体时刻的数值及其它信息的工具，在趋势曲线图素中一共有两个游标，左游标和右游标，下面将具体介绍游标的使用方法。选中趋势曲线窗口 单击鼠标右键 在弹出的右键菜单中执行“编辑”命令 选中游标对象，即可通过拖曳游标查看趋势曲线某一具体时刻的数值及其它信息。游标属性对话框，如图所示：图14- 20游标属性Name：游标对象的名称，该名称不可编辑，默认是Cursor1和Cursor2LineColor：设置游标杆的颜色LabelFont：设置游标和曲线焦点信息显

29、示的字体LabelBrush：设置游标和曲线焦点信息显示的字体颜色LabelBordStyle：设置游标和曲线焦点的信息窗的边框线显示方式LabelBackgroud：设置游标和曲线焦点的信息窗的背景颜色DecimalNum：设置游标和曲线焦点的信息中数值信息的小数位数，可设置的最大位数是10ShowVarName：设置在游标和曲线焦点的信息窗中是否显示曲线对象的名称，该名称是在曲线属性对话框中“名称”属性中设置的。true表示显示，false表示不显示ShowValue：设置在游标和曲线焦点的信息窗中是否显示曲线的数值，true表示显示，false表示不显示ShowTime：设置在游标和曲线

30、焦点的信息窗中是否显示曲线的时间。true表示显示，false表示不显示ShowQualityStamp：设置在游标和曲线焦点的信息窗中是否显示质量戳，质量戳含义如下： 0x00040000：正确数据 0x10000000：设备没有连接 0x20000000：设备连接 0x30000000：网络没有连接 0x40000000：网络连接 0x50000000：记录使能 0x60000000：记录不使能 0x70000000：开机 0x80000000：关机ShowMemo：输入在游标和曲线焦点的信息窗中显示的注释信息。ShowCursorName：设置在游标和曲线焦点的信息中是否显示游标对象的名

31、称。true表示显示，false表示不显示。MultiLine：设置在游标和曲线焦点的信息是否以多行的形式显示，选择true以多行形式显示，选择false以单行形式显示。LabelPosition：设置游标和曲线焦点信息窗显示的位置。 跟随曲线：跟随曲线显示 游标上端：并排显示在游标上端 游标下端：并排显示在游标下端 自定义：可由用户自己设置显示的位置，当选择此项时，可以使用鼠标拖拽信息窗口到画面的任何位置LabelShowType：设置游标和曲线焦点信息窗显示的方式。 不显示：不显示信息窗 总显示：一直显示信息窗 移动时显示：游标移动时显示信息窗ShowLableBorder：设置游标和曲线

32、焦点的信息窗的框线显示与否FillBackgroud：设置游标和曲线焦点的信息窗的背景颜色显示与否Visible：设置在运行环境是否显示游标Location：通过X轴和Y轴的像素值确定游标在趋势曲线图素中的位置，此位置是个相对位置，是相对趋势曲线图素的位置，范围为趋势曲线图素边界。其中X轴坐标可以设置，Y轴坐标不可以手动设置Size：通过X轴和Y轴的像素值确定游标的大小，由系统自动确定，不可手动修改14.1.6 趋势曲线事件在KingSCADA运行环境中，在用户操作趋势曲线图素的过程中，如游标的移动、曲线的更换、时间轴时间设定的变化、数据轴设定的变化以及曲线实时与历史数据进行切换时，都可以产生

33、一系列事件，通过这些事件的触发执行一系列脚本，实现对趋势曲线图素属性的修改或脚本的执行。设置方法如下：在KingSCADA画面中选中趋势曲线图素 单击连接窗口中的 图标 在弹出的菜单中选择“事件”命令 弹出二级菜单，如图所示：图14- 21趋势曲线图素事件在二级菜单中包括如下事件： 游标事件 曲线更换事件 时间轴变化事件 数据轴变化事件 实时/历史曲线切换事件 游标事件1、游标可产生的事件包括：获得游标时刻：OnFocusOnCursor(String CursorName,Long CurrentCursorTime);游标移动时：OnCursorMoving(String

34、CursorName,Long CurrentCursorTime);释放游标时刻：OnReleaseCursor（String CursorName,Long CurrentCursorTime);2、事件中可使用游标的参数说明：CursorName：游标名称，字符串类型CurrentCursorTime：游标所在位置的时间，长整型3、调用执行方式：在运行环境中，使用鼠标操作游标但尚未移动时，可触发“获得游标时刻”事件。在运行环境中，当鼠标拖动游标移动时，产生“游标移动”事件。在运行环境中，当移动结束，并且鼠标离开游标时刻，可触发“释放游标时刻”事件。 曲线更换事件1、曲线更

35、换事件：OnChangeCurve（String CurveName,Long CurveChangeTime, String CurveYName, String oldCurveDataSource, String newCurveDataSource）2、参数说明：CurveName：被更换的曲线名，字符串类型，值范围为Curve1Curve64CurveChangeTime：更换曲线时刻的时间，长整型CurveYName：被更换曲线的数据轴名称，字符串类型oldCurveDataSource：曲线原数据源，即曲线关联的原变量，字符串类型newCurveDataSource：曲线新数据源

36、，即曲线关联的新变量，字符串类型3、调用执行方式：在运行环境中，当更改曲线关联的变量时，可触发“曲线更换”事件。 时间轴变化事件1、时间轴变化事件包括：起始时间变化：OnChangeStartTime(String TimeAxisName, Long oldStartTime,Long newStartTime)时间轴长度变化：OnChangeTimeScope(String TimeAxisName,Long oldTimeScope,Long newTimeScope)2、参数说明：TimeAxisName：当前时间轴名称，字符串类型OldStartTime：原开始时间，

37、长整型NewStartTime：新开始时间，长整型OldTimeScope：原时间长度，长整型NewTimeScope：新时间长度，长整型3、调用执行方式：在运行环境中，当趋势曲线图素的时间轴的起始时间改变时，可触发“起始时间变化”事件。在运行环境中，当趋势曲线图素的时间轴的时间长度改变时，可触发“时间长度变化”事件。 数据轴变化事件1、数据轴变化事件包括：数据轴最大值变化：OnChangeYmaxValue(String DataAxisName,Float oldYMaxValue,Float newYMaxValue)数据轴最小值变化：OnChangeYminValue(

38、String DataAxisName,Float oldYMinValue,Float newYMinValue)数据轴显示方式变化：OnChangeYDisplay(String DataAxisName,String strDisplayMode,Float oldYScope, Float newYScope)2、参数说明：DataAxisName：数据轴名称，字符串类型oldYMaxValue：数据轴原最大值，浮点型newYMaxValue：数据轴新最大值，浮点型oldYMinValue：数据轴原最小值，浮点型newYMinValue：数据轴新最小值，浮点型strDisplayMod

39、e：数据轴显示方式，字符串类型oldYScope：数据轴原显示范围，浮点型newYScope：数据轴新显示范围，浮点型3、调用执行方式：在运行环境中，当趋势曲线图素的数据轴的最大值改变时，可触发“数据轴最大值变化”事件。在运行环境中，当趋势曲线图素的数据轴的最小值改变时，可触发“数据轴最小值变化”事件。在运行环境中，当趋势曲线图素的数据轴显示方式发生变化时，可触发“数据轴显示方式变化”事件。 实时/历史曲线切换事件1、实时/历史曲线事件包括：实时趋势切换到历史趋势：OnRealToHist()历史趋势切换到实时趋势：OnHistToReal()2、调用执行方式：在运行环境中，当

40、趋势曲线图素由实时趋势切换到历史趋势时，可触发“实时趋势切换到历史趋势”事件。在运行环境中，当趋势曲线图素由历史趋势切换到实时趋势时，可触发“历史趋势切换到实时趋势”事件。14.1.7 趋势曲线图素方法趋势曲线图素方法包括：增加曲线、删除曲线、修改时间轴、修改数据轴等等。通过调用方法，可以实现在线修改趋势曲线图素的功能，下面将具体介绍方法的种类及方法的使用。 增删变更图元类一、增删绘图区1、添加绘图区函数string AddArea()返回值说明：返回新增绘图区的名称。示例：TrendChart1.AddArea()2、删除绘图区函数bool DeleteArea(string

41、 AreaName)返回值说明：true-成功false-失败示例：TrendChart1.DeleteArea(“ChartArea1”)；二、增删曲线1、添加数据源为某变量的曲线。String AddCurve1(String AreaName，String TimeAxisName，String DataAxisName，String VariateName)；AreaName：曲线所在绘图区名称，字符串类型，如CharArea1、CharArea2、CharArea3、CharArea4TimeAxisName：曲线所关联时间轴名称，字符串类型，如TimeAxis1、TimeAxis2

42、DataAxisName：曲线所关联数据轴名称，字符串类型，如DataAxis1、DataAxis2DataAxis16VariateName：曲线所关联的变量名，字符串类型，如为空，则该曲线不关联任何变量返回值说明：返回值说明：添加成功：返回值为曲线名称添加失败：返回空字符串示例：TrendChart1.AddCurve1(“ChartArea1”, “TimeAxis1”, “DataAxis1”, “Tag1”);其中：TrendChart1是趋势曲线图素的名称2、添加数据源为某数据集的曲线。String AddCurve2(String AreaName, String TimeAxi

43、sName，String DataAxisName，String DataSetName)；AreaName：曲线所在绘图区名称，字符串类型，如CharArea1、CharArea2、CharArea3、CharArea4TimeAxisName：曲线所关联时间轴名称，字符串类型，如TimeAxis1、TimeAxis21、如果数据集的时间范围时间轴的范围，或部分重合，显示的曲线就是部分数据，然后，再将时间轴范围改大，能显示出剩下的数据；2、如果数据集的时间范围=时间轴的范围，或部分重合，显示的曲线就是部分数据，然后，再将时间轴范围改大，能显示出剩下的数据；2、如果数据集的时间范围=500。返

44、回值说明：0-成功-1- RefreshMode参数值非法-2= RefreshFrequence参数值非法3、设置曲线颜色Int SetCurveColorStyle(string CurveName,long nColorRed, long nColorGreen, long nColorBlue)CurveName：曲线名称nColorRed：红色素值（范围：0-255）nColorGreen：绿色素值（范围：0-255）nColorBlue：兰色素值（范围：0-255）返回值说明：0：成功-1：输入的曲线不在范围内。-2：输入的色素值不在范围内。4、设置数据轴标记文本显示的小数位数Bo

45、ol SetDataAxisDecimalNum(string DataAxisName,int DecimalNum)DataAxisName：字符串类型，数据轴名称DecimalNum：整数，设置标记文本显示的小数位数，可设置的最大位数是10。返回值说明：1-成功0-失败示例：TrendChart1.SetDataAxisDecimalNum(“DataAxis1”,2);将数据轴显示文本的数据小数位数设置为2位。二、设置绘图区1、设置绘图区背景颜色bool SetAreaBackground(string AreaName,BrushProperty Background)AreaNam

46、e：绘图区名称。Background：背景颜色，Color类型，是画面中用户自定义的Color属性的属性名称，如下图矩形所示：图14-22返回值说明：true-成功false-失败示例：TrendChart1.SetAreaBackground(“ChartArea1”,CustomProperty1);三、设置单条曲线属性1、设置曲线可见性，动态设置某曲线是否可见。void SetCurveVisible（string CurveName，bool Visible）CurveName：曲线名称。Visible：曲线是否可见标志，True表示该曲线可见，False表示该曲线不可见。示例：Tre

47、ndChart1.SetCurveVisible(“Curve1”,True);2、设置曲线属性Int SetCurveProperty（string CurveName，int InvalidDrawType，bool ShowValue，bool Visible）CurveName：曲线名称。InvalidDrawType：无效数据绘制类型，1=None（空），2=InvalidLine，3=FillInvalidArea（填充区域）ShowValue：是否在曲线上显示各个点值属性，True=显示，False=不显示。Visible：曲线是否可见属性，True=该曲线可见，False=该曲

48、线不可见。返回值说明：0-成功-1- InvalidDrawType参数值非法示例：TrendChart1.SetCurveProperty(“Curve1”,2,False,True);注：变量数据点的质量戳类型包括Good、Bad、开机、关机。根据数据点的质量戳，趋势曲线分为有效曲线和无效曲线，定义：3、设置曲线线条样式bool SetCurveLineStyle(string CurveName，PenProperty CurveStyle)CurveName：曲线名称。CurveStyle：曲线线条样式，Pen类型，是画面中用户自定义的Pen属性的属性名称。如下图矩形所示：图14-23

49、返回值说明：True -成功False -失败示例：TrendChart1.SetCurveLineStyle( “Curve1”, CustomProperty1);4. 设置曲线线条样式子属性bool SetCurveLineStyle1(string CurveName，PenProperty CurveStyle，int iSubPropertyType)CurveName：曲线名称。CurveStyle：曲线线条样式属性变量。Pen类型，是画面中用户自定义的Pen属性的属性名称（与SetCurveLineStyle中的CurveStyle意义相同）。iSubPropertyType：

50、0=设置所有的子属性，1=设置类型子属性，2=设置宽度子属性，3=设置起始箭头子属性，4=设置终止箭头子属性，5=设置拐点子属性，6=设置画刷子属性。返回值说明：True -成功False -失败注：iSubPropertyType为非0值时，只将曲线线条样式的某个子属性值修改为CurveStyle对应的子属性值，其它子属性保持原值不变。四、设置图例区属性1、设置图例区可见性，动态设置某图例区是否可见。SetLegendAreaVisible（String LegendAreaName，bool Visible）LegendAreaName：图例区的名称。Visible：图例区是否可见标志，True=图例区可见，False=图例区不可见。示例：TrendChart1.SetLegendAreaVisible(“Legend1”,True);2、设置图例区属性。SetLegendAre