历史曲线控件使用方法

48 49 50 51 52 53 54 55 56 57 58 XlabelFmtDay XlabelFmtHour XlabelFmtMinute XlabelFmtSecond XlabelFmtMilliSecond XWidthUnit XLableColor YLableColor CurveNum AdjustWidth AdjustWidthUnit Bool Bool Bool Bool Bool Long X轴标记格式—是否显示日 X轴标记格式—是否显示时 X轴标记格式—是否显示分 X轴标记格式—是否显示秒 X轴标记格式—是否显示毫秒 X轴宽度单位：秒、分、时、日 OLE_COLOR X轴标记颜色 OLE_COLOR Y轴标记颜色 返回当前曲线图表中的曲线数目 Long Long Long 时间轴调整宽度 时间轴调整宽度单位：秒、分、时、日、毫秒 注：以上属性中除CurveNum为只读型外，其它属性均为可读写类型。

4.2 控件方法列表

1、 Void CurveVarName(long 1Index,BSTR 1pszNewValue);

? 功能：改变历史曲线所连接的变量 ? 参数：1Index：曲线索引号 1pszNewValue：变量名

? 举例：定义变量V1，m为历史曲线控件名称，定义按钮弹起时

m.ChangeCurveVarName(1, \本站点\\v1\

把第一条曲线连接的变量改成V1。

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

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

szDateTimeField,STRING

szMilliSecondField,STRING

szDataField,STRING

szInvalidValue);

? 功能：改变历史曲线所连接的变量 ? 参数：lIndex：曲线索引号 szNewName：所连接变量 szDSN：使用的数据源名 szUser：用户名

szPwd：密码

szTable：数据库的表名

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

szInvalidValue：表中对应的无效值

? 举例：定义变量V2，m为历史曲线控件名称，定义按钮弹起时

m.ChangeCurveVarNameForODBC(2, \本站点\\v2\市场\,\ ,

\ );

把第二条曲线连接的变量改成V2。

3、 String HTGetTimeStringAtScooter(short nScootNum,String szFormat);

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

历史曲线控件使用方法

? 功能：取得指定指示器处字符串格式的时间

? 参数：nScootNum：指示器索引，1—左、2—右

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

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

? 返回值：字符串型日期时间值

? 举例：定义DatTim为字符串型变量，取得当前左指示器的日期时间字符串

DatTim=HTGetTimeStringAtScooter(1,”DateTime”);

2、Float HTGetPenRealValue(short nPenNum,String szContent);

? 功能：取得指定曲线Y轴（数值轴）起点或终点的实际值 ? 参数：nPenNum：曲线索引，1~16

szContent：指定所需要类型，可为下列之一：

“Start”：将下限值的工程白分比转换为实际值

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

? 返回值：工程百分比对应的实际值

? 举例：定义PenVal实数型变量，取得第一条曲线当前下限值的实际值 PenVal= HTGetPenRealValue (1,”Start”); 3、Float HTGetValue(short nPenNum,String szValType);

? 功能：取得指定曲线整个图表上（当前可见部分）的最大/最小/平均值

? 参数：nPenNum：曲线索引，1~16 szValType：指定所需要类型，可为下列之一：

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

“MinValue”：整个趋势的最小值 “Valid”：判断取得的值是否有效，0—无效，1—有效

? 返回值：曲线整个图表上（当前可见部分）的最大/最小/平均值

? 举例：定义PenVal实数型变量，取得第一条曲线在整个图表上的最大值 PenVal= HTGetValue (1,”MaxValue”);

4、Float HTGetValueAtScooter(short nPenNum,short nScootNum,String szValType);

? 功能：取得指定曲线在指示器位置处所要求的值

? 参数：nPenNum：曲线索引，1~16

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

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

“Valid”：判断取得的值是否有效，0—无效，1—有效

? 返回值：指定曲线在指定指示器处的值

? 举例：定义PenVal实数型变量，取得第一条曲线在右指示器处的值 PenVal= HTGetValueAtScooter (1,，2，”Value”); 5、Float HTGetValueAtZone(short nPenNum,String szValType);

? 功能：取得指定曲线在左右指示器之间的的最大/最小/平均值

? 参数：nPenNum：曲线索引，1~16 szValType：指定所需要类型，可为下列之一：

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

历史曲线控件使用方法

“AverageValue”：平均值

“MaxValue”：最大值 “MinValue”：最小值 “Valid”：判断取得的值是否有效，0—无效，1—有效

? 返回值：指定曲线在左右指示器之间的的最大/最小/平均值 ? 举例：定义PenVal实数型变量，取得第一条曲线的最大值 PenVal= HTGetValueAtZone (1,”MaxValue”); 6、Void HTScrollLeft();

? 功能：将曲线的起始时间左移一个调整跨度

? 参数：无 ? 返回值：无 7、Void HTScrollRight();

? 功能：将曲线的起始时间右移一个调整跨度

? 参数：无

? 返回值：无 8、Void HTUpdateToCurrentTime();

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

? 参数：无 ? 返回值：无

9、Void HTSetLeftScooterTime(Long lTime，short sMilliSecond);

? 功能：设置曲线时间坐标起点

? 参数：lTime：时间的年月日时分秒部分，将该时间用HTConvretTime（）函

数转换为自1970年1月1日0时到指定时间的秒数 sMilliSecond：时间的毫秒部分 ? 返回值：无

? 举例：定义ST为起始时间，设置该曲线的起始时间为2001年12月1日0时

0分0秒，毫秒部分为0 ST=HTConvretTime(2001,12,1,0,0,0); HTSetLeftScooterTime(ST，0);

10、Void HTZoomIn(string szLookString);

? 功能：通过增大时间轴和数值轴长度，是曲线图表缩小

? 参数：szLookString：缩放类型

“StartTime”：保持起始时间与缩放前相等 “EndTime”：保持终止时间与缩放前相等 “Center”：保持中心时间与缩放前相等 ? 返回值：无

? 举例：缩小图表，使中心时间保持不变 HTZoomIn(“Center”);

11、Void HTZoomOut(string szLookString);

? 功能：通过缩短时间轴和数值轴长度，是曲线图表放大

? 参数：szLookString：缩放类型

“StartTime”：保持起始时间与缩放前相等 “EndTime”：保持终止时间与缩放前相等 “Center”：保持中心时间与缩放前相等

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

历史曲线控件使用方法

? 返回值：无

? 举例：放大图表，使起始时间保持不变

HTZoomIn(“StartTime”);

12、Void SetTimeParam(long lStartTime, short sStartms, long lXWidth, short sXWidthUnit)

? 功能：设置历史曲线时间坐标起点、时间轴长度 ? 参数：long lStartTime 时间年月日时分秒部分

short sMilliSecond 时间的毫秒部分

long lXWidth 时间轴长度

short sXWithUnit 时间轴长度单位：0-秒 1-分 2-时 3-日 4-毫秒

注意： 用户在使用该控件时，请使用本文档中介绍的属性和方法，其它的属性和方法请勿使用，以防发生错误。控件的定义、使用方法具体参见《组态王6.0使用手册》。 5、运行时修改控件属性

控件属性定义完成后，启动组态王运行系统，运行系统的控件如图10所示。

指示器

工具条

变量列表

图10 运行时的控件

5.1 数值轴指示器的使用：

拖动数值轴（Y轴）指示器，可以放大或缩小曲线在Y轴方向的长度，一般情况下，该指示器标记为当前图表中变量量程的百分比。另外，用户可以修改该标记值为当前曲线列表中某一条曲线的量程数值。修改方法为：用鼠标单击图表下方工具条中的“百分比”按钮右侧的箭头按钮，弹出如图11所示的曲线颜色列表框。该列表框中显示的为每条曲线所对应的颜色，（曲线颜色对应的变量可以从图表的列表中看到），选择完曲线后，弹出如图12所示的对话框，该对话框为设置修改当前标记后数值轴显示数据的小数位数。选择完成后，

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