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

1、 組態(tài)王歷史趨勢曲線控件使用配置參考文檔北京亞控科技發(fā)展有限公司技術部目錄一、功能概述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)增加、刪除、隱藏曲線，還可以修改曲線屬

3、性，實現(xiàn)無級縮放，曲線打印等等。許多功能都不需要通過編寫腳本的方法實現(xiàn)，使用比較方便。缺點在于無法進行WEB的發(fā)布。二、工程實例以一個簡單的例程來說明“歷史趨勢曲線控件”的使用。三、操作步驟：1、歷史趨勢曲線控件的特點：KVHTrend曲線控件是組態(tài)王以Active X控件形式提供的繪制歷史曲線和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 可以自由選擇曲線列表框中的顯示內(nèi)容。10 可以選擇移動游標時是否顯示曲線數(shù)值。11 可以在曲線中顯示報警區(qū)域的背景色2、創(chuàng)建新的工程：2.1) 定義設備：新建一個工程，在設備處新建設備，我們在本例中定義一個仿真PLC的設備，設備列表為“PLC亞控仿真PLC串口” ，設備名稱為“PLC1”。此仿真PLC可以做為虛擬設備與組態(tài)王

5、進行通訊。仿真PLC主要有如下的寄存器：自動加1寄存器INCREA，自動減1寄存器DECREA，隨機寄存器RADOM，常量寄存器 STATIC，常量字符串寄存器STRING，CommErr寄存器。具體的寄存器的使用請參考組態(tài)王IO驅(qū)動幫助。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)樾　笆弊中?，在畫面上選擇控件的左上角，按下鼠標左鍵并拖動，畫面上顯示出一個虛線的矩形框，該矩形框為創(chuàng)建后的曲線的外框。當達到所需大小時，松開鼠標左鍵，則歷史曲線控件創(chuàng)建成功

7、，畫面上顯示出該曲線，如圖四所示。雙擊趨勢曲線，彈出“動畫連接屬性”，控件名命名為“HT”。點擊確定完成對歷史趨勢曲線的命名。2.4) 添加曲線變量： 選中曲線控件點擊右鍵，彈出菜單，選擇“控件屬性”，彈出歷史趨勢曲線控件的屬性對話框，在“曲線”選項卡，點擊“增加”按鈕，選擇變量“壓力”，選擇“線類型”、“線顏色”，點擊“確定”完成壓力曲線的添加。再點擊“增加”按鈕，選擇變量“流量”，選擇“線類型”、 圖三 記錄和安全區(qū)屬性 圖四 歷史趨勢曲線“線顏色”，點擊“確定”完成流量曲線的添加。在趨勢曲線控件屬性的“坐標系”選項卡中對坐標系進行設置，我們設置Y軸的起始值為0，最大值為100，不按照百分

8、比繪制，而是按照實際值顯示。設置時間軸的顯示格式為顯示年、月、日、時、分、秒。添加完成后開發(fā)畫面如圖五所示： 圖五 歷史趨勢曲線3、切換到運行系統(tǒng)：保存畫面后，在工程瀏覽器的“系統(tǒng)配置”“設置運行系統(tǒng)”中進行“主畫面配置”，將“歷史曲線”畫面設置為主畫面。然后切換到運行系統(tǒng)。運行如下圖六所示：趨勢曲線控件自帶的工具欄中提供了很多方便實用的控制按鈕功能供用戶來使用，主要包括：調(diào)整跨度設置按鈕，設置Y軸標記，曲線圖表無級縮放，打印曲線，定義新曲線，更新曲線圖表終止時間為當前時間，設置圖表數(shù)值軸和時間軸參數(shù)，隱藏/顯示變量列表。這些工具欄基本可以滿足客戶的使用了，如果還需要進一步的功能可以通過控件的

9、屬性、方法來實現(xiàn)。下面我們簡單的舉例說明控件的屬性、方法的使用。 圖六 運行系統(tǒng)4、控件的屬性、方法：2.1) 控件的屬性與方法：屬性及含義列表：序號名 稱數(shù)據(jù)類型含 義1CurveUseKVHistDataBool使用組態(tài)王歷史數(shù)據(jù)2CruveDSNString使用數(shù)據(jù)源名稱3CurveTableString數(shù)據(jù)庫的表名4CurveDateTimeFieldString數(shù)據(jù)庫的時間字段名5CurveInvalidColorOLE_COLOR數(shù)據(jù)庫的無效值6CurveVarNameString連接變量名7CurveColorOLE_COLOR曲線顏色8CurveLineTypeShort曲線線

10、形9CurveTimeDelayString曲線比較時間差10CurveDrawTypeShort曲線繪制方式11CurveAlmColorOLE_COLOR報警顯示顏色12CurveHideCurveBool是否隱藏曲線13CurveMilliSecondFieldString毫秒字段名稱14CurveDataFieldString數(shù)據(jù)字段名稱15CuryeInvalidValueString無效值字段名稱16CurveUserStringODBC數(shù)據(jù)源用戶名17CurvePwdStringODBC數(shù)據(jù)源密碼18CurveSavePwdBoolODBC是否保存密碼19CurveListBoo

11、l是否顯示曲線列表20CtrlBtnBool是否顯示控制按鈕21BorderColorOLE_COLOR邊界顏色22BakColorOLE_COLOR背景顏色23DrawXYAxisBool是否繪制坐標軸24AxisLineTypeShort坐標軸線型25AxisColorOLE_COLOR坐標軸顏色26ShortDivLineBool分割線是否為短線27MajXDivNumShortX軸主分割線數(shù)28MinXDivNumShortX軸副分割線數(shù)29MajYDivNumShortY軸主分割線數(shù)30MinYDivNumShortY軸副分割線數(shù)31MajXDivLineTypeShortX軸主分割

12、線線型32MinXDivLineTypeShortX軸副分割線線型33MajYDivLineTypeShortY軸主分割線線型34MinYDivLineTypeShortY軸副分割線線型35MajXDivColorOLE_COLORX軸主分割線顏色36MinXDivColorOLE_COLORX軸副分割線顏色37MajXDivColorOLE_COLORY軸主分割線顏色38MinYDivColorOLE_COLORY軸副分割線顏色39YLabelNumShortY軸標記數(shù)40YminValDoubleY軸標記最小值41YmaxVaLDoubleY軸標記最大值42YLableFontIFontD

13、ispY軸標記字體43XLabelNumShortX軸標記數(shù)44XwidthShortX軸寬度45XLableFontIFontDispX軸標記字體46XLabelFmtYearBoolX軸標記格式是否顯示年47XlabelFmtMonthBoolX軸標記格式是否顯示月48XlabelFmtDayBoolX軸標記格式是否顯示日49XlabelFmtHourBoolX軸標記格式是否顯示時50XlabelFmtMinuteBoolX軸標記格式是否顯示分51XlabelFmtSecondBoolX軸標記格式是否顯示秒52XlabelFmtMilliSecondBoolX軸標記格式是否顯示毫秒53XW

14、idthUnitShortX軸寬度單位：秒、分、時、日54XLableColorOLE_COLORX軸標記顏色55YLableColorOLE_COLORY軸標記顏色56CurveNumLong返回當前曲線圖表中的曲線數(shù)目57AdjustWidthLong時間軸調(diào)整寬度58AdjustWidthUnitshort時間軸調(diào)整寬度單位：秒、分、時、日、毫秒59PercentBool是否按百分比繪制60YMinRealDoubleY軸最小值61YMaxRealDoubleY軸最大值62SampleIntervalLong采樣間隔 秒63SampleIntervalMsLong采樣間隔 毫秒64Pri

15、ntTitleString打印標題65XLVernierShowBool是否顯示左游標66XRVernierShowBool是否顯示右游標67XLabelFmtMicroSecondBoolX軸標記格式是否顯示微秒68SampleUSBool是否微秒采樣69bPrintTitleBool是否打印標題70bPrintListBool是否打印曲線列表71YUNITString縱軸單位72bHiHiAlarmAreaBool是否顯示高高限報警區(qū)73HiHiAlarmAreaUpDouble高高限報警區(qū)上邊界位置74HiHiAlarmAreaDownDouble高高限報警區(qū)下邊界位置75bHiAlar

16、mAreaBool是否顯示高限報警區(qū)76HiAlarmAreaUpDouble高限報警區(qū)上邊界位置77HiAlarmAreaDownDouble高限報警區(qū)下邊界位置78bLoAlarmAreaBool是否顯示低限報警區(qū)79LoAlarmAreaUpDouble低限報警區(qū)上邊界位置80LoAlarmAreaDownDouble低限報警區(qū)下邊界位置81bLoLoAlarmAreaBool是否顯示低低限報警區(qū)82LoLoAlarmAreaUpDouble低低限報警區(qū)上邊界位置83LoLoAlarmAreaDownDouble低低限報警區(qū)下邊界位置84LVernierStrString左游標附加信息8

17、5RVernierStrString右游標附加信息86LVernierAppendStrBool左游標是否顯示附加信息87RVernierAppendStrBool右游標是否顯示附加信息88LShowVernierValTypeShort左游標數(shù)值顯示方式0. 不顯時數(shù)值1. 一直顯示數(shù)值2.移動游標時顯示數(shù)值89RShowVernierValTypeShort右游標數(shù)值顯示方式0 不顯時數(shù)值1 一直顯示數(shù)值2.移動游標時顯示數(shù)值90bPrintSubTitleBool是否打印子標題91PrintSubTitleString打印子標題92SubTitlePosShort子標題位置控件方法說明：

18、1. Void ChangeCurveVarName(long 1Index,BSTR 1pszNewValue);功能：改變歷史曲線所連接的變量，該變量數(shù)據(jù)來自組態(tài)王歷史庫。參數(shù)：1Index：曲線索引號1pszNewValue：變量名2. Void ChangeCurveVarNameForODBC(LONG lIndex,STRING szNewName,STRING szDSN,STRING szUser,STRING szPwd,STRING szTable,STRING szDateTimeField,STRING szMilliSecondField,STRING szDataF

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

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

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

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

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

24、個調(diào)整跨度參數(shù)：無返回值：無10. Void HTUpdateToCurrentTime();功能：將曲線的終止時間設為當前時間參數(shù)：無返回值：無11. Void HTSetLeftScooterTime(Long lTime，short sMilliSecond);功能：設置曲線時間坐標起點參數(shù)：lTime：時間的年月日時分秒部分，將該時間用HTConvertTime（）函數(shù)轉(zhuǎn)換為自1970年1月1日0時到指定時間的秒數(shù) sMilliSecond：時間的毫秒部分返回值：無12. Void HTZoomIn(string szLookString);功能：通過增大時間軸和數(shù)值軸長度，使曲線圖表

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

26、tTime, short sStartms, long lXWidth, short sXWidthUnit)功能：設置歷史曲線時間坐標起點、時間軸長度參數(shù)：lStartTime時間年月日時分秒部分sStartms時間的毫秒部分lXWidth時間軸長度sXWithUnit時間軸長度單位：0-秒 1-分 2-時 3-日 4-毫秒返回值：無注：組態(tài)王6.5第二版，sXWithUnit必須為0，即秒，lXWidth為轉(zhuǎn)換為秒后的時間長度。15. void SetTimeParamDivided(long sStartYear, long sStartMonth, long sStartDay, lo

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

28、秒 返回值：無16. void SetTimeParamString(STRING strStartTime, STRING strEndTime)功能：設置歷史曲線時間坐標起點、終點,可以直接輸入以字符串形式表示的時間參數(shù)參數(shù)：strStartTime 開始時間字符串strEndTime 結(jié)束時間字符串 B 例： m為歷史曲線控件名稱，定義按鈕彈起時：m. SetTimeParamString("2004年9月20日13時0分0秒1毫秒","2004年9月20日15時20分2秒999毫秒") 設置時間軸范圍為:2004-9-20 13:00:00:00

29、12004-9-20 15:20:02:999;17. ShowCurve(LONG lIndex,BOOL bShow)功能：顯示或隱藏指定的曲線參數(shù)：lIndex 曲線索引，116bShow 取1顯示曲線,取0隱藏曲線18. void PrintCurve()功能：打印，與控件打印按鈕實現(xiàn)相同功能參數(shù)：無返回值：無2.2) 屬性方法的使用舉例：屬性舉例：我們舉一個簡單的例程來說明控件屬性的使用：CtrlBtn，是否顯示控制按鈕。Bool類型，1：顯示控制按鈕，0：隱藏控制按鈕。CurveList：是否顯示曲線列表。Bool類型，1：顯示曲線列表，0：隱藏曲線列表。假設我們不想讓客戶利用趨勢曲線控件自帶的工具欄來實現(xiàn)相應的操作，并且也不顯示曲線列表。則可以隱含此工具欄并隱藏曲線列表，利用CtrlBtn屬性、CurveList屬性來實現(xiàn)。在“歷史曲線”畫面空白處點擊右鍵，彈出菜單，選擇“畫面屬性”，彈出七所示：圖七 畫面屬性點擊“命令語言”按鈕，進入畫面屬性命令語言編輯畫面，我們在畫面“顯示時”編寫腳本程序，點擊“控件”按鈕，如下圖八