組態(tài)王歷史趨勢曲線控件講解

1、組態(tài)王歷史趨勢曲線控件使用配置參考文檔北京亞控科技發(fā)展有限公司技術部北京亞控科技發(fā)展有限公司21目錄一、功能概述3一、功能概述3二、工程實例3三、操作步驟：31、歷史趨勢曲線控件的特點：32、創(chuàng)建新的工程：42.1)定義設備：42.2)定義變量：42.3) 創(chuàng)建趨勢曲線：52.4) 添加曲線變量：53、切換到運行系統(tǒng)：74、控件的屬性、方法：82.1)控件的屬性與方法：82.2)屬性方法的使用舉例：14四、注意事項19圖表圖一定義變量壓力4圖二定義變量流量5圖三記錄和安全區(qū)屬性6圖四歷史趨勢曲線6圖五歷史趨勢曲線7圖六運行系統(tǒng)8圖七畫面屬性15圖八畫面命令語言編輯框16圖九控件屬性16圖十畫面

2、命令語言17圖十一運行畫面17圖十一控件方法的使用18圖十二運行畫面19一、功能概述常規(guī)需求：很多工業(yè)現(xiàn)場都會要求顯示采集量的趨勢曲線,包括實時曲線、歷史曲線。組態(tài)王中的趨勢曲線的實現(xiàn)方法：1、利用組態(tài)王的“工具箱”中的“實時曲線”、“歷史曲線”實現(xiàn)。2、利用組態(tài)王的“插入通用控件”中的“歷史趨勢曲線”實現(xiàn)。第一種實現(xiàn)方法的優(yōu)點在于可以進行WEB的發(fā)布，實現(xiàn)通過IE瀏覽器進行瀏覽。缺點為支持的曲線筆比較少，許多功能的實現(xiàn)需要通過組態(tài)王的函數(shù)來實現(xiàn)，使用相對要麻煩。第二種實現(xiàn)方法的優(yōu)點在于支持同時繪制16條曲線，功能比較完善，可以在系統(tǒng)運行時動態(tài)增加、刪除、隱藏曲線，還可以修改曲線屬性，實現(xiàn)無級

3、縮放，曲線打印等等。許多功能都不需要通過編寫腳本的方法實現(xiàn)，使用比較方便。缺點在于無法進行WEB的發(fā)布。二、工程實例以一個簡單的例程來說明“歷史趨勢曲線控件”的使用。三、操作步驟：1、歷史趨勢曲線控件的特點：KVHTrend曲線控件是組態(tài)王以ActiveX控件形式提供的繪制歷史曲線和ODBC數(shù)據(jù)庫曲線的功能性工具。該曲線具有以下特點：1即可以連接組態(tài)王的歷史庫，也可以通過ODBC數(shù)據(jù)源連接到其它數(shù)據(jù)庫上，如Access、SQLServer等。2連接組態(tài)王歷史庫時，可以定義查詢數(shù)據(jù)的時間間隔，如同在組態(tài)王中使用報表查詢歷史數(shù)據(jù)時使用查詢間隔一樣。3完全兼容了組態(tài)王原有歷史曲線的功能。最多可同時繪

4、制16條曲線。4可以在系統(tǒng)運行時動態(tài)增加、刪除、隱藏曲線。還可以修改曲線屬性。5曲線圖表實現(xiàn)無級縮放。6可實現(xiàn)某條曲線在某個時間段上的曲線比較。7數(shù)值軸可以使用工程百分比標識，也可用曲線實際范圍標識，二者之間自由切換。8可直接打印圖表曲線。9可以自由選擇曲線列表框中的顯示內容。10可以選擇移動游標時是否顯示曲線數(shù)值。11可以在曲線中顯示報警區(qū)域的背景色2、創(chuàng)建新的工程：2.1) 定義設備：新建一個工程，在設備處新建設備，我們在本例中定義一個仿真PLC的設備，設備列表為“PLC亞控一仿真PLC串口”，設備名稱為“PLC1”。此仿真PLC可以做為虛擬設備與組態(tài)王進行通訊。仿真PLC主要有如下的寄存

5、器：自動加1寄存器INCREA，自動減1寄存器DECREA，隨機寄存器RADOM，常量寄存器STATIC，常量字符串寄存器STRING，CommErr寄存器。具體的寄存器的使用請參考組態(tài)王IO驅動幫助。2.2) 定義變量：在數(shù)據(jù)詞典中新建兩個IO變量，變量名稱分別為壓力、流量，變量類型為IO實數(shù)，連接的設備為前面定義的仿真PLC設備“PLC1”，寄存器分別為INCREA100，DECREA100，數(shù)據(jù)類型為short，讀寫屬性為“只讀”。這樣壓力變量就會從0開始自動加1,其變化范圍是0到100，流量變量從100開始自動減1，其變化范圍是0到100。變量基本屬性定義畫面如下圖一、圖二所示：圖二定

6、義變量流量在記錄和安全區(qū)屬性選項卡中我們定義壓力和流量變量的數(shù)據(jù)記錄屬性，如圖三所示，選擇“數(shù)據(jù)變化”記錄，變化靈敏度設置為0。2.3) 創(chuàng)建趨勢曲線：在組態(tài)王開發(fā)系統(tǒng)中新建“趨勢曲線”畫面，在工具箱中單擊“插入通用控件”或選擇菜單“編輯”下的“插入通用控件”命令，彈出“插入控件”對話框，在列表中選擇“歷史趨勢曲線”，單擊“確定”按鈕，對話框自動消失，鼠標箭頭變?yōu)樾　笆弊中停诋嬅嫔线x擇控件的左上角，按下鼠標左鍵并拖動，畫面上顯示出一個虛線的矩形框，該矩形框為創(chuàng)建后的曲線的外框。當達到所需大小時，松開鼠標左鍵，則歷史曲線控件創(chuàng)建成功，畫面上顯示出該曲線，如圖四所示。雙擊趨勢曲線，彈出“動畫連

7、接屬性”控件名命名為“HT”點擊確定完成對歷史趨勢曲線的命名。2.4) 添加曲線變量：選中曲線控件點擊右鍵，彈出菜單，選擇“控件屬性”，彈出歷史趨勢曲線控件的屬性對話框，在“曲線”選項卡，點擊“增加”按鈕，選擇變量“壓力，”選擇“線類型”、“線顏色”，點擊“確定”完成壓力曲線的添加。再點擊“增加”按鈕，選擇變量“流量”，選擇“線類型”、圖三記錄和安全區(qū)屬性%1finnn10:38:4010:48:40#時環(huán)#秒|>|百分比亙i圉i_<<隠赫列表圖例I變量名稱I左時間I左數(shù)值I右時間I右數(shù)值I員小值I最大值I平均值I喘就曲線I圖四歷史趨勢曲線“線顏色”，點擊“確定”完成流量曲線

8、的添加。在趨勢曲線控件屬性的“坐標系”選項卡中對坐標系進行設置，我們設置Y軸的起始值為0，最大值為100，不按照百分比繪制，而是按照實際值顯示。設置時間軸的顯示格式為顯示年、月、日、時、分、秒。添加完成后開發(fā)畫面如圖五所示：圖五歷史趨勢曲線3、切換到運行系統(tǒng)：保存畫面后，在工程瀏覽器的“系統(tǒng)配置”“設置運行系統(tǒng)”中進行“主畫面配置”，將“歷史曲線”畫面設置為主畫面。然后切換到運行系統(tǒng)。運行如下圖六所示：趨勢曲線控件自帶的工具欄中提供了很多方便實用的控制按鈕功能供用戶來使用，主要包括：調整跨度設置按鈕，設置Y軸標記，曲線圖表無級縮放，打印曲線，定義新曲線，更新曲線圖表終止時間為當前時間，設置圖表

9、數(shù)值軸和時間軸參數(shù)，隱藏/顯示變量列表。這些工具欄基本可以滿足客戶的使用了，如果還需要進一步的功能可以通過控件的屬性、方法來實現(xiàn)。下面我們簡單的舉例說明控件的屬性、方法的使用。圖六運行系統(tǒng)4、控件的屬性、方法：2.1)控件的屬性與方法：屬性及含義列表：序號名稱數(shù)據(jù)類型含義1CurveUseKVHistDataBool使用組態(tài)王歷史數(shù)據(jù)2CruveDSNString使用數(shù)據(jù)源名稱3CurveTableString數(shù)據(jù)庫的表名4CurveDateTimeFieldString數(shù)據(jù)庫的時間字段名5CurvelnvalidColorOLECOLOR數(shù)據(jù)庫的無效值6CurveVarNameString連

10、接變量名7CurveColorOLECOLOR曲線顏色8CurveLineTypeShort曲線線形9CurveTimeDelayString曲線比較時間差10CurveDrawTypeShort曲線繪制方式11CurveAlmColorOLECOLOR報警顯示顏色12CurveHideCurveBool是否隱藏曲線13CurveMilliSecondFieldString毫秒字段名稱14CurveDataFieldString數(shù)據(jù)字段名稱15CuryeInvalidValueString無效值字段名稱16CurveUserStringODBC數(shù)據(jù)源用戶名17CurvePwdStringODB

11、C數(shù)據(jù)源密碼18CurveSavePwdBoolODBC是否保存密碼19CurveListBool是否顯示曲線列表20CtrlBtnBool是否顯示控制按鈕21BorderColorOLECOLOR邊界顏色22BakColorOLECOLOR背景顏色23DrawXYAxisBool是否繪制坐標軸24AxisLineTypeShort坐標軸線型25AxisColorOLECOLOR坐標軸顏色26ShortDivLineBool分割線是否為短線27MajXDivNumShortX軸主分割線數(shù)28MinXDivNumShortX軸副分割線數(shù)29MajYDivNumShortY軸主分割線數(shù)30MinY

12、DivNumShortY軸副分割線數(shù)31MajXDivLineTypeShortX軸主分割線線型32MinXDivLineTypeShortX軸副分割線線型33MajYDivLineTypeShortY軸主分割線線型34MinYDivLineTypeShortY軸副分割線線型35MaiXDivColorOLECOLORX軸主分割線顏色36MinXDivColorOLECOLORX軸副分割線顏色37MajXDivColorOLECOLORY軸主分割線顏色38MinYDivColorOLECOLORY軸副分割線顏色39YLabelNumShortY軸標記數(shù)40YminValDoubleY軸標記最小

13、值41YmaxVaLDoubleY軸標記最大值42YLableFontIFontDispY軸標記字體43XLabelNumShortX軸標記數(shù)44XwidthShortX軸寬度45XLableFontIFontDispX軸標記字體46XLabelFmtYearBoolX軸標記格式一是否顯示年47XlabelFmtMonthBoolX軸標記格式一是否顯示月48XlabelFmtDavBoolX軸標記格式一是否顯示日49XlabelFmtHourBoolX軸標記格式一是否顯示時50XlabelFmtMinuteBoolX軸標記格式一是否顯示分51XlabelFmtSecondBoolX軸標記格式一

14、是否顯示秒52XlabelFmtMilliSecondBoolX軸標記格式一是否顯示毫秒53XWidthUnitShortX軸寬度單位：秒、分、時、日54XLableColorOLECOLORX軸標記顏色55YLableColorOLECOLORY軸標記顏色56CurveNumLong返回當前曲線圖表中的曲線數(shù)目57Ad.justWidthLong時間軸調整寬度58AdjustWidthUnitshort時間軸調整寬度單位：秒、分、時、日、毫秒59PercentBool是否按百分比繪制60YMinRealDoubleY軸最小值61YMaxRealDoubleY軸最大值62Samplelnter

15、valLong采樣間隔秒63SamplelntervalMsLong采樣間隔毫秒64PrintTitleString打印標題65XLVernierShowBool是否顯示左游標66XRVernierShowBool是否顯示右游標67XLabelFmtMicroSecondBoolX軸標記格式一是否顯示微秒68SampleUSBool是否微秒采樣69bPrintTitleBool是否打印標題70bPrintListBool是否打印曲線列表71YUNITString縱軸單位72bHiHiAlarmAreaBool是否顯示高高限報警區(qū)73HiHiAlarmAreaUpDouble高高限報警區(qū)上邊界位

16、置74HiHiAlarmAreaDownDouble高高限報警區(qū)下邊界位置75bHiAlarmAreaBool是否顯示高限報警區(qū)76HiAlarmAreaUpDouble高限報警區(qū)上邊界位置77HiAlarmAreaDownDouble高限報警區(qū)下邊界位置78bLoAlarmAreaBool是否顯示低限報警區(qū)79LoAlarmAreaUpDouble低限報警區(qū)上邊界位置80LoAlarmAreaDownDouble低限報警區(qū)下邊界位置81bLoLoAlarmAreaBool是否顯示低低限報警區(qū)82LoLoAlarmAreaUpDouble低低限報警區(qū)上邊界位置83LoLoAlarmAreaDo

17、wnDouble低低限報警區(qū)下邊界位置84LVernierStrString左游標附加信息85RVernierStrString右游標附加信息86LVernierAppendStrBool左游標是否顯示附加信息87RVernierAppendStrBool右游標是否顯示附加信息88LShowVernierValTypeShort左游標數(shù)值顯示方式0.不顯時數(shù)值1. 一直顯示數(shù)值2. 移動游標時顯示數(shù)值89RShowVernierValTypeShort右游標數(shù)值顯示方式0.不顯時數(shù)值1. 一直顯示數(shù)值2. 移動游標時顯示數(shù)值90bPrintSubTitleBool是否打印子標題91PrintS

18、ubTitleString打印子標題92SubTitlePosShort子標題位置控件方法說明：1. VoidChangeCurveVarName(long1Index,BSTR1pszNewValue);功能：改變歷史曲線所連接的變量，該變量數(shù)據(jù)來自組態(tài)王歷史庫。參數(shù)：llndex:曲線索引號IpszNewValue:變量名2. VoidChangeCurveVarNameForODBC(LONGlIndex,STRINGszNewName,STRINGszDSN,STRINGszUser,STRINGszPwd,STRINGszTable,STRINGszDateTimeField,STR

19、INGszMilliSecondField,STRINGszDataField,STRINGszInvalidValue);功能：改變歷史曲線所連接的變量，該變量數(shù)據(jù)來自ODBC數(shù)據(jù)源。參數(shù)：llndex:曲線索引號szNewName：所連接變量szDSN：使用的數(shù)據(jù)源名szUser：用戶名szPwd：密碼szTable:數(shù)據(jù)庫的表名szDateTimeField:表中對應的時間字段szMilliSecondField:表中對應的毫秒字段szDataField:表中對應的數(shù)據(jù)字段szInvalidValue:表中對應的無效值3. StringHTGetTimeStringAtScooter(s

20、hortnScootNum,StringszFormat);功能：取得指定指示器處的時間，該時間為字符串格式參數(shù)：nScootNum：指示器索引，1左、2右szFormat：指定所需要的時間字符串格式，可為下列之一：“Date”以Windows控制面板相同格式顯示日期“Time”以Windows控制面板相同格式顯示時間“DateTime”以Windows控制面板相同格式顯示日期時間返回值：字符串型日期時間值4. FloatHTGetPenRealValue(shortnPenNum,StringszContent);功能：取得指定曲線Y軸(數(shù)值軸)起點或終點的實際值參數(shù)：nPenNum:曲線索

21、引，116szContent：指定所需要類型，可為下列之一：“Start”將Y軸下限值的工程百分比轉換為實際值“End”：將Y軸上限值的工程百分比轉換為實際值“Valid”判斷取得的值是否有效，0無效，1有效返回值：工程百分比對應的實際值5. FloatHTGetValue(shortnPenNum,StringszValType);功能：取得指定曲線整個圖表上(當前可見部分)的最大/最小/平均值參數(shù)：nPenNum:曲線索引，116szValType:指定所需要的計算類型，可為下列之一：“AverageValue”整個趨勢的平均值“MaxValue”整個趨勢的最大值“MinValue”整個趨

22、勢的最小值“Valid”判斷取得的值是否有效，0無效，1有效返回值：曲線整個圖表上(當前可見部分)的最大/最小/平均值6. FloatHTGetValueAtScooter(shortnPenNum,shortnScootNum,StringszValType);功能：取得指定曲線在指示器位置處所要求的值參數(shù)：nPenNum:曲線索引，116nScootNum：指示器索引，1左、2右szValType：指定所需要類型，可為下列之一：“Value”：取得指示器處的值“Valid”：判斷取得的值是否有效，0無效，1有效返回值：指定曲線在指定指示器處的值7. FloatHTGetValueAtZon

23、e(shortnPenNum,StringszValType);功能：取得指定曲線在左右指示器之間的的最大/最小/平均值參數(shù)：nPenNum:曲線索引，116szValType:指定所需要的計算類型，可為下列之一：“AverageValue”：平均值“MaxValue”：最大值“MinValue”：最小值“Valid”：判斷取得的值是否有效，0無效，1有效返回值：指定曲線在左右指示器之間的的最大/最小/平均值8. VoidHTScrollLeft();功能：將曲線的起始時間左移一個調整跨度參數(shù)：無返回值：無9. VoidHTScrollRight();功能：將曲線的起始時間右移一個調整跨度參數(shù)

24、：無返回值：無10. VoidHTUpdateToCurrentTime();功能：將曲線的終止時間設為當前時間參數(shù)：無返回值：無11. VoidHTSetLeftScooterTime(LonglTime，shortsMilliSecond);功能：設置曲線時間坐標起點參數(shù)：lTime:時間的年月日時分秒部分，將該時間用HTConvertTime()函數(shù)轉換為自1970年1月1日0時到指定時間的秒數(shù)sMilliSecond:時間的毫秒部分返回值：無12. VoidHTZoomIn(stringszLookString);功能：通過增大時間軸和數(shù)值軸長度，使曲線圖表縮小參數(shù)：szLookStr

25、ing:縮放類型，可為下列之一：“StartTime”：保持起始時間與縮放前相等“EndTime”：保持終止時間與縮放前相等“Center”：保持中心時間與縮放前相等返回值：無13. VoidHTZoomOut(stringszLookString);功能：通過縮短時間軸和數(shù)值軸長度，使曲線圖表放大參數(shù)：szLookString:縮放類型，可為下列之一：“StartTime”：保持起始時間與縮放前相等“EndTime”：保持終止時間與縮放前相等“Center”：保持中心時間與縮放前相等返回值：無14. VoidSetTimeParam(longlStartTime,shortsStartms,

26、longlXWidth,shortsXWidthUnit)功能：設置歷史曲線時間坐標起點、時間軸長度參數(shù)：lStartTime時間年月日時分秒部分sStartms時間的毫秒部分lXWidth時間軸長度sXWithUnit時間軸長度單位：0-秒1-分2-時3-日4-毫秒返回值：無注：組態(tài)王6.5第二版，sXWithUnit必須為0,即秒，lXWidth為轉換為秒后的時間長度。15. voidSetTimeParamDivided(longsStartYear,longsStartMonth,longsStartDay,longsStartHour,longsStartMinute,longsSt

27、artSecond,longsStartms,longlXWidth,longsXWidthUnit)功能：設置歷史曲線時間坐標起點、時間軸長度,可以直接輸入時間參數(shù),與SetTimeParam實現(xiàn)的功能相同.參數(shù)：sStartYear時間的年sStartMonth時間的月sStartDay時間的日sStartHour時間的時sStartMinute時間的分sStartSecond時間的秒sStartms時間的毫秒lXWidth時間軸長度sXWidthUnit時間軸長度單位：0-秒返回值：無16. voidSetTimeParamString(STRINGstrStartTime,STRING

28、strEndTime)功能：設置歷史曲線時間坐標起點、終點,可以直接輸入以字符串形式表示的時間參數(shù)參數(shù)：strStartTime開始時間字符串strEndTime結束時間字符串例：m為歷史曲線控件名稱，定義按鈕彈起時：m.SetTimeParamString("2004年9月20日13時0分0秒1毫秒","2004年9月20日15時20分2秒999毫秒")設置時間軸范圍為:2004-9-2013:00:00:0012004-9-2015:20:02:999;17. ShowCurve(LONGlIndex,BOOLbShow)功能：顯示或隱藏指定的曲線參

29、數(shù)：lIndex曲線索引，116bShow取1顯示曲線,取0隱藏曲線18. voidPrintCurve()功能：打印，與控件打印按鈕實現(xiàn)相同功能參數(shù)：無返回值：無2.2)屬性方法的使用舉例：屬性舉例：我們舉一個簡單的例程來說明控件屬性的使用：CtrlBtn,是否顯示控制按鈕。Bool類型，1：顯示控制按鈕，0：隱藏控制按鈕。CurveList：是否顯示曲線列表。Bool類型，1：顯示曲線列表,0：隱藏曲線列表。假設我們不想讓客戶利用趨勢曲線控件自帶的工具欄來實現(xiàn)相應的操作，并且也不顯示曲線列表。則可以隱含此工具欄并隱藏曲線列表，利用CtrlBtn屬性、CurveList屬性來實現(xiàn)。在“歷史曲

30、線”畫面空白處點擊右鍵，彈出菜單，選擇“畫面屬性”，彈出七所示：圖七畫面屬性點擊“命令語言”按鈕，進入畫面屬性命令語言編輯畫面，我們在畫面“顯示時”編寫腳本程序，點擊“控件”按鈕，如下圖八所示，彈出控件選擇對話框，在控件選擇對話框的“控件名稱”處選擇我們前面定義的歷史曲線控件名稱"HT”，然后在“查看類型”中選擇“控件屬性”，則此控件的所有的屬性都會列出，我們可以選擇需要的控件屬性。如圖九所示，選擇“CtrlBtn”屬性。點擊“確定”則畫面命令語言編輯框中出現(xiàn)我們所選擇的控件的屬性。我們對此屬性進行賦值如下：HT.CtrlBtn=0;同樣的方法選擇CurveList屬性，對此屬性進行

31、賦值如下：HT.CurveList=0;編輯完成的畫面命令語言如圖十所示：編輯完成后點擊“確定”完成畫面屬性命令語言的編輯。然后保存“歷史曲線”畫面進入運行系統(tǒng)，如圖十一所示，可以發(fā)現(xiàn)工具欄與曲線列表都隱藏了。畫面命令語言口回區(qū)I文件印編輯即®字顯示時I存在時I隱含時I+畫面名稱+報警俎名稱+關鍵字名稱全部函數(shù)系統(tǒng).f檸件幫助白宗戲i£else)*/確認L-鸚仃t-p.數(shù)學SQL.-苴它+-二取消圖八畫面命令語言編輯框控件屋性和方法|ht查看類型|控件屬性控件名稱雇性或方法MjustWidthCiit-veCulurAdj11EtW1dthlJnitCm-veilataField忌ieCulorCm-veDateTimeFieldPixisLirLtTjiH匚mr-mDr；awTypeB：=LkCulorCurveDSNbcheckbackcolorwithprintCiifyeHideCm-TeBeginTimeFieldCin-Telnterv：=LlbEnableCfgODBC匚urvm工rrzalidCulorbHiAl：±rrTiAi_eaCiit-TeIrLV：dlidll址allr：汕,TypebHiHiAl：±fmAi-eaC