KingSCADA趋势曲线

趋势曲线应用例程说明文档此文档由北京亚控公司提供，仅作为KingSCADA3.0趋势曲线应用的使用参考，其中涉及内容的详细说明请参考KingSCADA3.0的使用说明或咨询技术支持工程师。

目录1. 概述 (1)2. 例程 (1)2.1 定义变量 (1)2.2 创建趋势曲线 (3)2.3 趋势曲线设置 (4)2.4 趋势曲线的功能实现 (13)3. 注意事项 (26)1. 概述趋势曲线实现了以曲线的形式显示模拟量的数值变化趋势的功能，KingSCADA3.0的趋势曲线不仅具有多绘图区、多数据轴、多时间轴，并且能够进行实时趋势曲线和历史趋势曲线在线转换，可以方便用户进行个性化趋势曲线的查询、对比以及分析。

再加上丰富的控制函数和控制脚本，使趋势曲线的查询显得更加灵活、方便。

下面将通过一个例程来介绍趋势曲线的简单应用。

2. 例程趋势曲线是用来反应变量随时间的变化情况，趋势曲线有两种：实时趋势曲线和历史趋势曲线。

KingSCADA3.0提供的趋势曲线控件既可以显示实时趋势曲线又可以显示某一时间段的历史趋势曲线，并且提供了丰富的控件方法和控件事件，使趋势曲线的查询显得更加灵活、方便。

2.1定义变量本工程中我们要在趋势曲线内绘制4个变量的曲线，因此先在数据词典里定义这四个变量。

●变量名：temp●变量类型：基本变量●数据类型：Mem Float●变量描述：温度●初始值：0●灵敏度：0●最小值：-40●最大值：100●保存数值：选中●变量名：liquid_level●变量类型：基本变量●数据类型：Mem Float●变量描述：液位●初始值：0●灵敏度：0●最小值：-20●最大值：100●保存数值：选中●变量名：pressure●变量类型：基本变量●数据类型：Mem Float●变量描述：压力●初始值：0●灵敏度：0●最小值：0●最大值：5●保存数值：选中●变量名：flow●变量类型：基本变量●数据类型：Mem Float●变量描述：流量●初始值：0●灵敏度：0●最小值：0●最大值：150●保存数值：选中我们在“脚本”-“自定义脚本”-“数据变换脚本”里新建一个脚本，用来模拟上述变量的数值变化。

以系统变量\\local\$Second为条件。

\\local\temp=\\local\temp+0.25;if (\\local\temp>=100)\\local\temp=-40;\\local\pressure=\\local\pressure+0.1;if (\\local\pressure>=5)\\local\pressure=0;\\local\liquid_level=\\local\liquid_level+0.5;if (\\local\liquid_level>=100)\\local\liquid_level=-20;\\local\flow=\\local\flow+0.78;if (\\local\flow>=150)\\local\flow=0;2.2创建趋势曲线在KingSCADA3.0图形开发系统中打开任一画面，单击“对象”菜单→“扩展”→“趋势曲线”命令或直接单击工具箱中的图标→鼠标移到画面中，光标呈‘+’状，按住鼠标左键并拖动即可生成趋势曲线窗口，如图1所示。

图1 趋势曲线2.3趋势曲线设置2.3.1趋势曲线属性趋势曲线具有多绘图区、多数据轴、多时间轴的功能，下面我们用两个绘图区分别显示两条曲线。

在画面中选择趋势曲线，右侧会弹出控件属性对话框，如图2所示：图1 趋势曲线属性趋势曲线的名称默认为“TrendChart1”，把“ChartAreaCount”“和TimeAxisCount”属性的值设置为2（如图3所示），即把趋势曲线划分为2个绘图区，时间轴增加到2个。

图3 趋势曲线属性2.3.2趋势曲线标题区选中趋势曲线窗口→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→单击标题区，弹出标题区属性对话框，如图4、5所示：图4 趋势曲线右键菜单图5 标题区及属性通过“Text”属性我们可以设置标题区对象的名称，如把默认的“趋势曲线”改为“Multi-Area Trend”。

2.3.3绘图区属性选中趋势曲线控件→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→单击上面第一绘图区“ChartArea1”，如图6所示：图6 绘图区及属性在绘图区属性对话框中，我们可以在添加一个Y轴，即把“YaxisCount”设置为2，如图7所示：图7 绘图区属性2.3.4曲线属性选中趋势曲线窗口→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→在上面第一个绘图区内单击曲线，修改曲线属性，如图8所示：图8 Curve1曲线属性XAxis：选择TimeAxis1。

YAxis：选择DataAxis1。

DataSource：选择变量temp。

在下面第二个绘图区内单击曲线，修改曲线属性，如图9所示：图9 Curve2曲线属性XAxis：选择TimeAxis2。

YAxis：选择DataAxis2。

DataSource：选择变量pressure。

2.3.5网格区属性选中趋势曲线控件→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→在绘图区内单击网格区，如图10所示：图10 网格区修改连个绘图区的网格区属性，如图11所示：图11 网格区属性Background：设置绘图区的背景颜色。

MajorGridColumns：设置主网格线显示的列数为0，ShowMajorGrid属性为True 时有效MajorGridRows：设置主网格线显示的行数为0，ShowMajorGrid主网格属性为True时有效2.3.6数据轴属性选中趋势曲线窗口→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→单击数据轴（如图12所示），数据轴选中后可以通过鼠标拖放，例如上面第一绘图区“ChartArea1”我们设置了两个Y轴，分别是“DataAxis1”和“DataAxis4”，在2.2.4的部分，我们把变量“temp”关联到“DataAxis1”，那么Y轴“DataAxis1”的属性设置如图13所示。

图12 数据轴图13 数据轴属性ShowType：设置数据轴显示数据的方式为实际值显示。

LableText Color：设置标记文本显示的颜色为红色，“ShowLabel”属性为True时有效。

MinValue：设置数据轴的显示最小值为-40，变量“tepm”的最小值。

MaxValue：设置数据轴的显示最大值为100，变量“tepm”的最大值其他Y轴设置与此类似。

2.3.7时间轴2.3.8时间轴属性选中趋势曲线窗口→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→单击时间轴，如图所示：图14 时间轴时间轴TimeAxis1属性对话框，如图15所示：图15 时间轴属性2.3.9游标属性选中趋势曲线窗口→单击鼠标右键→在弹出的右键菜单中执行“编辑”命令→选中游标对象，即可通过拖曳游标查看趋势曲线某一具体时刻的数值及其它信息。

游标属性对话框，如图16所示：图16 游标属性ShowVarName：运行环境中拖曳游标时，在游标和曲线焦点的信息中是否显示曲线对象的名称，设置为True。

ShowValue：运行环境中拖曳游标时，在游标和曲线焦点的信息中是否显示曲线的数值，设置为True。

ShowTime：运行环境中拖曳游标时，在游标和曲线焦点的信息中是否显示曲线的时间，设置为True。

ShowCursorName：运行环境中拖曳游标时，在游标和曲线焦点的信息中是否显示游标对象的名称，设置为True。

MultiLine：运行环境中拖曳游标时，在游标和曲线焦点的信息是否以多行的形式显示，，设置为True。

LabelPosition：设置游标和曲线焦点信息显示的位置：跟随曲线。

LabelShowType：设置游标和曲线焦点信息显示的方式：总显示。

LineColor：设置游标杆的颜色，四个游标分别设置为不同的颜色。

至此，趋势曲线的基本设置就完成了。

2.4趋势曲线的功能实现以上是开发环境下的趋势曲线设置，在运行环境下要想查询、打印曲线必须通过KingSCADA3.0提供的控件方法来实现，下面具体介绍方法的使用。

2.4.1曲线实时模式、历史模式的切换打开精灵图，选择“Button”-“Buttons-Diamond”-“RedRound”按钮（如图17所示），确定后添加到画面上，用复制的方法再添加一个这样的按钮。

图17 选择精灵图按钮选择“工具箱”-“基本”-“文本”，添加两个文本，文本的属性如下：图18 文本属性Name ：分别设置为“Text9”和“Text10”。

Text ：分别设置为“RealTimeMode ”和“HistoryMode ”。

TextBrush ：设置为白色。

为了使画面更美观，我们在数据词典里新建一个内存离散变量“RealorHist ”，双击文本，定义文本的动画连接，如下图19、20所示。

当变量“RealorHist ”的值为true 时，文本“Text9”进行闪烁。

当变量“RealorHist ”的值为false 时，文本“Text10”进行闪烁。

图19 文本动画连接图20 文本动画连接将文本“Text9”和按钮“PictureWrap7”组合成一个组“Group35”，文本“Text10”和按钮“PictureWrap8”组合成一个组“Group36”，选择“Group35”添加连接“鼠标”－“左键按下”，脚本如下：TrendChart1.HistToReal(1000);RealorHist=true;选择“Group36”添加连接“鼠标”－“左键按下”，脚本如下：TrendChart1.RealToHist();RealorHist=false;即，当按下“Group35”按钮后，趋势曲线是实时趋势曲线，当按下“Group36”按钮后，趋势曲线是历史趋势曲线，同时按钮上的文本进行闪烁。

2.4.2曲线添加、修改、删除首先，我们用一个组合框控件显示趋势曲线里的曲线名称。

在画面上添加“组合框”UI控件，单击“Items”属性后面的，在弹出的“组合项集合”对话框中添加趋势曲线的曲线名称“Curve1”和“Curve2”，如图21所示。

图21 组合框添加曲线名称添加组合框的下拉列表选项改变时触发事件：OnSelectedIndexChange(int oldItemIndex, int newItemIndex);选中画面上“组合框”控件→单击“连接”窗口中的图标→在弹出的菜单中执行“ComboBox”→“OnSelectedIndexChange”命令，弹出对话框，写如下本。