组态王历史趋势曲线控件讲解

例程：历史趋势曲线控件的使用

组态王历史趋势曲线控件使用

配置参考文档

北京亚控科技发展有限公司

北京亚控科技发展有限公司 1

例程：历史趋势曲线控件的使用

技术部

目录

一、功能概述 ..................................................................... 3 一、功能概述 ..................................................................... 3 二、工程实例 ..................................................................... 3 三、操作步骤： ................................................................... 3

1、历史趋势曲线控件的特点： .................................................... 3 2、创建新的工程： .............................................................. 4 2.1) 定义设备： .................................................. 4 2.2) 定义变量： .................................................. 4 2.3) 创建趋势曲线： .............................................. 5 2.4) 添加曲线变量： .............................................. 5 3、切换到运行系统： ............................................................ 7 4、控件的属性、方法： .......................................................... 8 2.1) 控件的属性与方法： .......................................... 8 2.2) 属性方法的使用举例： ........................................ 14

四、注意事项 .....................................................................

19

图表

图一 定义变量压力 ............................................................ 4 图二 定义变量流量 ............................................................ 5 图三 记录和安全区属性 ........................................................ 6 图四 历史趋势曲线 ............................................................ 6 图五 历史趋势曲线 ............................................................ 7 图六 运行系统 ................................................................ 8 图七 画面属性 ................................................................ 15

北京亚控科技发展有限公司 2

例程：历史趋势曲线控件的使用

图八 画面命令语言编辑框 ...................................................... 16 图九 控件属性 ................................................................ 16 图十 画面命令语言 ............................................................ 17 图十一 运行画面 .............................................................. 17 图十一 控件方法的使用 ........................................................ 18 图十二 运行画面 .............................................................. 19

北京亚控科技发展有限公司 3

例程：历史趋势曲线控件的使用

一、功能概述

常规需求：很多工业现场都会要求显示采集量的趋势曲线 ,包括实时曲线、历史曲线。 组态王中的趋势曲线的实现方法：

1、 利用组态王的“工具箱”中的“实时曲线” 、“历史曲线”实现。 2、 利用组态王的“插入通用控件”中的“历史趋势曲线”实现。

第一种实现方法的优点在于可以进行 WEB 的发布，实现通过 IE 浏览器进行浏览。缺点 为支持的曲线笔比较少，许多功能的实现需要通过组态王的函数来实现，使用相对要麻烦。

第二种实现方法的优点在于支持同时绘制 16 条曲线，功能比较完善，可以在系统运行时 动态增加、删除、隐藏曲线，还可以修改曲线属性，实现无级缩放，曲线打印等等。许多功能 都不需要通过编写脚本的方法实现，使用比较方便。缺点在于无法进行 WEB 的发布。

二、工程实例

以一个简单的例程来说明“历史趋势曲线控件”的使用。

三、操作步骤：

1、历史趋势曲线控件的特点：

KVHTrend曲线控件是组态王以 Active X 控件形式提供的绘制历史曲线和 ODBC数据

库曲线的功能性工具。该曲线具有以下特点：

1． 即可以连接组态王的历史库，也可以通过

Access 、 SQLServer 等。

ODBC数据源连接到其它数据库上，如

2． 连接组态王历史库时， 可以定义查询数据的时间间隔， 如同在组态王中使用报表查询

历史数据时使用查询间隔一样。

3． 完全兼容了组态王原有历史曲线的功能。最多可同时绘制 16 条曲线。 4． 可以在系统运行时动态增加、删除、隐藏曲线。还可以修改曲线属性。 5． 曲线图表实现无级缩放。

6． 可实现某条曲线在某个时间段上的曲线比较。

7． 数值轴可以使用工程百分比标识，也可用曲线实际范围标识，二者之间自由切换。 8． 可直接打印图表曲线。

9． 可以自由选择曲线列表框中的显示内容。

北京亚控科技发展有限公司 4

例程：历史趋势曲线控件的使用

10．可以选择移动游标时是否显示曲线数值。 11．可以在曲线中显示报警区域的背景色

2、创建新的工程：

2.1) 定义设备：

新建一个工程，在设备处新建设备，我们在本例中定义一个仿真 PLC 的设备，设备列表 为“ PLC－亚控－仿真 PLC－串口” ，设备名称为“ PLC1”。此仿真 PLC 可以做为虚拟设备 与组态王进行通讯。仿真 PLC 主要有如下的寄存器：自动加 1 寄存器 INCREA ，自动减 1 寄 存器 DECREA ，随机寄存器 RADOM ，常量寄存器 STATIC ，常量字符串寄存器 STRING ，

CommErr 寄存器。具体的寄存器的使用请参考组态王 IO 驱动帮助。

2.2) 定义变量：

在数据词典中新建两个 IO 变量，变量名称分别为 压力、流量 ，变量类型为 IO 实数，连 接的设备为前面定义的仿真 PLC 设备“ PLC1 ”，寄存器分别为 INCREA100 ，DECREA100 ， 数据类型为 short，读写属性为“只读” 。这样压力变量就会从 0 开始自动加 1，其变化范围是

0到 100，流量变量从 100开始自动减 1，其变化范围是 0到 100。变量基本属性定义画面如下

图一、图二所示：

图一 定义变量压力

北京亚控科技发展有限公司 5

例程：历史趋势曲线控件的使用

图二 定义变量流量

在记录和安全区属性选项卡中我们定义压力和流量变量的数据记录属性， 如图三所示， 选 择“数据变化”记录，变化灵敏度设置为 0。

2.3) 创建趋势曲线：

在组态王开发系统中新建“趋势曲线”画面，在工具箱中单击“插入通用控件”或选择菜 单“编辑”下的“插入通用控件”命令，弹出“插入控件”对话框，在列表中选择“历史趋势 曲线”，单击“确定”按钮，对话框自动消失，鼠标箭头变为小“十”字型，在画面上选择控 件的左上角， 按下鼠标左键并拖动， 画面上显示出一个虚线的矩形框， 该矩形框为创建后的曲 线的外框。 当达到所需大小时， 松开鼠标左键， 则历史曲线控件创建成功， 画面上显示出该曲 线，如图四所示。双击趋势曲线，弹出“动画连接属性” ，控件名命名为“ HT”。点击确定完 成对历史趋势曲线的命名。

2.4) 添加曲线变量：

选中曲线控件点击右键，弹出菜单，选择“控件属性” ，弹出历史趋势曲线控件的属性对 话框，在“曲线”选项卡，点击“增加”按钮，选择变量“压力” ，选择“线类型” 、“线颜

色”，

点击“确定” 完成压力曲线的添加。 再点击“增加” 按钮，选择变量“流量” ，选择“线类

北京亚控科技发展有限公司 6

例程：历史趋势曲线控件的使用

型” 、

北京亚控科技发展有限公司 7

例程：历史趋势曲线控件的使用

图三 记录和安全区属性

图四 历史趋势曲线

“线颜色”，点击“确定”完成流量曲线的添加。 在趋势曲线控件属性的“坐标系”选项卡中对坐标系进行设置，我们设置 Y 轴的起始 值为 0，最大值为 100，不按照百分比绘制，而是按照实际

北京亚控科技发展有限公司 8

例程：历史趋势曲线控件的使用

值显示。设置时间轴的显示格式为 显示年、月、日、时、分、秒。

添加完成后开发画面如图五所示：

图五 历史趋势曲线

3、切换到运行系统：

保存画面后，在工程浏览器的“系统配置”－“设置运行系统”中进行“主画面配置” ， 将“历史曲线”画面设置为主画面。

然后切换到运行系统。运行如下图六所示： 趋势曲线控件自带的工具栏中提供了很多方便实用的控制按钮功能供用户来使用， 主要包 括：调整跨度设置按钮，设置 Y 轴标记，曲线图表无级缩放，打印曲线，定义新曲线，更新曲 线图表终止时间为当前时间，设置图表数值轴和时间轴参数，隐藏

/显示变量列表。

这些工具栏基本可以满足客户的使用了，如果还需要进一步的功能可以通过控件的属性、 方法来实现。下面我们简单的举例说明控件的属性、方法的使用。

北京亚控科技发展有限公司 9

例程：历史趋势曲线控件的使用

图六 运行系统

4、控件的属性、方法： 2.1) 控件的属性与方法：

属性及含义列表： 序号 名称 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 CurveUseKVHistData CruveDSN CurveTable CurveDateTimeField CurveInvalidColor CurveVarName CurveColor CurveLineType CurveTimeDelay CurveDrawType CurveAlmColor CurveHideCurve CurveMilliSecondField CurveDataField CuryeInvalidValue CurveUser CurvePwd CurveSavePwd CurveList CtrlBtn BorderColor BakColor DrawXYAxis AxisLineType AxisColor 数据类型 Bool String String String OLE COLOR String OLE COLOR Short String Short OLE COLOR Bool String String String String String Bool Bool Bool OLE COLOR OLE COLOR Bool Short OLE COLOR 含义 使用组态王历史数据 使用数据源名称 数据库的表名 数据库的时间字段名 数据库的无效值 连接变量名 曲线颜色 曲线线形 曲线比较时间差 曲线绘制方式 报警显示颜色 是否隐藏曲线 毫秒字段名称 数据字段名称 无效值字段名称 ODBC数据源用户名 ODBC数据源密码 ODBC是否保存密码 是否显示曲线列表 是否显示控制按钮 边界颜色 背景颜色 是否绘制坐标轴 坐标轴线型 坐标轴颜色

北京亚控科技发展有限公司 10

例程：历史趋势曲线控件的使用

26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 ShortDivLine MajXDivNum MinXDivNum MajYDivNum MinYDivNum MajXDivLineType MinXDivLineType MajYDivLineType MinYDivLineType MajXDivColor MinXDivColor MajXDivColor MinYDivColor YLabelNum YminVal YmaxVaL YLableFont XLabelNum Xwidth XLableFont XLabelFmtYear XlabelFmtMonth XlabelFmtDay XlabelFmtHour XlabelFmtMinute XlabelFmtSecond XlabelFmtMilliSecond XWidthUnit XLableColor YLableColor CurveNum AdjustWidth AdjustWidthUnit Percent YMinReal YMaxReal SampleInterval SampleIntervalMs PrintTitle XLVernierShow XRVernierShow XLabelFmtMicroSecond SampleUS bPrintTitle bPrintList YUNIT bHiHiAlarmArea HiHiAlarmAreaUp HiHiAlarmAreaDown bHiAlarmArea HiAlarmAreaUp HiAlarmAreaDown bLoAlarmArea LoAlarmAreaUp LoAlarmAreaDown bLoLoAlarmArea Bool Short Short Short Short Short Short Short Short OLE COLOR OLE COLOR OLE COLOR OLE COLOR Short Double Double IFontDisp Short Short IFontDisp Bool Bool Bool Bool Bool Bool Bool Short OLE COLOR OLE COLOR Long Long short Bool Double Double Long Long String Bool Bool Bool Bool Bool Bool String Bool Double Double Bool Double Double Bool Double Double Bool 分割线是否为短线 X轴主分割线数 X轴副分割线数 Y轴主分割线数 Y轴副分割线数 X轴主分割线线型 X轴副分割线线型 Y轴主分割线线型 Y轴副分割线线型 X轴主分割线颜色 X轴副分割线颜色 Y轴主分割线颜色 Y轴副分割线颜色 Y轴标记数 Y轴标记最小值 Y轴标记最大值 Y轴标记字体 X 轴标记数 X轴宽度 X轴标记字体 X 轴标记格式—是否显示年 X轴标记格式—是否显示月 X轴标记格式—是否显示日 X 轴标记格式—是否显示时 X轴标记格式—是否显示分 X轴标记格式—是否显示秒 X轴标记格式—是否显示毫秒 X轴宽度单位：秒、分、时、日 X轴标记颜色 Y轴标记颜色 返回当前曲线图表中的曲线数 目 时间轴调整宽度 时间轴调整宽度单位：秒、分、 时、日、毫秒 是否按百分比绘制 Y轴最小值 Y轴最大值 采样间隔 秒 采样间隔 毫秒 打印标题 是否显示左游标 是否显示右游标 X轴标记格式—是否显示微秒 是否微秒采样 是否打印标题 是否打印曲线列表 纵轴单位 是否显示高高限报警区 高高限报警区上边界位置 高高限报警区下边界位置 是否显示高限报警区 高限报警区上边界位置 高限报警区下边界位置 是否显示低限报警区 低限报警区上边界位置 低限报警区下边界位置 是否显示低低限报警区 北京亚控科技发展有限公司 11

例程：历史趋势曲线控件的使用

82 83 84 85 86 87 88 LoLoAlarmAreaUp LoLoAlarmAreaDown LVernierStr RVernierStr LVernierAppendStr RVernierAppendStr LShowVernierValType RShowVernierValType 90 91 92 bPrintSubTitle PrintSubTitle SubTitlePos Short Bool String Short Double Double String String Bool Bool Short 低低限报警区上边界位置 低低限报警区下边界位置 左游标附加信息 右游标附加信息 左游标是否显示附加信息 右游标是否显示附加信息 左游标数值显示方式 0. 不显时数值 1. 一直显示数值 2. 移动游标时显示数值 右游标数值显示方式 0． 不显时数值 1． 一直显示数值 2. 移动游标时显示数值 是否打印子标题 打印子标题 子标题位置 控件方法说明：

1. Void ChangeCurveVarName(long 1Index,BSTR 1pszNewValue); 功能：改变历史曲线所

连接的变量，该变量数据来自组态王历史库。 参数： 1Index ：曲线索引号

1pszNewValue ：变量名

2. Void ChangeCurveVarNameForODBC(LONG lIndex,STRING szNewName,STRING

szDSN,STRING szUser,STRING szPwd,STRING szTable,STRING

szDateTimeField,STRING szMilliSecondField,STRING szDataField,STRING szInvalidValue) ;

功能：改变历史曲线所连接的变量，该变量数据来自 ODBC数据源。 参数： lIndex ：曲线索引号

szNewName ：所连接变量 szDSN ：使用的数据源名 szUser ：用户名 szPwd ：密码

szTable ：数据库的表名

szDateTimeField ：表中对应的时间字段 szMilliSecondField ：表中对应的毫秒字段 szDataField ：表中对应的数据字段

szInvalidValue ：表中对应的无效值

3. String HTGetTimeStringAtScooter(short nScootNum,String szFormat); 功能：取

得指定指示器处的时间，该时间为字符串格式 参数： nScootNum：指示器索引， 1—左、 2 —右

北京亚控科技发展有限公司 12

例程：历史趋势曲线控件的使用

szFormat ：指定所需要的时间字符串格式，可为下列之一：

“Date ”：以 Windows控制面板相同格式显示日期

“ Time”：以 Windows 控制面板相同格式显示时间 “ DateTime ”：以

Windows控制面板相同格式显示日期时间 返回值：字符串型日期时间值

4. Float HTGetPenRealValue(short nPenNum,String szContent); 功能：取得指定曲线

Y 轴(数值轴)起点或终点的实际值 参数： nPenNum：曲线索引， 1～ 16

szContent ：指定所需要类型，可为下列之一： “Start ”：将 Y 轴下限值的工程百

分比转换为实际值 “End”：将 Y 轴上限值的工程百分比转换为实际值 “ Valid ”：判断取得的值是否有效， 0—无效， 1—有效 返回值：工程百分比对应的实际值

5. Float HTGetValue(short nPenNum,String szValType); 功能：取得指定曲线整个图表

上(当前可见部分)的最大

参数： nPenNum：曲线索引， 1～ 16

/ 最小/ 平均值

szValType ：指定所需要的计算类型，可为下列之一：

“ AverageValue ”：整个趋势的平均值 “ MaxValue ”：整个趋势的最大值 “ MinValue ”：整个趋势的最小值

“ Valid ”：判断取得的值是否有效， 0—无效， 1—有效 返回值：曲线整

个图表上(当前可见部分)的最大 /最小/ 平均值

6. Float HTGetValueAtScooter(short nPenNum,short nScootNum,String

szValType); 功能：取得指定曲线在指示器位置处所要求的值 参数： nPenNum：曲线索

引， 1～ 16

nScootNum ：指示器索引， 1—左、 2 —右 szValType ：指定所需要类型，可为下列之一：

“Value ”：取得指示器处的值

“ Valid ”：判断取得的值是否有效， 0—无效， 1—有效 返回值：指定曲线在

指定指示器处的值

7. Float HTGetValueAtZone(short nPenNum,String szValType); 功能：取得指定曲线

在左右指示器之间的的最大

参数： nPenNum：曲线索引， 1～ 16

/ 最小/ 平均值

szValType ：指定所需要的计算类型，可为下列之一：

北京亚控科技发展有限公司 13

例程：历史趋势曲线控件的使用

“ AverageValue ”：平均值 “ MaxValue ”：最大值 “ MinValue ”：最小值

“ Valid ”：判断取得的值是否有效， 0—无效， 1—有效 返回值：指定曲线在

左右指示器之间的的最大 / 最小 / 平均值

8. Void HTScrollLeft();

功能：将曲线的起始时间左移一个调整跨度 参数：无 返回值：无

9. Void HTScrollRight();

功能：将曲线的起始时间右移一个调整跨度 参数：无 返回值：无

10. Void HTUpdateToCurrentTime(); 功能：将曲线的终止时间设为当前时间 参数：无 返回

值：无

11. Void HTSetLeftScooterTime(Long lTime ， short sMilliSecond);

功能：设置曲线时间坐标起点 参数： lTime ：时间的年月日时分秒部分，将该时间用

HTConvertTime ()函数转换 为自 1970 年 1 月 1 日 0 时到指定时间的秒数

sMilliSecond ：时间的毫秒部分

返回值：无

12. Void HTZoomIn(string szLookString); 功能：通过增大时间轴和数值轴长度，使曲

线图表缩小 参数： szLookString ：缩放类型，可为下列之一： “ StartTime ”：保持起始时间与缩放前相等 “EndTime”：保持终止时间与缩放前相等

“ Center ”：保持中心时间与缩放前相等 返回值：无

13. Void HTZoomOut(string szLookString); 功能：通过缩短时间轴和数值轴长度，使

曲线图表放大 参数： szLookString ：缩放类型，可为下列之一： “ StartTime ”：保持起始时间与缩放前相等 “EndTime”：保持终止时间与缩放前相等 “ Center ”：保持中心时间与缩放前相等 返回值：无

14. Void SetTimeParam(long lStartTime, short sStartms, long lXWidth,

short sXWidthUnit) 功能：设置历史曲线时间坐标起点、时间轴长度 参数：

北京亚控科技发展有限公司 14

例程：历史趋势曲线控件的使用

lStartTime 时间年月日时分秒部分

sStartms 时间的毫秒部分 lXWidth 时间轴长度 sXWithUnit 时间轴长度单

位： 0-秒 1- 分 2- 时 3- 日 4- 毫秒 返回值：无

注：组态王 6.5 第二版， sXWithUnit 必须为 0，即秒， lXWidth 为转换为秒后的

时 间长度。

15. void SetTimeParamDivided(long sStartYear, long sStartMonth, long sStartDay, long sStartHour, long sStartMinute, long sStartSecond, long sStartms, long lXWidth, long sXWidthUnit) 功能：设置历史曲线时间坐标起点、时

间轴长度 , 可以直接输入时间参数 , 与 SetTimeParam 实现的功能相同 .

参数： sStartYear 时间的年

sStartMonth 时间的月 sStartDay sStartHour sStartMinute

sStartSecond sStartms lXWidth

返回值：无

时间的日 时间的时 时间的分 时间的秒 时间的毫秒 时间轴长度

sXWidthUnit 时间轴长度单位： 0- 秒

16. void SetTimeParamString(STRING strStartTime, STRING strEndTime) 功能：

设置历史曲线时间坐标起点、终点 , 可以直接输入以字符串形式表示的时间参 数

参数： strStartTime 开始时间字符串 strEndTime 结束时间字符串 例： m 为历史曲线控件名称，定义按钮弹起时：

m. SetTimeParamString(\"2004 年 9 月 20 日 13 时 0 分 0 秒 1 毫 秒\年 9 月 20日 15 时 20分 2 秒 999 毫秒 \") 设置时间轴范围

为 :2004-9-20 13:00:00:001

～2004-9-20 15:20:02:999;

17. ShowCurve(LONG lIndex,BOOL bShow) 功能：显示或隐藏指定的曲线 参数： lIndex 曲线索引， 1～ 16 bShow 取 1 显示曲线 , 取 0 隐藏曲线

18. void PrintCurve() 功能：打印，与控件打印按钮实现相同功能 参数：无 返回值：无

北京亚控科技发展有限公司 15

例程：历史趋势曲线控件的使用

2.2) 属性方法的使用举例：

属性举例： 我们举一个简单的例程来说明控件属性的使用： CtrlBtn ，是否显示控制按钮。

Bool 类型， 1：显示控制按钮， 0：隐藏控制按钮。 CurveList ：是否显示曲线列表。 Bool

类型，

1：显示曲线列表， 0：隐藏曲线列表。 假设我们不想让客户利用趋势曲线控件自带的工具栏来

实现相应的操作， 并且也不显示曲线列表。 则可以隐含此工具栏并隐藏曲线列表， 利用 CtrlBtn 属性、 CurveList 属性来实现。

在“历史曲线”画面空白处点击右键，弹出菜单，选择“画面属性” ，弹出七所示：

图七 画面属性

点击“命令语言”按钮，进入画面属性命令语言编辑画面，我们在画面“显示时”编写 脚本程序， 点击“控件” 按钮，如下图八所示， 弹出控件选择对话框， 在控件选择对话框的 “控 件名称”处选择我们前面定义的历史曲线控件名称“ HT ”，然后在“查看类型”中选择“控件 属性”，则此控件的所有的属性都会列出，我们可以选择需要的控件属性。如图九所示，选择 “ CtrlBtn ”属性。点击“确定” ，则画面命令语言编辑框中出现我们所选择的控件的属性。我 们对此属性进行赋值如下：

HT.CtrlBtn=0;

同样的方法选择 CurveList 属性，对此属性进行赋值如下：

HT.CurveList= 0;

北京亚控科技发展有限公司 16

例程：历史趋势曲线控件的使用

编辑完成的画面命令语言如图十所示： 编辑完成后点击“确定”完成画面属性命令语言的编辑。然后保存“历史曲线”画面进 入运行系统，如图十一所示，可以发现工具栏与曲线列表都隐藏了。

北京亚控科技发展有限公司 17

例程：历史趋势曲线控件的使用

图八 画面命令语言编辑框

图九 控件属性

北京亚控科技发展有限公司 18

例程：历史趋势曲线控件的使用

图十 画面命令语言

图十一 运行画面

方法举例： 因为此控件功能相对比较强大，因此有些客户希望此历史曲线控件能够作为 实

北京亚控科技发展有限公司 19

例程：历史趋势曲线控件的使用

时曲线来实现，下面我们就利用此控件的方法来实现。控件方法如下：

Void HTUpdateToCurrentTime();

功能：将曲线的终止时间设为当前时间

我们还是在画面命令语言中进行编辑，这次使用画面命令语言的存在时，点击“控件” 按钮， 弹出控件选择对话框， 在控件选择对话框的 “控件名称” 处选择我们前面定义的历史曲 线控件名称“ HT ”，然后在“查看类型”中选择“控件方法” ，则此控件的所有的方法都会列 出，我们可以选择需要的控件方法 HTUpdateToCurrentTime 。如图十一所示：

编辑脚本如下：

HT.HTUpdateToCurrentTime();

图十一 控件方法的使用

点击“确定”完成画面命令语言的脚本编辑。保存“历史曲线”画面。然后切换到运行

北京亚控科技发展有限公司 20

例程：历史趋势曲线控件的使用

系统。画面如图十二所示：

图十二 运行画面

四、注意事项

1．变量定义时必须定义为记录，如果定义为“不记录”则无法看到历史曲线。 2．在控件使用时

需要注意 Y 轴坐标的设置要合理。

4．详细的控件的属性、方法的使用请参考帮助或者手册。

5． 本 演示 工 程 针 对 组 态 王 6.52 四 月 份的 版 本 ， 在 此 之 前 的 版 本 CtrlBtn 属 性 与 HTUpdateToCurrentTime 方法有冲突， 会在进入运行系统时崩溃， 如果

是以前版本建议不要同 时使用。

5．本演示工程只是历史趋势曲线控件的简单的使用例程，更深一步的学习使用请参考组态王 使用

手册以及函数手册，或者参加组态王培训班。如有问题请致电亚控公司技术部。 。

北京亚控科技发展有限公司 21