KVHTrend控件使用方法Word下载.docx
- 文档编号:16959072
- 上传时间:2022-11-27
- 格式:DOCX
- 页数:20
- 大小:959.71KB
KVHTrend控件使用方法Word下载.docx
《KVHTrend控件使用方法Word下载.docx》由会员分享,可在线阅读,更多相关《KVHTrend控件使用方法Word下载.docx(20页珍藏版)》请在冰豆网上搜索。
数据源:
选择曲线使用的数据库,在弹出的“SelectDataSource”中选择上面定义的数据源。
表名称:
选择曲线使用的数据来自所选数据库的某一个表
时间字段:
选择曲线数据对应的时间记录,日期/时间类型
数据字段:
选择曲线对应的数据值,长整型或浮点型
毫秒字段:
选择曲线数据对应的毫秒记录,数字类型
无效值:
每一条曲线都和表中一个表示其值的字段关联,这个字段的值在某一时点可能是无效的,但表的结构决定了这个字段在一条记录中的值不能为空白,所以就有了无效值的定义。
比如:
1)当表中数值字段的值为NULL时表示该点数据无效,那么配置无效值时就可以空。
2)当表中数值字段的值为0时表示该点数据无效,那么配置无效值时就可以写0。
3)当表中数值字段的值为“abcd”时表示该点数据无效,那么配置无效值时就可以写“abcd”。
选择完变量并配置完成后,单击“确定”,则曲线名称添加到“曲线列表”中。
如图4所示:
图4增加变量到曲线列表
如上所述,可以增加多个变量到曲线列表中。
“删除”按钮:
删除当前列表框中选中的曲线定义。
“修改”:
修改当前列表框中选中的曲线定义。
“显示列表”选项:
是否显示如图1中的曲线变量列表。
数据源:
显示曲线使用数据源的信息。
2.2坐标系属性页
如图2,单击“坐标系”标签,进入坐标系属性设置页,如图5所示。
图5坐标系属性页
边框颜色和背景颜色:
设置曲线图表的边框颜色和图表背景颜色。
单击相应按钮,弹出浮动调色板,选择所需颜色。
绘制坐标轴选项:
是否在图表上绘制坐标轴。
单击“轴线类型”列表框选择坐标轴线的线型;
单击“轴线颜色”按钮,选择坐标轴线的颜色。
绘制出的坐标轴为带箭头的表示X、Y方向的直线。
“分割线”定义:
定义时间轴、数值轴主次分割线的数目、线的类型、线的颜色等。
如果选择了分割线“为短线”,则定义的主分割线变为坐标轴上的短线,曲线图表不再是被分割线分割的网壮结构,如图6所示。
此时,次分割线不再起作用,其选项也变为灰色无效。
图6分割线与分割线为短线
标记数值(Y)轴:
“标记数目”编辑框中定义数值轴上的标记的个数,“最小值”、“最大值”编辑框定义初始显示的值的百分比范围(0~100%)。
单击“字体”按钮,弹出字体、字型、字号选择对话框,选择数值轴标记的字体及颜色等。
标记时间(X)轴:
“标记数目”编辑框中定义时间轴上的标记的个数。
通过选择“格式”或的选项,选择时间轴显示的时间的格式及内容。
“时间长度”编辑框定义初始显示时图表所显示的时间段的长度。
所有项定义完成后,单击“确定”返回。
3、设置控件的动画连接属性
以上所述为设置控件的固有属性,要在组态王中使用该控件,还需设置控件的动画连接属性。
用鼠标选中并双击该控件,弹出“动画连接属性”设置对话框,如图7所示。
图7设置控件动画连接属性
动画连接属性共有3个属性页,下面一一介绍:
“常规”属性页:
如图7所示。
控件名:
定义该控件在组态王中的标识名,如“历史曲线”,该标识名在组态王当前工程中应该唯一。
优先级、安全区:
定义控件的安全性,单击“安全区选择”按钮选择所需安全区。
“属性”属性页:
如图8所示。
图8“属性”属性页
定义控件的属性与组态王的变量的关联。
“事件”属性页:
如图9所示。
图9事件属性页
定义控件的事件函数。
以上控件的各个动画连接属性的定义请参见《组态王6.0使用手册》第十五章“控件”。
这里不在详细描述。
4、控件属性、方法列表
4.1控件属性列表
序号
名称
数据类型
含义
1
CurveUseKVHistData
Long
使用组态王历史数据
2
CruveDSN
使用数据源名称
3
CurveTable
数据库的表名
4
CurveDateTimeField
数据库的时间字段名
5
CurveInvalidColor
数据库的无效值
6
CurveVarName
连接变量名
7
CurveColor
曲线颜色
8
CurveLineType
曲线线形
9
CurveTimeDelay
曲线比较
10
CurveDrawType
曲线绘制方式
11
CurveAlmColor
报警显示颜色
12
CurveHideCurve
是否隐藏曲线
13
CurveMilliSecondField
毫秒字段
14
CurveDataField
数据字段
15
CuryeInvalidValue
无效值字段
16
CurveUser
用户名
17
CurvePwd
密码
18
CurveSavePwd
确认密码
19
CurveList
Bool
是否显示曲线列表
20
CtrlBtn
是否显示控制按钮
21
BorderColor
OLE_COLOR
边界颜色
22
BakColor
背景颜色
23
DrawXYAxis
是否绘制坐标轴
24
AxisLineType
坐标轴线型
25
AxisColor
坐标轴颜色
26
ShortDivLine
分割线是否为短线
27
MajXDivNum
X轴主分割线数
28
MinXDivNum
X轴副分割线数
29
MajYDivNum
Y轴主分割线数
30
MinYDivNum
Y轴副分割线数
31
MajXDivLineType
X轴主分割线线型
32
MinXDivLineType
X轴副分割线线型
33
MajYDivLineType
Y轴主分割线线型
34
MinYDivLineType
Y轴副分割线线型
35
MajXDivColor
X轴主分割线颜色
36
MinXDivColor
X轴副分割线颜色
37
Y轴主分割线颜色
38
MinYDivColor
Y轴副分割线颜色
39
YLabelNum
Y轴标记数
40
YMinVal
Float
Y轴标记最小值
41
YMaxVaL
Y轴标记最大值
42
YLableFont
IFontDisp
Y轴标记字体
43
XLabelNum
X轴标记数
44
XWidth
X轴宽度
45
XLableFont
X轴标记字体
46
XLabelFmtYear
X轴标记格式—是否显示年
47
XlabelFmtMonth
X轴标记格式—是否显示月
48
XlabelFmtDay
X轴标记格式—是否显示日
49
XlabelFmtHour
X轴标记格式—是否显示时
50
XlabelFmtMinute
X轴标记格式—是否显示分
51
XlabelFmtSecond
X轴标记格式—是否显示秒
52
XlabelFmtMilliSecond
X轴标记格式—是否显示毫秒
53
XWidthUnit
X轴宽度单位:
秒、分、时、日
54
XLableColor
X轴标记颜色
55
YLableColor
Y轴标记颜色
56
CurveNum
返回当前曲线图表中的曲线数目
57
AdjustWidth
时间轴调整宽度
58
AdjustWidthUnit
时间轴调整宽度单位:
秒、分、时、日、毫秒
注:
以上属性中除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:
曲线索引,1~16
szContent:
指定所需要类型,可为下列之一:
“Start”:
将下限值的工程白分比转换为实际值
“End”:
将上限值的工程白分比转换为实际值
“Valid”:
判断取得的值是否有效,0—无效,1—有效
工程百分比对应的实际值
定义PenVal实数型变量,取得第一条曲线当前下限值的实际值
PenVal=HTGetPenRealValue(1,”Start”);
3、FloatHTGetValue(shortnPenNum,StringszValType);
取得指定曲线整个图表上(当前可见部分)的最大/最小/平均值
szValType:
“AverageValue”:
整个趋势的平均值
“MaxValue”:
整个趋势的最大值
“MinValue”:
整个趋势的最小值
曲线整个图表上(当前可见部分)的最大/最小/平均值
定义PenVal实数型变量,取得第一条曲线在整个图表上的最大值
PenVal=HTGetValue(1,”MaxValue”);
4、FloatHTGetValueAtScooter(shortnPenNum,shortnScootNum,StringszValType);
取得指定曲线在指示器位置处所要求的值
nScootNum:
“Value”:
取得指示器处的值
指定曲线在指定指示器处的值
定义PenVal实数型变量,取得第一条曲线在右指示器处的值
PenVal=HTGetValueAtScooter(1,,2,”Value”);
5、FloatHTGetValueAtZone(shortnPenNum,StringszValType);
取得指定曲线在左右指示器之间的的最大/最小/平均值
平均值
最大值
最小值
指定曲线在左右指示器之间的的最大/最小/平均值
定义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秒,毫秒部分为0
ST=HTConvretTime(2001,12,1,0,0,0);
HTSetLeftScooterTime(ST,0);
10、VoidHTZoomIn(stringszLookString);
通过增大时间轴和数值轴长度,是曲线图表缩小
szLookString:
缩放类型
“StartTime”:
保持起始时间与缩放前相等
“EndTime”:
保持终止时间与缩放前相等
“Center”:
保持中心时间与缩放前相等
缩小图表,使中心时间保持不变
HTZoomIn(“Center”);
11、VoidHTZoomOut(stringszLookString);
通过缩短时间轴和数值轴长度,是曲线图表放大
放大图表,使起始时间保持不变
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、当未选定矩形区域时,如左/右指示器不在时间轴最左/右端,时间轴最左/右端调整为左/右指示器所在的时间,数值轴不变,从而使曲线局部放
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- KVHTrend 控件 使用方法