KVHTrend控件使用方法-精品文档资料.doc

KVHTrend控件使用办法KVHTrend曲线控件是组态王以ActiveX控件形式提供的绘制历史曲线和ODBC数据库曲线的功能性工具。通过该控件，不但可以实现历史曲线的绘制，还可以实现ODBC数据库中数据记录的曲线绘制，而且在运行状态下，可以实现在线动态增加/删除曲线、曲线图表的无级缩放、曲线的动态比较、.曲线的打印等。该曲线控件最多可以绘制16条曲线。1、创建历史曲线控件：在组态王开发系统中新建画面，在工具箱中单击“插入通用控件或者选择菜单“编辑下的“插入通用控件命令，弹出“插入控件对话框，在列表中选择“历史趋势曲线，单击“确定按钮，对话框自动消失，鼠标箭头变为小“十字型，在画面上选择控件的左上角，按下鼠标左键并拖动，画面上显示出一个虚线的矩形框，该矩形框为创建后的曲线的外框。当达到所需大小时，松开鼠标左键，则历史曲线控件创建成功，画面上显示出该曲线，如图1所示。图1历史曲线控件2、设置控件固有属性：控件创建完成后，在控件上单击右键，在弹出的快捷菜单中选择“控件属性命令，弹出历史曲线控件的固有属性对话框，如图2所示。控件固有属性含有两个属性页：曲线、坐标系。下面详细介绍每个属性页中的含义。2、1曲线属性页如图2所示，曲线属性页中下半部分为定义在绘制曲线时，历史数据的来源，可以选择组态王的历史数据库或者其它数据库为数据源。曲线属性页中上半部分“曲线是定义曲线图表初始状态的曲线变量、绘制曲线的方式、是否进行曲线比较等：Ø 列表框：显示已经添加的变量的名称及绘制方式定义等。Ø “增加按钮：增加变量到曲线图表，并定义曲线绘制方式。单击该按钮，弹出如图3所示的对话框。图2历史曲线控件固有属性图3增加曲线l 变量名称：在“变量名称文本框中输入要添加的变量的名称，或者在左侧的列表框中选择，该列表框中列出了本工程中所有定义了历史记录属性的变量，单击鼠标选择，则选中的变量名称自动添加到“变量名称文本框中。l 曲线定义：线类型：单击“线类型后的下拉列表框，选择当前选择的变量绘制曲线时的线的类型。线颜色：单击“线颜色后的按钮，在弹出的调色板中选择绘制的曲线的颜色。绘制方式：曲线的绘制方式有四种：模拟、阶梯、逻辑、棒图，可以任选一种。隐藏曲线：是否在绘制曲线时初始设置隐藏当前绘制的曲线。l 曲线比较：通过设置曲线比较时间差，使曲线绘制位置有一个时间轴上的平移，这样通过关联的变量名相同，但一个是显示与时间轴相同的时间的数据，另一个作比较的曲线显示与时间轴的时间差为某个值的数据（如一天前），从而达到用两条曲线来实现了曲线比较的目的。l 数据来源：选择曲线使用的数据来源，可同时支持组态王历史库和ODBC数据源。若选择ODBC数据源，必须先配置数据源.具体配置办法如下：1、 启动控制面板中的数据源ODBC。单击“系统DSN项。单击“增加，弹出“创建新数据源对话框。2、 选择所需数据源的驱动如“MicrosoftAccressDriver(*.mdb)，单击“完成按钮。弹出“ODBCMicrosoftAccress安装对话框。3、 在“数据源名中定义一个数据源名称，数据库“选择中选择曲线数据所在的数据库，此数据库的表至少有三个字段：时间字段、数据字段、毫秒字段。单击“确定，新创建的数据源就添加到“系统DSN列表中。数据源：选择曲线使用的数据库，在弹出的“SelectDataSource中选择上面定义的数据源。表名称：选择曲线使用的数据来自所选数据库的某一个表时间字段：选择曲线数据对应的时间记录，日期/时间类型数据字段：选择曲线对应的数据值，长整型或者浮点型毫秒字段：选择曲线数据对应的毫秒记录，数字类型无效值：每一条曲线都和表中一个表示其值的字段关联，这个字段的值在某一时点可能是无效的，但表的结构决定了这个字段在一条记录中的值不能为空白，所以就有了无效值的定义。比如：1）当表中数值字段的值为NULL时表示该点数据无效，那么配置无效值时就可以空。2）当表中数值字段的值为0时表示该点数据无效，那么配置无效值时就可以写0。3）当表中数值字段的值为“abcd时表示该点数据无效，那么配置无效值时就可以写“abcd。选择完变量并配置完成后，单击“确定，则曲线名称添加到“曲线列表中。如图4所示：图4增加变量到曲线列表如上所述，可以增加多个变量到曲线列表中。Ø “删除按钮：删除当前列表框中选中的曲线定义。Ø “修改：修改当前列表框中选中的曲线定义。Ø “显示列表选项：是否显示如图1中的曲线变量列表。Ø 数据源：显示曲线使用数据源的信息。2.2坐标系属性页如图2，单击“坐标系标签，进入坐标系属性设置页，如图5所示。图5坐标系属性页Ø 边框颜色和背景颜色：设置曲线图表的边框颜色和图表背景颜色。单击相应按钮，弹出浮动调色板，选择所需颜色。Ø 绘制坐标轴选项：是否在图表上绘制坐标轴。单击“轴线类型列表框选择坐标轴线的线型；单击“轴线颜色按钮，选择坐标轴线的颜色。绘制出的坐标轴为带箭头的表示X、Y方向的直线。Ø “分割线定义：定义时间轴、数值轴主次分割线的数目、线的类型、线的颜色等。如果选择了分割线“为短线，则定义的主分割线变为坐标轴上的短线，曲线图表不再是被分割线分割的网壮结构，如图6所示。此时，次分割线不再起作用，其选项也变为灰色无效。图6分割线与分割线为短线Ø 标记数值（Y）轴：“标记数目编辑框中定义数值轴上的标记的个数，“最小值、“最大值编辑框定义初始显示的值的百分比范围（0100%）。单击“字体按钮，弹出字体、字型、字号选择对话框，选择数值轴标记的字体及颜色等。Ø 标记时间（X）轴：“标记数目编辑框中定义时间轴上的标记的个数。通过选择“格式或者的选项，选择时间轴显示的时间的格式及内容。“时间长度编辑框定义初始显示时图表所显示的时间段的长度。单击“字体按钮，弹出字体、字型、字号选择对话框，选择数值轴标记的字体及颜色等。所有项定义完成后，单击“确定返回。3、设置控件的动画连接属性以上所述为设置控件的固有属性，要在组态王中使用该控件，还需设置控件的动画连接属性。用鼠标选中并双击该控件，弹出“动画连接属性设置对话框，如图7所示。图7设置控件动画连接属性动画连接属性共有3个属性页，下面一一介绍：“常规属性页：如图7所示。Ø 控件名：定义该控件在组态王中的标识名，如“历史曲线，该标识名在组态王当前工程中应该唯一。Ø 优先级、安全区：定义控件的安全性，单击“安全区选择按钮选择所需安全区。“属性属性页：如图8所示。图8“属性属性页定义控件的属性与组态王的变量的关联。“事件属性页：如图9所示。图9事件属性页定义控件的事件函数。以上控件的各个动画连接属性的定义请参见（组态王6.0使用手册）第十五章“控件。这里不在详细描述。4、控件属性、办法列表4.1控件属性列表序号名称数据类型含义1CurveUseKVHistDataLong使用组态王历史数据2CruveDSNLong使用数据源名称3CurveTableLong数据库的表名4CurveDateTimeFieldLong数据库的时间字段名5CurveInvalidColorLong数据库的无效值6CurveVarNameLong连接变量名7CurveColorLong曲线颜色8CurveLineTypeLong曲线线形9CurveTimeDelayLong曲线比较10CurveDrawTypeLong曲线绘制方式11CurveAlmColorLong报警显示颜色12CurveHideCurveLong是否隐藏曲线13CurveMilliSecondFieldLong毫秒字段14CurveDataFieldLong数据字段15CuryeInvalidValueLong无效值字段16CurveUserLong用户名17CurvePwdLong密码18CurveSavePwdLong确认密码19CurveListBool是否显示曲线列表20CtrlBtnBool是否显示控制按钮21BorderColorOLE_COLOR边界颜色22BakColorOLE_COLOR背景颜色23DrawXYAxisBool是否绘制坐标轴24AxisLineTypeLong坐标轴线型25AxisColorOLE_COLOR坐标轴颜色26ShortDivLineBool分割线是否为短线27MajXDivNumLongX轴主分割线数28MinXDivNumLongX轴副分割线数29MajYDivNumLongY轴主分割线数30MinYDivNumLongY轴副分割线数31MajXDivLineTypeLongX轴主分割线线型32MinXDivLineTypeLongX轴副分割线线型33MajYDivLineTypeLongY轴主分割线线型34MinYDivLineTypeLongY轴副分割线线型35MajXDivColorOLE_COLORX轴主分割线颜色36MinXDivColorOLE_COLORX轴副分割线颜色37MajXDivColorOLE_COLORY轴主分割线颜色38MinYDivColorOLE_COLORY轴副分割线颜色39YLabelNumLongY轴标记数40YMinValFloatY轴标记最小值41YMaxVaLFloatY轴标记最大值42YLableFontIFontDispY轴标记字体43XLabelNumLongX轴标记数44XWidthLongX轴宽度45XLableFontIFontDispX轴标记字体46XLabelFmtYearBoolX轴标记格式是否显示年47XlabelFmtMonthBoolX轴标记格式是否显示月48XlabelFmtDayBoolX轴标记格式是否显示日49XlabelFmtHourBoolX轴标记格式是否显示时50XlabelFmtMinuteBoolX轴标记格式是否显示分51XlabelFmtSecondBoolX轴标记格式是否显示秒52XlabelFmtMilliSecondBoolX轴标记格式是否显示毫秒53XWidthUnitLongX轴宽度单位：秒、分、时、日54XLableColorOLE_COLORX轴标记颜色55YLableColorOLE_COLORY轴标记颜色56CurveNumLong返回当前曲线图表中的曲线数目57AdjustWidthLong时间轴调整宽度58AdjustWidthUnitLong时间轴调整宽度单位：秒、分、时、日、毫秒注：以上属性中除CurveNum为只读型外，其它属性均为可读写类型。4.2控件办法列表1、 VoidCurveVarName(long1Index,BSTR1pszNewValue);Ø 功能：改变历史曲线所连接的变量Ø 参数：1Index：曲线索引号1pszNewValue：变量名Ø 举例：定义变量V1，m为历史曲线控件名称，定义按钮弹起时m.ChangeCurveVarName(1,"本站点v1");把第一条曲线连接的变量改成V1。2、 VoidChangeCurveVarNameForODBC(LONGlIndex,STRINGszNewName,STRINGszDSN,STRINGszUser,STRINGszPwd,STRINGszTable,STRINGszDateTimeField,STRINGszMilliSecondField,STRINGszDataField,STRINGszInvalidValue);Ø 功能：改变历史曲线所连接的变量Ø 参数：lIndex：曲线索引号szNewName：所连接变量szDSN：使用的数据源名szUser：用户名szPwd：密码szTable：数据库的表名szDateTimeField：表中对应的时间字段szMilliSecondField：表中对应的毫秒字段szDataField：表中对应的数据字段szInvalidValue：表中对应的无效值Ø 举例：定义变量V2，m为历史曲线控件名称，定义按钮弹起时m.ChangeCurveVarNameForODBC(2,"本站点v2","ocx","市场","abcd","milli","date","ms","data",);把第二条曲线连接的变量改成V2。3、 StringHTGetTimeStringAtScooter(shortnScootNum,StringszFormat);Ø 功能：取得指定指示器处字符串格式的时间Ø 参数：nScootNum：指示器索引，1左、2右szFormat：指定所需要的时间字符串格式，可为下列之一：“Date：以Windows控制面板相同格式显示日期“Time：以Windows控制面板相同格式显示时间“DateTime：以Windows控制面板相同格式显示日期时间Ø 返回值：字符串型日期时间值Ø 举例：定义DatTim为字符串型变量，取得当前左指示器的日期时间字符串DatTim=HTGetTimeStringAtScooter(1,DateTime);2、FloatHTGetPenRealValue(shortnPenNum,StringszContent);Ø 功能：取得指定曲线Y轴（数值轴）起点或者终点的实际值Ø 参数：nPenNum：曲线索引，116szContent：指定所需要类型，可为下列之一：“Start：将下限值的工程白分比转换为实际值“End：将上限值的工程白分比转换为实际值“Valid：判断取得的值是否有效，0无效，1有效Ø 返回值：工程百分比对应的实际值Ø 举例：定义PenVal实数型变量，取得第一条曲线当前下限值的实际值PenVal=HTGetPenRealValue(1,Start);3、FloatHTGetValue(shortnPenNum,StringszValType);Ø 功能：取得指定曲线整个图表上（当前可见部分）的最大/最小/平均值Ø 参数：nPenNum：曲线索引，116szValType：指定所需要类型，可为下列之一：“AverageValue：整个趋势的平均值“MaxValue：整个趋势的最大值“MinValue：整个趋势的最小值“Valid：判断取得的值是否有效，0无效，1有效Ø 返回值：曲线整个图表上（当前可见部分）的最大/最小/平均值Ø 举例：定义PenVal实数型变量，取得第一条曲线在整个图表上的最大值PenVal=HTGetValue(1,MaxValue);4、FloatHTGetValueAtScooter(shortnPenNum,shortnScootNum,StringszValType);Ø 功能：取得指定曲线在指示器位置处所要求的值Ø 参数：nPenNum：曲线索引，116nScootNum：指示器索引，1左、2右szValType：指定所需要类型，可为下列之一：“Value：取得指示器处的值“Valid：判断取得的值是否有效，0无效，1有效Ø 返回值：指定曲线在指定指示器处的值Ø 举例：定义PenVal实数型变量，取得第一条曲线在右指示器处的值PenVal=HTGetValueAtScooter(1,，2，Value);5、FloatHTGetValueAtZone(shortnPenNum,StringszValType);Ø 功能：取得指定曲线在左右指示器之间的的最大/最小/平均值Ø 参数：nPenNum：曲线索引，116szValType：指定所需要类型，可为下列之一：“AverageValue：平均值“MaxValue：最大值“MinValue：最小值“Valid：判断取得的值是否有效，0无效，1有效Ø 返回值：指定曲线在左右指示器之间的的最大/最小/平均值Ø 举例：定义PenVal实数型变量，取得第一条曲线的最大值PenVal=HTGetValueAtZone(1,MaxValue);6、VoidHTScrollLeft();Ø 功能：将曲线的起始时间左移一个调整跨度Ø 参数：无Ø 返回值：无7、VoidHTScrollRight();Ø 功能：将曲线的起始时间右移一个调整跨度Ø 参数：无Ø 返回值：无8、VoidHTUpdateToCurrentTime();Ø 功能：将曲线的终止时间设为当前时间Ø 参数：无Ø 返回值：无9、VoidHTSetLeftScooterTime(LonglTime，shortsMilliSecond);Ø 功能：设置曲线时间坐标起点Ø 参数：lTime：时间的年月日时分秒部分，将该时间用HTConvretTime（）函数转换为自1970年1月1日0时到指定时间的秒数sMilliSecond：时间的毫秒部分Ø 返回值：无Ø 举例：定义ST为起始时间，设置该曲线的起始时间为2001年12月1日0时0分0秒，毫秒部分为0ST=HTConvretTime(2001,12,1,0,0,0);HTSetLeftScooterTime(ST，0);10、VoidHTZoomIn(stringszLookString);Ø 功能：通过增大时间轴和数值轴长度，是曲线图表缩小Ø 参数：szLookString：缩放类型“StartTime：保持起始时间与缩放前相等“EndTime：保持终止时间与缩放前相等“Center：保持中心时间与缩放前相等Ø 返回值：无Ø 举例：缩小图表，使中心时间保持不变HTZoomIn(“Center);11、VoidHTZoomOut(stringszLookString);Ø 功能：通过缩短时间轴和数值轴长度，是曲线图表放大Ø 参数：szLookString：缩放类型“StartTime：保持起始时间与缩放前相等“EndTime：保持终止时间与缩放前相等“Center：保持中心时间与缩放前相等Ø 返回值：无Ø 举例：放大图表，使起始时间保持不变HTZoomIn(“StartTime);12、VoidSetTimeParam(longlStartTime,shortsStartms,longlXWidth,shortsXWidthUnit)Ø 功能：设置历史曲线时间坐标起点、时间轴长度Ø 参数：longlStartTime时间年月日时分秒部分shortsMilliSecond时间的毫秒部分longlXWidth时间轴长度shortsXWithUnit时间轴长度单位：0-秒1-分2-时3-日4-毫秒5、运行时修改控件属性控件属性定义完成后，启动组态王运行系统，运行系统的控件如图10所示。图10运行时的控件5.1数值轴指示器的使用：拖动数值轴（Y轴）指示器，可以放大或者缩小曲线在Y轴方向的长度，一般情况下，该指示器标记为当前图表中变量量程的百分比。另外，用户可以修改该标记值为当前曲线列表中某一条曲线的量程数值。修改办法为：用鼠标单击图表下方工具条中的“百分比按钮右侧的箭头按钮，弹出如图11所示的曲线颜色列表框。该列表框中显示的为每条曲线所对应的颜色，（曲线颜色对应的变量可以从图表的列表中看到），选择完曲线后，弹出如图12所示的对话框，该对话框为设置修改当前标记后数值轴显示数据的小数位数。选择完成后，数值轴标记显示的数据变为当前选定的变量的量程范围，标记字体颜色也相应变为当前选定的曲线的颜色，如图13所示。图11选择数值轴显示数据的变量图12设置数值轴标记的小数位图13修改数值轴标记为变量实际量程5.2时间轴指示器的使用：时间轴指示器所获得的时间字符串显示在曲线图表的顶部两侧，如图13所示。时间轴指示器可以配合函数等获得曲线某个时间点上的数据。5.3工具条的使用：曲线图表的工具条是用来操作曲线图表查看变量曲线的。工具条的具体作用可以通过将鼠标放到按钮上时弹出的提示文本看到。下面详细介绍每个按钮的作用。图14图表工具条1、调整跨度设置按钮：图15调整跨度设置Ø 单击按钮弹出如图16所示的对话框，修改当前跨度时间设定值。图16修改调整跨度在“单位列表框中选择跨度的时间单位，有：日、时、分、秒、毫秒。在跨度编辑框中输入时间跨度的数值。Ø 支持毫秒级数据的显示：A 由于组态王历史库还不支持毫秒数据，因此真正支持到毫秒级目前还限于ODBC数据库，等高速历史库完成后，组态王历史库才真正支持到毫秒级。B 时间轴最短宽度为10ms。C 放缩、移动都支持到毫秒。在设置参数对话框中(运行时点击设置参数按扭弹出)中不能设置到毫秒级，要设置到毫秒级要使用命令语言。Ø 单击按钮使曲线图表向左移动一段指定的时间段。Ø 单击按钮使曲线图表向右移动一段指定的时间段。2、设置Y轴标记的曲线：请参见5.2节时间轴指示器的使用。3、曲线图表无级缩放：Ø 放大按钮：在曲线图表中选择一个曲线区域，单击该按钮，或者直接单击该按钮，可以放大当前的曲线图表：A、当在曲线区域选取了矩形区域时，时间轴最左/右端调整为矩形左/右边界所在的时间，数值轴标记最上/下端调整为矩形上/下边界所在数值，从而使曲线局部放大，左/右指示器位置分别置时间轴最左/右端。B、当未选定矩形区域时，如左/右指示器不在时间轴最左/右端，时间轴最左/右端调整为左/右指示器所在的时间，数值轴不变，从而使曲线局部放大，左/右指示器位置分别置时间轴最左/右端。C、当未选定矩形区域，左/右指示器在时间轴最左/右端时，时间轴宽度调整为原来的一半，保持中心位置不变，数值轴不变，从而使曲线局部放大，左/右指示器位置分别置时间轴最左/右端。Ø 缩小按钮：在曲线图表中选择一个曲线区域，单击该按钮，或者直接单击该按钮，可以缩小当前的曲线图表：A、当在曲线区域选取了矩形区域时，矩形左/右边界所在的时间调整为时间轴最左/右端所在的时间，矩形上/下边界所在数值调整为数值轴最上/下端所在数值，从而使曲线局部缩小，左/右指示器位置分别置时间轴最左/右端。B、当未选定矩形区域时，如左/右指示器不在时间轴最左/右端，左/右指示器所在的时间调整为时间轴最左/右端所在的时间，数值轴不变，从而使曲线局部缩小，左/右指示器位置分别置时间轴最左/右端。C、当未选定矩形区域，左/右指示器在时间轴最左/右端时，时间轴宽度调整为原来的二倍，保持中心位置不变，数值轴不变，从而使曲线局部缩小，左/右指示器位置分别置时间轴最左/右端。4、打印曲线：单击按钮弹出“打印属性对话框，如图17所示。选择打印机，单击“属性按钮，设置打印属性：纸张大小，打印方向等。可以将当前图表中显示的曲线及坐标系打印出来。图17打印属性对话框5、定义新曲线：单击按钮弹出“增加曲线对话框，如图3所示。选择需要增加曲线的变量名称，定义其绘制属性，单击“确定在曲线图表中增加一条曲线。6、更新曲线图表终止时间为当前时间：单击按钮将曲线图表的终止时间更新为当前时间。7、设置图表数值轴和时间轴参数：单击按钮弹出“输入新参数对话框，如图18所示。修改时间轴的起止时间范围和数值轴百分比的范围。图18输入新参数8、隐藏/显示变量列表：单击按钮或者可以隐藏/显示曲线变量列表。5.4曲线变量列表曲线变量列表主要显示当前曲线图表中所显示的曲线所对应的变量名称，左右指示器的时间，指示器对应的曲线上的点的数据值，在当前图表范围中曲线变量的最大值、最小值和平均值，动态选择是否隐藏某条曲线。在变量列表上单击右键或者选中某条列表项，单击右键，弹出如图19所示的快捷菜单。图19快捷菜单Ø 增加曲线：增加一条曲线到当前曲线图表。Ø 删除曲线：删除当前列表中选中的曲线。Ø 修改曲线属性：修改当前选中的曲线的绘制属性。