xxx公司組態(tài)王歷史趨勢曲線控件文件編號：文件日期：修訂次數(shù)：第1.0次更改批準審核制定方案設(shè)計，管理制度組態(tài)王歷史趨勢曲線控件使用配置參考文檔北京亞控科技發(fā)展有限公司技術(shù)部目錄一、功能概述 3一、功能概述 3二、工程實例 3三、操作步驟： 31、歷史趨勢曲線控件的特點： 32、創(chuàng)建新的工程： 42.1)定義設(shè)備： 42.2)定義變量： 42.3)創(chuàng)建趨勢曲線： 52.4)添加曲線變量： 53、切換到運行系統(tǒng)： 74、控件的屬性、方法： 82.1)控件的屬性與方法： 82.2)屬性方法的使用舉例： 14四、注意事項 19圖表TOC\h\z\t"圖表目錄"\c圖一定義變量壓力 4圖二定義變量流量 5圖三記錄和安全區(qū)屬性 6圖四歷史趨勢曲線 6圖五歷史趨勢曲線 7圖六運行系統(tǒng) 8圖七畫面屬性 15圖八畫面命令語言編輯框 16圖九控件屬性 16圖十畫面命令語言 17圖十一運行畫面 17圖十一控件方法的使用 18圖十二運行畫面 19

一、功能概述常規(guī)需求：很多工業(yè)現(xiàn)場都會要求顯示采集量的趨勢曲線,包括實時曲線、歷史曲線。組態(tài)王中的趨勢曲線的實現(xiàn)方法：利用組態(tài)王的“工具箱”中的“實時曲線”、“歷史曲線”實現(xiàn)。利用組態(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)無級縮放，曲線打印等等。許多功能都不需要通過編寫腳本的方法實現(xiàn)，使用比較方便。缺點在于無法進行WEB的發(fā)布。二、工程實例以一個簡單的例程來說明“歷史趨勢曲線控件”的使用。三、操作步驟：1、歷史趨勢曲線控件的特點：KVHTrend曲線控件是組態(tài)王以ActiveX控件形式提供的繪制歷史曲線和ODBC數(shù)據(jù)庫曲線的功能性工具。該曲線具有以下特點：即可以連接組態(tài)王的歷史庫，也可以通過ODBC數(shù)據(jù)源連接到其它數(shù)據(jù)庫上，如Access、SQLServer等。連接組態(tài)王歷史庫時，可以定義查詢數(shù)據(jù)的時間間隔，如同在組態(tài)王中使用報表查詢歷史數(shù)據(jù)時使用查詢間隔一樣。完全兼容了組態(tài)王原有歷史曲線的功能。最多可同時繪制16條曲線。可以在系統(tǒng)運行時動態(tài)增加、刪除、隱藏曲線。還可以修改曲線屬性。曲線圖表實現(xiàn)無級縮放。可實現(xiàn)某條曲線在某個時間段上的曲線比較。數(shù)值軸可以使用工程百分比標識，也可用曲線實際范圍標識，二者之間自由切換。可直接打印圖表曲線。可以自由選擇曲線列表框中的顯示內(nèi)容。可以選擇移動游標時是否顯示曲線數(shù)值。可以在曲線中顯示報警區(qū)域的背景色2、創(chuàng)建新的工程：2.1)定義設(shè)備：新建一個工程，在設(shè)備處新建設(shè)備，我們在本例中定義一個仿真PLC的設(shè)備，設(shè)備列表為“PLC－亞控－仿真PLC－串口”，設(shè)備名稱為“PLC1”。此仿真PLC可以做為虛擬設(shè)備與組態(tài)王進行通訊。仿真PLC主要有如下的寄存器：自動加1寄存器INCREA，自動減1寄存器DECREA，隨機寄存器RADOM，常量寄存器STATIC，常量字符串寄存器STRING，CommErr寄存器2.2)定義變量：在數(shù)據(jù)詞典中新建兩個IO變量，變量名稱分別為壓力、流量，變量類型為IO實數(shù)，連接的設(shè)備為前面定義的仿真PLC設(shè)備“PLC1”，寄存器分別為INCREA100，DECREA100，數(shù)據(jù)類型為short，讀寫屬性為“只讀”。這樣壓力變量就會從0開始自動加1，其變化范圍是0到100，流量變量從100開始自動減1，其變化范圍是0到100。變量基本屬性定義畫面如下圖圖一定義變量壓力圖二定義變量流量在記錄和安全區(qū)屬性選項卡中我們定義壓力和流量變量的數(shù)據(jù)記錄屬性，如圖三所示，選擇“數(shù)據(jù)變化”記錄，變化靈敏度設(shè)置為0。2.3)創(chuàng)建趨勢曲線：在組態(tài)王開發(fā)系統(tǒng)中新建“趨勢曲線”畫面，在工具箱中單擊“插入通用控件”或選擇菜單“編輯”下的“插入通用控件”命令，彈出“插入控件”對話框，在列表中選擇“歷史趨勢曲線”，單擊“確定”按鈕，對話框自動消失，鼠標箭頭變?yōu)樾　笆弊中停诋嬅嫔线x擇控件的左上角，按下鼠標左鍵并拖動，畫面上顯示出一個虛線的矩形框，該矩形框為創(chuàng)建后的曲線的外框。當達到所需大小時，松開鼠標左鍵，則歷史曲線控件創(chuàng)建成功，畫面上顯示出該曲線，如圖四所示。雙擊趨勢曲線，彈出“動畫連接屬性”，控件名命名為“HT”。點擊確定完成對歷史趨勢曲線的命名。2.4)添加曲線變量：選中曲線控件點擊右鍵，彈出菜單，選擇“控件屬性”，彈出歷史趨勢曲線控件的屬性對話框，在“曲線”選項卡，點擊“增加”按鈕，選擇變量“壓力”，選擇“線類型”、“線顏色”，點擊“確定”完成壓力曲線的添加。再點擊“增加”按鈕，選擇變量“流量”，選擇“線類型”、圖三記錄和安全區(qū)屬性圖四歷史趨勢曲線“線顏色”，點擊“確定”完成流量曲線的添加。在趨勢曲線控件屬性的“坐標系”選項卡中對坐標系進行設(shè)置，我們設(shè)置Y軸的起始值為0，最大值為100，不按照百分比繪制，而是按照實際值顯示。設(shè)置時間軸的顯示格式為顯示年、月、日、時、分、秒。添加完成后開發(fā)畫面如圖五所示：圖五歷史趨勢曲線3、切換到運行系統(tǒng)：保存畫面后，在工程瀏覽器的“系統(tǒng)配置”－“設(shè)置運行系統(tǒng)”中進行“主畫面配置”，將“歷史曲線”畫面設(shè)置為主畫面。然后切換到運行系統(tǒng)。運行如下圖六所示：趨勢曲線控件自帶的工具欄中提供了很多方便實用的控制按鈕功能供用戶來使用，主要包括：調(diào)整跨度設(shè)置按鈕，設(shè)置Y軸標記，曲線圖表無級縮放，打印曲線，定義新曲線，更新曲線圖表終止時間為當前時間，設(shè)置圖表數(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ù)庫的時間字段名5CurveInvalidColorOLE_COLOR數(shù)據(jù)庫的無效值6CurveVarNameString連接變量名7CurveColorOLE_COLOR曲線顏色8CurveLineTypeShort曲線線形9CurveTimeDelayString曲線比較時間差10CurveDrawTypeShort曲線繪制方式11CurveAlmColorOLE_COLOR報警顯示顏色12CurveHideCurveBool是否隱藏曲線13CurveMilliSecondFieldString毫秒字段名稱14CurveDataFieldString數(shù)據(jù)字段名稱15CuryeInvalidValueString無效值字段名稱16CurveUserStringODBC數(shù)據(jù)源用戶名17CurvePwdStringODBC數(shù)據(jù)源密碼18CurveSavePwdBoolODBC是否保存密碼19CurveListBool是否顯示曲線列表20CtrlBtnBool是否顯示控制按鈕21BorderColorOLE_COLOR邊界顏色22BakColorOLE_COLOR背景顏色23DrawXYAxisBool是否繪制坐標軸24AxisLineTypeShort坐標軸線型25AxisColorOLE_COLOR坐標軸顏色26ShortDivLineBool分割線是否為短線27MajXDivNumShortX軸主分割線數(shù)28MinXDivNumShortX軸副分割線數(shù)29MajYDivNumShortY軸主分割線數(shù)30MinYDivNumShortY軸副分割線數(shù)31MajXDivLineTypeShortX軸主分割線線型32MinXDivLineTypeShortX軸副分割線線型33MajYDivLineTypeShortY軸主分割線線型34MinYDivLineTypeShortY軸副分割線線型35MajXDivColorOLE_COLORX軸主分割線顏色36MinXDivColorOLE_COLORX軸副分割線顏色37MajXDivColorOLE_COLORY軸主分割線顏色38MinYDivColorOLE_COLORY軸副分割線顏色39YLabelNumShortY軸標記數(shù)40YminValDoubleY軸標記最小值41YmaxVaLDoubleY軸標記最大值42YLableFontIFontDispY軸標記字體43XLabelNumShortX軸標記數(shù)44XwidthShortX軸寬度45XLableFontIFontDispX軸標記字體46XLabelFmtYearBoolX軸標記格式—是否顯示年47XlabelFmtMonthBoolX軸標記格式—是否顯示月48XlabelFmtDayBoolX軸標記格式—是否顯示日49XlabelFmtHourBoolX軸標記格式—是否顯示時50XlabelFmtMinuteBoolX軸標記格式—是否顯示分51XlabelFmtSecondBoolX軸標記格式—是否顯示秒52XlabelFmtMilliSecondBoolX軸標記格式—是否顯示毫秒53XWidthUnitShortX軸寬度單位：秒、分、時、日54XLableColorOLE_COLORX軸標記顏色55YLableColorOLE_COLORY軸標記顏色56CurveNumLong返回當前曲線圖表中的曲線數(shù)目57AdjustWidthLong時間軸調(diào)整寬度58AdjustWidthUnitshort時間軸調(diào)整寬度單位：秒、分、時、日、毫秒59PercentBool是否按百分比繪制60YMinRealDoubleY軸最小值61YMaxRealDoubleY軸最大值62SampleIntervalLong采樣間隔秒63SampleIntervalMsLong采樣間隔毫秒64PrintTitleString打印標題65XLVernierShowBool是否顯示左游標66XRVernierShowBool是否顯示右游標67XLabelFmtMicroSecondBoolX軸標記格式—是否顯示微秒68SampleUSBool是否微秒采樣69bPrintTitleBool是否打印標題70bPrintListBool是否打印曲線列表71YUNITString縱軸單位72bHiHiAlarmAreaBool是否顯示高高限報警區(qū)73HiHiAlarmAreaUpDouble高高限報警區(qū)上邊界位置74HiHiAlarmAreaDownDouble高高限報警區(qū)下邊界位置75bHiAlarmAreaBool是否顯示高限報警區(qū)76HiAlarmAreaUpDouble高限報警區(qū)上邊界位置77HiAlarmAreaDownDouble高限報警區(qū)下邊界位置78bLoAlarmAreaBool是否顯示低限報警區(qū)79LoAlarmAreaUpDouble低限報警區(qū)上邊界位置80LoAlarmAreaDownDouble低限報警區(qū)下邊界位置81bLoLoAlarmAreaBool是否顯示低低限報警區(qū)82LoLoAlarmAreaUpDouble低低限報警區(qū)上邊界位置83LoLoAlarmAreaDownDouble低低限報警區(qū)下邊界位置84LVernierStrString左游標附加信息85RVernierStrString右游標附加信息86LVernierAppendStrBool左游標是否顯示附加信息87RVernierAppendStrBool右游標是否顯示附加信息88LShowVernierValTypeShort左游標數(shù)值顯示方式不顯時數(shù)值一直顯示數(shù)值2.移動游標時顯示數(shù)值89RShowVernierValTypeShort右游標數(shù)值顯示方式不顯時數(shù)值一直顯示數(shù)值2.移動游標時顯示數(shù)值90bPrintSubTitleBool是否打印子標題91PrintSubTitleString打印子標題92SubTitlePosShort子標題位置控件方法說明：VoidChangeCurveVarName(long1Index,BSTR1pszNewValue);功能：改變歷史曲線所連接的變量，該變量數(shù)據(jù)來自組態(tài)王歷史庫。參數(shù)：1Index：曲線索引號1pszNewValue：變量名VoidChangeCurveVarNameForODBC(LONGlIndex,STRINGszNewName,STRINGszDSN,STRINGszUser,STRINGszPwd,STRINGszTable,STRINGszDateTimeField,STRINGszMilliSecondField,STRINGszDataField,STRINGszInvalidValue);功能：改變歷史曲線所連接的變量，該變量數(shù)據(jù)來自O(shè)DBC數(shù)據(jù)源。參數(shù)：lIndex：曲線索引號 szNewName：所連接變量szDSN：使用的數(shù)據(jù)源名szUser：用戶名szPwd：密碼szTable：數(shù)據(jù)庫的表名szDateTimeField：表中對應(yīng)的時間字段szMilliSecondField：表中對應(yīng)的毫秒字段szDataField：表中對應(yīng)的數(shù)據(jù)字段szInvalidValue：表中對應(yīng)的無效值StringHTGetTimeStringAtScooter(shortnScootNum,StringszFormat);功能：取得指定指示器處的時間，該時間為字符串格式參數(shù)：nScootNum：指示器索引，1—左、2—右szFormat：指定所需要的時間字符串格式，可為下列之一：“Date”：以Windows控制面板相同格式顯示日期“Time”：以Windows控制面板相同格式顯示時間“DateTime”：以Windows控制面板相同格式顯示日期時間返回值：字符串型日期時間值FloatHTGetPenRealValue(shortnPenNum,StringszContent);功能：取得指定曲線Y軸（數(shù)值軸）起點或終點的實際值參數(shù)：nPenNum：曲線索引，1～16szContent：指定所需要類型，可為下列之一：“Start”：將Y軸下限值的工程百分比轉(zhuǎn)換為實際值“End”：將Y軸上限值的工程百分比轉(zhuǎn)換為實際值“Valid”：判斷取得的值是否有效，0—無效，1—有效返回值：工程百分比對應(yīng)的實際值FloatHTGetValue(shortnPenNum,StringszValType);功能：取得指定曲線整個圖表上（當前可見部分）的最大/最小/平均值參數(shù)：nPenNum：曲線索引，1～16szValType：指定所需要的計算類型，可為下列之一：“AverageValue”：整個趨勢的平均值“MaxValue”：整個趨勢的最大值“MinValue”：整個趨勢的最小值“Valid”：判斷取得的值是否有效，0—無效，1—有效返回值：曲線整個圖表上（當前可見部分）的最大/最小/平均值FloatHTGetValueAtScooter(shortnPenNum,shortnScootNum,StringszValType);功能：取得指定曲線在指示器位置處所要求的值參數(shù)：nPenNum：曲線索引，1～16nScootNum：指示器索引，1—左、2—右szValType：指定所需要類型，可為下列之一：“Value”：取得指示器處的值“Valid”：判斷取得的值是否有效，0—無效，1—有效返回值：指定曲線在指定指示器處的值FloatHTGetValueAtZone(shortnPenNum,StringszValType);功能：取得指定曲線在左右指示器之間的的最大/最小/平均值參數(shù)：nPenNum：曲線索引，1～16szValType：指定所需要的計算類型，可為下列之一：“AverageValue”：平均值“MaxValue”：最大值“MinValue”：最小值“Valid”：判斷取得的值是否有效，0—無效，1—有效返回值：指定曲線在左右指示器之間的的最大/最小/平均值VoidHTScrollLeft();功能：將曲線的起始時間左移一個調(diào)整跨度參數(shù)：無返回值：無VoidHTScrollRight();功能：將曲線的起始時間右移一個調(diào)整跨度參數(shù)：無返回值：無VoidHTUpdateToCurrentTime();功能：將曲線的終止時間設(shè)為當前時間參數(shù)：無返回值：無VoidHTSetLeftScooterTime(LonglTime，shortsMilliSecond);功能：設(shè)置曲線時間坐標起點參數(shù)：lTime：時間的年月日時分秒部分，將該時間用HTConvertTime（）函數(shù)轉(zhuǎn)換為自1970年1月1日0時到指定時間的秒數(shù)sMilliSecond：時間的毫秒部分返回值：無VoidHTZoomIn(stringszLookString);功能：通過增大時間軸和數(shù)值軸長度，使曲線圖表縮小參數(shù)：szLookString：縮放類型，可為下列之一：“StartTime”：保持起始時間與縮放前相等“EndTime”：保持終止時間與縮放前相等“Center”：保持中心時間與縮放前相等返回值：無VoidHTZoomOut(stringszLookString);功能：通過縮短時間軸和數(shù)值軸長度，使曲線圖表放大參數(shù)：szLookString：縮放類型，可為下列之一：“StartTime”：保持起始時間與縮放前相等“EndTime”：保持終止時間與縮放前相等“Center”：保持中心時間與縮放前相等返回值：無VoidSetTimeParam(longlStartTime,shortsStartms,longlXWidth,shortsXWidthUnit)功能：設(shè)置歷史曲線時間坐標起點、時間軸長度參數(shù)：lStartTime 時間年月日時分秒部分sStartms 時間的毫秒部分lXWidth 時間軸長度sXWithUnit 時間軸長度單位：0-秒1-分2-時3-日4-毫秒返回值：無注：組態(tài)王6.5第二版，sXWithUnit必須為0，即秒，lXWidth為轉(zhuǎn)換為秒后的時間長度。voidSetTimeParamDivided(longsStartYear,longsStartMonth,longsStartDay,longsStartHour,longsStartMinute,longsStartSecond,longsStartms,longlXWidth,longsXWidthUnit)功能：設(shè)置歷史曲線時間坐標起點、時間軸長度,可以直接輸入時間參數(shù),與SetTimeParam實現(xiàn)的功能相同.參數(shù)：sStartYear 時間的年sStartMonth時間的月sStartDay時間的日sStartHour時間的時sStartMinute時間的分sStartSecond時間的秒sStartms時間的毫秒lXWidth時間軸長度sXWidthUnit時間軸長度單位：0-秒返回值：無voidSetTimeParamString(STRINGstrStartTime,STRINGstrEndTime)功能：設(shè)置歷史曲線時間坐標起點、終點,可以直接輸入以字符串形式表示的時間參數(shù)參數(shù)：strStartTime 開始時間字符串strEndTime結(jié)束時間字符串例：m為歷史曲線控件名稱，定義按鈕彈起時：m.SetTimeParamString("2004年9月20日13時0分0秒1毫秒","2004年9月20日15時20分2秒999毫秒")設(shè)置時間軸范圍為:2004-9-2013:00:00:001～2004-9-2015:20:02:999;ShowCurve(LONGlIndex,BOOLbShow)功能：顯示或隱藏指定的曲線參數(shù)：lIndex 曲線索引，1～16bShow取1顯示曲線,取0隱藏曲線voidPrintCurve()功能：打印，與控件打印按鈕實現(xiàn)相同功能參數(shù)：無返回值：無2.2)屬性方法的使用舉例：屬性舉例：我們舉一個簡單的例程來說明控件屬性的使用：CtrlBtn，是否顯示控制按鈕。Bool類型，1：顯示控制按鈕，0：隱藏控制按鈕。CurveList：是否顯示曲線列表。Bool類型，1：顯示曲線列表，0：隱藏曲線列表。假設(shè)我們不想讓客戶利用趨