組態(tài)王version 653命令語言函數(shù)速查手冊

1、工業(yè)自動化通用組態(tài)軟件組 態(tài) 王version 6.53命 令 語 言 函 數(shù)速 查 手 冊北京亞控科技發(fā)展 前 言本手冊為北京亞控科技發(fā)展 組態(tài)王6.53軟件組態(tài)王6.53使用手冊的輔助說明，主要詳細介紹組態(tài)王6.53軟件中提供的命令語言函數(shù)的定義和使用方法。手冊中提供的信息為產品發(fā)布時軟件的相關使用信息，如有變化，恕不另行通知。亞控公司不能保證手冊中沒有錯誤。在沒有亞控公司書面允許的前提下，除購買者自己使用外，不得為任何其他目的、使用任何方法（包括復印和錄制在內的電子和機械手段）對本手冊的任何部分的內容進行復制和傳播。如果您在使用本手冊的過程中發(fā)現(xiàn)了問題，請以書面的形式把它記錄下來，并與我

2、們取得聯(lián)系，亞控公司表示衷心的感謝。組態(tài)王6.53命令語言函數(shù)速查手冊2007 亞控公司 著作權所有，保留所有權利版本號：亞控公司技術支持熱線： ：01082616619E-Mail：supportasiacontrol salesasiacontrol 或通過網站與我們聯(lián)系： :/ kingview 組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 1目 錄Abs 1Ack 1AckByTagName 2AckByGroupName 2ActivateApp 2ActiveXIsVisible3ArcCos 3ArcSin 3ArcTan 4Average 4BackUpHistData 5B

3、it 5BitSet 6ChangePassword 6chartAdd 7chartClear 8chartSetBarColor 8chartSetValue 9ClosePicture 10ConfigODBC 10Cos 11Date 11DisplayMCI 11Dtext 12EditUsers 13EnableNavigate 13EnableSaveTagValueToIniValueWhenValueChange13Exit 14組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 2Exp 14FileCopy 15FileDelete 16FileMove 16FileRead

4、Fields 18FileReadStr 19FileWriteFields 20FileWriteStr 21GetBackupProgress 22GetDate 22GetDatelocal 23GetGroupName 24GetKey 24GetPictureScrollXPos 24GetPictureScrollYPos 25GetProjectPath 25GetRealDBForBool 25GetRealDBForFloat26GetRealDBForInt26GetRealDBForString 27GetStationStatus 27GetTime 27GetTime

5、local 28HidePicture 29HTConvertTime 29HTGetPenName 30HTGetPenRealValue 30HTGetTimeAtScooter 32HTGetTimeStringAtScooter32HTGetValue 33組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 3HTGetValueAtScooter 34HTGetValueAtZone 35HTResetValueZone 36HTScrollLeft 36HTScrollRight 37HTSetLeftScooterTime 37HTSetPenName 37HTUpdateToCur

6、rentTime 38HTZoomIn 38HTZoomOut 39InfoAppActive 40InfoAppDir 41InfoAppTitle 41InfoDisk 41InfoFile 42InfoResource 43Int 44listLoadList 44listSaveList 45listAddItem 45listClear 46listDeleteItem 47listDeleteSelection 47listFindItem 48listGetItem 48listGetItemCount 49ListGetCurSel 49ListSetCurSel 50list

7、GetItemData 50listInsertItem 51組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 4listSetItemData 51ListLoadFileName 52LoadDriverConfig 52LoadText 54LogE 55LogN 55LogOff 55LogOn 55LogString 56Max 56Min 57ModifyTagField 57MovePicture 58PageDown 58PageUp 59PI 59PlayAvi 59PlaySound 60PlaySound2 62Pow 62PowerCheckUser 63PreviewW

8、indow 64PrintWindow 65pvAddNewRealPt 66pvAddNewSetPt 69pvClear 70pvGetValue 70pvIniPreCuve 71pvLoadData 73pvModifyPreValue 75組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 5pvMoveSlide 75pvSaveData 76pvSetLimits 77ReadTag 78ReBuildDDE 79ReBuildUnConnectDDE 79RecipeDelete 79RecipeInsertRecipe 80RecipeLoad 80RecipeSave 81Re

9、cipeSelectNextRecipe 81RecipeSelectPreviousRecipe82RecipeSelectRecipe 82Report1 83Report2 84ReportPrint 85ReportPrint2 85ReportPrintSetup 86ReportGetCellString 86ReportGetCellValue 87ReportGetColumns 87ReportGetRows 88ReportSetRows 88ReportSetColumns 88ReportLoad 89ReportPageSetup 89ReportSaveAs 90R

10、eportSetCellString 90ReportSetCellString2 91ReportSetCellValue 92組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 6ReportSetCellValue2 93ReportSetHistData 94ReportSetTime 95ReportSetTimeEx 95ReportSetHistData2 96ReportSetHistData3 96ReportWebDownload 97SampleVar 98SampleVarEnd 99SaveText 99SendKeys 100SetNetNodeValid 102Set

11、RealDBForBool 102SetRealDBForFloat 103SetRealDBForInt 103SetRealDBForString 104SetTrendPara 104Sgn 105ShowNavigateWindow 105ShowPicture 105Sin 106SQLAppendStatement 106SQLClearStatement 107SQLClearTable 107SQLCommit 107SQLConnect 108SQLCreateTable 109SQLDelete 110SQLDisconnect 110SQLDropTable 111組態(tài)王

12、命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 7SQLEndSelect 111SQLErrorMsg 111SQLExecute 112SQLFirst 113SQLGetRecord 113SQLInsert 113SQLInsertEnd 114SQLInsertExecute 114SQLInsertPrepare 115SQLLast 115SQLLoadStatement 116SQLNext 116SQLNumRows 117SQLPrepareStatement 117SQLPrev 118SQLRollback 118SQLSelect 119SQLSelectTop() 121

13、SQLSetParamChar 121SQLSetParamDate 122SQLSetParamDateTime 122SQLSetParamDecimal 122SQLSetParamTime 123SQLSetParamFloat 123SQLSetParamInt 124SQLSetParamNull 125SQLSetStatement 125SQLTransact 126SQLUpdate 126SQLUpdateCurrent 127組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 8Sqrt 127StartApp 127StrASCII 128StrChar 128StrFro

14、mInt 129StrFromReal 129StrFromTime 130StrInStr 131StrLeft 131StrLen 132StrLower 132StrMid 133StrReplace 134StrRight 135StrSpace 135StrToInt 135StrToReal 136StrTrim 137StrType 137StructVarRefAddress 138StrUpper 139StopBackupStation 140Sum 140Tan 141Text 141Time 141Trace 142Trunc 143VarRefAddress 143W

15、indowSize144組態(tài)王命令語言函數(shù)速查手冊目錄北京亞控科技發(fā)展 9xyAddNewPoint 145xyClear 145亞控公司各地分支機構聯(lián)系方式：147組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 1命令語言函數(shù)速查手冊“組態(tài)王”支持使用內建的復雜函數(shù)，其中包括字符串函數(shù)、數(shù)學函數(shù)、系統(tǒng)函數(shù)、控件函數(shù)、報表函數(shù)及其他函數(shù)，下面依次介紹各個函數(shù)（函數(shù)名不區(qū)分大小寫，按字母排序）：Abs此函數(shù)用于計算變量值的絕對值，使用格式如下：Abs(變量名或數(shù)值);返回值：整值或實型值；例如：Abs(14); 返回值為14Abs(-7.5); 返回值為7.5Abs(距離); 返回內存模擬變量“距離

16、”的絕對值。Ack對變量進行報警確認，或對報警組進行報警確認。如果函數(shù)參數(shù)為變量名稱，則只對該變量進行報警確認；如果函數(shù)參數(shù)為報警組名稱，則確認所有屬于該報警組及其子報警組的變量。該函數(shù)的參數(shù)只能是變量名或報警組名，不可以為字符串變量。此函數(shù)常用于按鈕命令語言，當發(fā)生報警時，用此函數(shù)進行報警確認，它將產生確認報警事件。調用格式：Ack(報警組名)； 或 Ack(變量名)；例如：Ack(全廠)； 或 Ack(反應罐液位)；組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 2AckByTagName對變量進行報警確認。函數(shù)參數(shù)可以是一個字符串變量，也可以是一個表示變量名的字符串。調用格式：AckByTa

17、gName(tag_name);參數(shù)：tag_name：變量名。例如：AckByTagName (本站點液位);AckByTagName(Varname);其中Varname 為字符串變量。AckByGroupName對報警組進行確認。調用格式：AckByGroupName( station_name, group_name );station_name 為產生報警的IO 服務器名，group_name 為報警組名。函數(shù)參數(shù)可以是字符串變量，也可以是表示IO 服務器名或報警組名的字符串。例如：AckByGroupName (PC1,報警組1);AckByGroupName (PCName, G

18、roupName);/PCName, GroupName為字符串變量。ActivateApp此函數(shù)用于激活正在運行的窗口應用程序，使之變?yōu)楫斍按翱?。獲得輸入焦點。該函數(shù)也可配合函數(shù)SendKeys 的使用。調用形式：ActivateApp(“ExeName”)；參數(shù)：ExeName 應用程序的執(zhí)行文件名例如：組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 3激活Microsoft Word 的正確調用為：ActivateApp(Word.exe)；激活組態(tài)王：可使用 ActivateApp(TouchVew.exe)；ActiveXIsVisible此函數(shù)用于控制窗體控件隱含。調用形式：Activ

19、eXIsVisible(CtrlName, nMode)；參數(shù)：CtrlName 控件名nMode 控制模式。nMode=0 時，控件隱含。例如：實現(xiàn)控件隱含的正確調用為：ActiveXIsVisible(“Ctrl10”, 0)；ArcCos此函數(shù)用于計算變量值的反余弦值, 變量值的取值范圍在-1，1之間，否則函數(shù)返回值無效。調用格式：ArcCos(變量名或數(shù)值);返回值：整值或實型值；例如：ArcCos(1); 此函數(shù)返回值為0ArcCos(temp); 此函數(shù)返回變量“temp”的反余弦值。ArcSin組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 4此函數(shù)用于計算變量值的反正弦值, 變量值

20、的取值范圍在-1，1之間，否則函數(shù)返回值無效。調用格式：ArcSin(變量名或數(shù)值);返回值：整值或實型值；例如：ArcSin(1); 此函數(shù)返回值為90ArcSin(temp); 此函數(shù)返回變量“temp”的反正弦值。ArcTan此函數(shù)用于計算變量值的反正切值, 使用格式為：ArcTan(變量名或數(shù)值);返回值：整值或實型值；例如：ArcTan(1); 此函數(shù)返回值為45ArcTan (temp); 此函數(shù)返回變量“temp”的反正切值。Average此函數(shù)為對指定的組態(tài)王報表表格的多個單元格求平均值，或求多個變量的平均值。語法格式使用如下：Average（a1,a2）; 或Average(

21、a1:a10);a1、a2為組態(tài)王單元格所在的行號列標，或整型或實型變量。其中參數(shù)個數(shù)為1-32 個。當對報表的指定單元格區(qū)域內的單元格進行求平均值運算時，結果顯示在當前單元格內，語法格式使用如下：Average（a1,a2）;組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 5例如：任意單元格選擇求平均值:=Average（a1,b2,r10）;連續(xù)的單元格求平均值:=Average(b1:b10);或求變量的平均值：AverageValue= Average(lVar1,fVar1);BackUpHistData此函數(shù)為組態(tài)王網絡中從IO 服務器上下載歷史數(shù)據(jù)記錄到歷史記錄服務器。用戶在歷史記錄

22、服務器上調用該函數(shù)。函數(shù)的使用需要與組態(tài)王網絡配置相配合，具體內容參見組態(tài)王6.53 使用手冊中“歷史庫”一章。語法使用格式：BackupStationData (Str chMchinename, Long ftEndtime);參數(shù)：chMchinename 字符串型 為進行備份存儲的IO 服務器名ftEndtime 整型 為備份截止時間例如：/備份“IO 采集站”的歷史數(shù)據(jù)，截至時間為當前：endTime=HTConvertTime($年,$月,$日,$時,$分,0);BackUpHistData(IO 采集站, endTime);Bit此函數(shù)用以取得一個整型或實型變量某一位的值(0 或

23、1)。用法：OnOff=Bit( Var , bitNo); /OnOff:離散變量參數(shù)：Var:整型或實型變量組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 6bitNo:位的序號，取值1 至16返回值：離散型。若變量Var 的第bitNo 位為0，返回值OnOff 為0；若變量Var 的第bitNo 位為1，返回值OnOff 為1。例如：開關=Bit(DDE1,6); 從變量DDE1 的第6 位得到變量“開關”狀態(tài)。BitSet此函數(shù)將一個整型或實型變量的任一位置為指定值(0 或1)。語法格式：BitSet( Var, bitNo, OnOff);參數(shù)：Var:整型或實型變量bitNo:位的序

24、號，取值1 至16OnOff:位的設定值注意：對于IO 變量來說，BitSet 函數(shù)只是用于可讀可寫的變量。例如：BitSet(DDE1,6,0); 將變量DDE1 的第6 位置為0。ChangePassword此函數(shù)顯示“更改口令”對話框，允許登錄工程人員更改他們的口令。使用格式：ChangePassword();例如：為畫面上某一按鈕設置命令語言連接：組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 7ChangePassword( );運行時單擊此按鈕，彈出對話框：提示工程人員輸入當前的口令和新口令以及驗證新口令。完全正確后，工程人員的口令設置為新值。chartAdd此函數(shù)用于在指定的棒圖控件

25、中增加一個新的條形圖。語法格式如下：chartAdd( ControlName, Value, label );參數(shù)：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。Value：設定條形圖的初始值，整形數(shù)據(jù), 實型數(shù)據(jù)。label：設定條形圖的標簽值，默認值=索引值Index，Index的取值范圍是1-16。例如：chartAdd( XYChart, 1, L6 );此語句將在棒圖控件XYChart 中增加一個標簽為L6 的條形圖，其初始值為1。組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 8chartClear此函數(shù)用于在指定的棒圖控件中清除所有的棒形圖。語法格式如下

26、：chartClear( ControlName );參數(shù)：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。例如：chartClear( XYChart );此語句把棒圖控件XYChart 中的所有棒圖清除。chartSetBarColor此函數(shù)用于在指定的棒圖控件中設置餅圖的顏色。條形圖不可以。語法格式如下：chartSetBarColor( ControlName, barIndex,colorIndex );參數(shù)：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。barIndex: 整型變量，表示條形圖索引號，用于設定指定的條形圖，其取值

27、范圍為0-15。colorIndex: 整型變量，表示條形圖的顏色索引號，用于設置指定條形圖的顏色，其取值范圍為0-15，顏色索引號和相應的顏色如下所示。顏色索引號 代表顏色 顏色索引號 代表顏色0 Default 8 Gray1 Blue 9 Light Blue2 Green 10 Light Green3 Cyan 11 Light Cyan組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 94 Red 12 Light Red5 Magenta 13 Light Magenta6 Yellow 14 Light Yellow7 White 15 Bright White16 Black例如：

28、chartSetBarColor( XYChart, 0, 1 );此語句將棒圖控件XYChart 中第一塊餅圖的顏色設為blue（即蘭色）。chartSetBarColor( XYChart, 2, 4 );此語句將棒圖控件XYChart 中第三塊餅圖的顏色設為red（即紅色）。chartSetValue此函數(shù)用于在指定的棒圖控件中設定/修改索引值為Index 的條形圖的數(shù)據(jù)。語法格式如下：chartSetValue( ControlName, Index, Value );參數(shù)：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。Value：設定條形圖的數(shù)據(jù)，整形數(shù)據(jù)

29、, 實型數(shù)據(jù)。Index：條形圖的標簽值，Index 的取值范圍是0-15，組態(tài)王自動從0 開始加1，給每一個新增加的條形圖由小到大設定標簽值。例如：chartSetValue( XYChart,2, 30);此語句將在棒圖控件XYChart 中設定索引值為2（第三條）的條形圖的數(shù)據(jù)為 30。組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 10ClosePicture此函數(shù)用于將已調入內存的畫面關閉，并從內存中刪除。語法格式如下：ClosePicture(畫面名);例如：ClosePicture(反應車間); 將關閉畫面“反應車間”。ConfigODBC此函數(shù)用于配置odbc 的數(shù)據(jù)源，語法格式如

30、下：ConfigODBC(nDatatbasetype, szAttributes);參數(shù)：nDatatbasetype：數(shù)據(jù)庫類型，目前支持 Access，SQL server該參數(shù)為 0 時表示數(shù)據(jù)庫類型為Access，參數(shù)為1 時表示數(shù)據(jù)庫類型為SQL server ；szAttributes：配置字符串:例1：配置 Access 數(shù)據(jù)庫，DSN 名稱為demo2，數(shù)據(jù)庫文件為E:Program FilesKingviewExampleKingdemo1數(shù)據(jù)庫.mdb。ConfigODBC(0,DSN=demo20Description=E:ProgramFilesKingviewExa

31、mpleKingdemo1數(shù)據(jù)庫.mdb0PWD=12340UID=shihf);例 2：配置 SQL 數(shù)據(jù)庫：ConfigODBC(1, DSN=MyDSN0 Description =SQLConfigDSN組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 11Sample0SERVER=MySQL0ADDRESS=MyServer0NETWORK=dbmssocn0DATABASE=pubs0);Cos此函數(shù)用于計算變量值的余弦值, 語法格式如下：Cos(數(shù)值或變量名);例如：Cos(90); 返回值為0Cos(temp); 返回變量“temp”的余弦值。Date此函數(shù)為根據(jù)給出的年、月、日整

32、型數(shù)，返回日期字符串，默認格式為：年：月：日。語法使用格式如下：Date（LONG nYear, LONG nMonth, LONG nDay）;例如：年、月、日變量分別為：“$年”、“$月”、“$日”，用日期來顯示由以上三個整數(shù)決定的“日期”字符串，則在命令語言中輸入：日期=Date（年,月,日）;DisplayMCI此函數(shù)提供了一個對多媒體設備的通用接口，具有強大的功能。語法使用格式：DisplayMCI( MCICommand, option );下面舉例說明此函數(shù)的使用方法。例如：組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 12DisplayMCI(“PLAYCD”,3);用于播放CD

33、 唱片中的第3 支歌曲。DisplayMCI(“STOPCD”,”);用于停止播放CD。DisplayMCI(“PLAYMIDI”,”c:midi.mid”);用于播放MIDI 格式的背景音樂”c:midi.mid”。DisplayMCI(“PAUSEMIDI”,” c:midi.mid”);暫停播放MIDI 格式的背景音樂”c:midi.mid”。DisplayMCI(“RESUMMIDI”,” c:midi.mid”);繼續(xù)播放MIDI 格式的背景音樂”c:midi.mid”。DisplayMCI(“CLOSEMIDI”,” c:midi.mid”);停止播放MIDI 格式的背景音樂”c:

34、midi.mid”。DisplayMCI(“EJECTCD”);將光驅中的CD 盤片彈出。Dtext此函數(shù)用于按離散變量的值動態(tài)地改變字符串變量。語法格式如下：Str = Dtext(Discrete_Tag, OnMsg, OffMsg)；參數(shù) 描述Discrete_Tag 離散變量名。OnMsg 字符串變量名OffMsg 字符串變量名當Discrete_Tag1 時，Str 的值為OnMsg當Discrete_Tag0 時，Str 的值為OffMsg例如：Str = Dtext(電源開關，電源打開,電源關閉);當電源開關1 時，Str 的值為電源打開組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)

35、展 13當電源開關0 時，Str 的值為電源關閉。EditUsers此函數(shù)常用于按鈕的命令語言連接，功能是在畫面程序運行中配置工程人員。調用形式：EditUsers( );為配置其他工程人員，當前工程人員的權限必須不小于900。EnableNavigate此函數(shù)用于顯示/關閉導航圖。調用形式：EnableNavigate(is_enable);參數(shù)：is_enable，整型。0: is_enable 為0 時，關閉導航圖；1:is_enable 為1 時，顯示導航圖。使用 EnableNavigate 函數(shù)關閉導航圖后，除非使用該函數(shù)來顯示導航圖，否則無法顯示導航圖。例如：EnableNavi

36、gate(0); /關閉導航圖EnableSaveTagValueToIniValueWhenValueChange對于設置了“保存數(shù)值”和“保存參數(shù)”的變量，使用該函數(shù)后，當變量的值和參數(shù)發(fā)生變化時，系統(tǒng)會自動將變量的值和參數(shù)保存到文件tagname.db 中，無論組態(tài)王運行系統(tǒng)是否正常退出，再次運行后，將保存的變量值和變量參數(shù)作為變量的初始值和初始參數(shù)?！氨４鏀?shù)值”和“保存參數(shù)”的具體含義請參見組態(tài)王手冊第七章 變量定義和管理 部分。調用形式：EnableSaveTagValueToIniValueWhenValueChange(is_enable);組態(tài)王命令語言函數(shù)速查手冊北京亞控科技

37、發(fā)展 14參數(shù)：is_enable：整型變量或數(shù)值1：當變量的值和參數(shù)發(fā)生變化時，保存變量數(shù)值和參數(shù)。組態(tài)王運行系統(tǒng)退出，再次運行后，將保存的變量值和變量參數(shù)作為變量的初始值和初始參數(shù)。0：與組態(tài)王“保存數(shù)值”和“保存參數(shù)”實現(xiàn)的功能相同。例如：組態(tài)王開發(fā)系統(tǒng)數(shù)據(jù)詞典中定義變量，設置“保存數(shù)值”。執(zhí)行函數(shù)：EnableSaveTagValueToIniValueWhenValueChange(1);該變量的值發(fā)生變化時，系統(tǒng)保存該變量的值。組態(tài)王運行系統(tǒng)退出，再次運行后，將保存的變量值作為變量的初始值。Exit此函數(shù)使組態(tài)王運行環(huán)境退出。調用形式：Exit(Option);參數(shù)：Option:

38、 整型變量或數(shù)值0-退出當前程序；1-關機；2-重新啟動windows；Exp此函數(shù)返回指數(shù)函數(shù)ex 的計算結果，使用格式如下：Exp(數(shù)值或變量名);例如：Exp(1); 返回e1 的計算值2.718Exp(temp); 計算e 常量的temp 次冪并返回計算結果。組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 15FileCopy此函數(shù)復制一個源文件到目的文件，它與 DOS 的 Copy 命令或者Windows 文件管理器中的 Copy 功能相似。調用格式：FileCopy( SourceFile，DestFile，DoneTag);參數(shù) 描述SourceFile 源文件名(包含完整的路徑)。

39、DestFile 目的文件(包含完整的路徑)或目錄名(參見下面的例如子)。DoneTag 該參數(shù)目前無效。用來報告復制過程進展情況的變量名稱。此參數(shù)須是一個內存長整數(shù)或內存模擬型，隨著復制過程的進行，該值從0 變化到100。返回值：成功返回1；不能啟動返回0；出錯返回-1；例如：Status=FileCopy(C:*.TXT, C:BACKUP, DoneTag);Status：一個將被寫為1、-1 或0 的整型變量。FileCopy()函數(shù)在后臺執(zhí)行，這樣它不會干擾組態(tài)王的運行。Status 表明的是復制過程是否已成功啟動。一旦復制過程已成功啟動，此過程成功結束，Status 被置為1。若此

40、過程結束前發(fā)生錯誤，則Status 被置為-1。SourceFile 和 DestFile 一般為文件名。但用FileCopy() 函數(shù)復制單一文件時，目標文件名可以是一個目錄，如：FileCopy(C:DATA.TXT, C:BACKUP, DoneTag);組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 16將把文件“DATA.TXT”復制到“C：”驅動器上一個叫做“BACKUP”的目錄下。變量 Monctor 在復制完成后置為1。若 SourceFile 包含任何通配符的話，DestFile 必須是一個目錄(而非文件名)，否則此函數(shù)將返回一個錯誤代碼，如：FileCopy(C:*.TXT,

41、C:BACKUP, DoneTag);將把C 盤根目錄下所有的.TXT 文件復制到C：BACKUP 目錄下。FileDelete此函數(shù)刪除不需要或不想要的文件。調用格式：FileDelete(Filename);參數(shù) 描述Filename 要刪除的文件名。若找到要刪除的文件，并成功地刪除，此函數(shù)將返回1，否則此函數(shù)返回0。例如：Status=FileDelete(C:DATA.TXT);若在 C:找到 DATA.TXT 則Status 等于1, 未找到該文件則為0。FileMove此函數(shù)與 FileCopy ()函數(shù)相似，但只是將文件從一個位置轉移到另一個位置，而不是復制。調用格式：FileM

42、ove(SourceFile, DestFile, DoneTag);參數(shù) 描述組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 17SourceFile 源文件名(包含完整的路徑)DestFile 目的文件名(包含完整的路徑)DoneTag 用來報告移動過程進展情況的變量名稱。此參數(shù)須是一個內存長整數(shù)或內存模擬型，隨著轉移過程的進行，該值從0 變化到100。返回值：成功返回1；不能啟動返回0；出錯返回-1；例如：Status=FileMove(C:DATA.TXT,D:DATA.TXT,Monitor);Status 是一個將被寫為1、-1 或0 的整型變量。Monitor ：在數(shù)據(jù)詞典中定義過的

43、內存整數(shù)。FileMove() 函數(shù)在后臺執(zhí)行，這樣它不會干擾“組態(tài)王”的運行。使用 DoneTag 是為了允許應用程序或工程人員監(jiān)視轉移操作的進展。用這種方法，在轉移過程啟動后可能發(fā)生的任何錯誤都能使工程人員察覺。（此處用變量Monitor監(jiān)測）這與上述返回的Status 不同，Status 表明的是轉移過程是否已成功啟動。一旦轉移過程已成功啟動，Monitor 就會被賦值0。隨著轉移過程的進行，該值不斷增加。當此過程成功結束時達到100，Status 被置為1。若此過程結束前發(fā)生錯誤，Status 被置為-1。若源文件和目的文件位于同一驅動器上，此函數(shù)可以簡單地更改此文件的目錄參照表(計算

44、機在此表中保存磁盤上的文件名和存儲位置)，而不用實際轉移任何數(shù)據(jù)。在這種情況下，不管此文件的大小，轉移操作將會很快。若源文件和組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 18目的文件位于不同的驅動器上，轉移操作所費的時間將隨文件的大小不同而不同。這是因為數(shù)據(jù)必須由一個物理磁盤傳送到另一物理磁盤上，如：FileMove(C:DATA.TXT,C:BACKUPDATA.TXT,Monitor);將把“C”驅動器上根目錄下的名為“DATA.TXT 的文件轉移到名為“BACKUP”的目錄下，變量 Monitor 在轉移完成后將被置為 1。此函數(shù)也可用于文件更名，只要源文件和目的文件指定了相同的目錄，但

45、不同的文件名，如：FileMove (C:DATA.TXT,C:DATA.BAK,Monitor);將把C 盤根目錄下文件“DATA.TXT”更名為“DATA.BAK”。變量Monitor 在其完成后被置為1。FileReadFields此函數(shù)從一個指定文件中讀出 CSV(逗號分隔變量)記錄。調用格式：FileReadFields(Filename,FileOffset,”StartTag”,NumberOfFields);參數(shù) 描述Filename 指定要讀的文件。FileOffset 指定讀此文件的起始位置。若為1，則表明從頭開始StartTag 指定第一個數(shù)據(jù)要寫到的那個組態(tài)王變量的名稱

46、。此變量名必須以一個數(shù)字結尾(如MyTag1)。此參數(shù)必須是一個表明變量名的字符串(而非實際的變量本身)。所以，若變量叫做 MyTag1，就需要給出MyTag1 或MyT，而不僅僅是MyTag1。NumberOfFields 指定要讀的字段數(shù)目(此文件的每條記錄中組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 19以逗號隔開的字段的數(shù)目)。若StartTag 為“MyTag1”而NumberOfField 為3，則有3個字段從文件中讀出并保存在MyTag1、MyTag2 和MyTag3 中。這些具有連續(xù)名字的變量必須先在組態(tài)王中創(chuàng)建，并可以屬于不同的類型(整型，文字等等)。例如：若C：DATAFI

47、LE.CSV 的第一行內容為：“This is text, 3.1416, 5”，調用函數(shù)BytePosition=FileReadFields(C:DATAFILE.CSV,1,MyTag1, 3);將讀出此行，并把“This is text保存在MyTag1 中，3.1416 保存在 MyTag2 中，5 保存在 MyTag3 中：此函數(shù)在讀出之后返回新的字節(jié)位置。你可以在下次讀時使用此返回值作為FileOffset 的值，如：BytePosition=FileReadFields(c:DATAFILE.CSV,FileOffset,MyTag1,3);注意:StartTag 兩側必須加引

48、號。FileReadStr此函數(shù)從指定文件中讀出一指定數(shù)目的字節(jié)(或一整行)。調用格式：FileReadStr(Filename,FileOffset,Str_Tag,CharsToRead);參數(shù) 描述Filename 指定要讀的文件。FileOffset 指定讀此文件的起始位置。若為1，則表明從頭開始。Str_Tag 指定將從文件中讀出的數(shù)據(jù)保存于何處。CharsToRead 指定要從文件中讀出多少字節(jié)。為處理文本組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 20文件，可將CharsToRead 置為0，函數(shù)從文件中一直讀到下一個 LF(換行符)。此函數(shù)在讀出之后返回新的字節(jié)位置?？梢栽谙麓?/p>

49、讀時使用此返回值作為 FileOffset 值。例如：FileReadStr (C:DATAFILE.TXT, 1, Str_Tag, 0);文件“C：DATAFILE.TXT”的第一行將被讀出并保存到Str_Tag 中。FileWriteFields此函數(shù)往指定文件寫入CSV(逗號分隔變量)記錄。調用格式：FileWriteFields(Filename,FileOffset,”StartTag”,NumberOfFields);參數(shù) 描述Filename 指定要寫的文件。若文件不存在，則創(chuàng)建它。FileOffset 指定寫此文件的起始位置。若 FileOffset 為 0，此函數(shù)將寫到文件

50、末尾。若為1，則寫到開頭。StartTag 指定第一個數(shù)據(jù)項的變量名稱。此變量名必須以一個數(shù)字結尾(如MyTag1)。此參數(shù)必須是一個表明變量名的字符串(而非實際的變量本身)。比如，變量名為MyTag1，就需要給出”MyTag1”（注意引號）或MyT，而不僅僅是MyTag1。NumberOfFields 指定要寫的字段數(shù)目(此文件的每條記錄中以逗號隔開的字段的字段數(shù)目)。此函數(shù)在寫入之后返回新的字節(jié)位置。可以在下次調用函數(shù)時使用此返回值作為FileOffset 值。若 StartTag 為“MyTag1”，而NumberOfFields 為3，則有3 個字段被寫入文件中(寫入的是 MyTag1

51、、MyTag2 和 MyTag3)。這些具組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 21有連續(xù)名字的變量必須先在組態(tài)王中創(chuàng)建，并可以屬于不同的類型(整型，字符串等等)。例如：將一行“This is text 3.1416，5”寫到文件C：DATAFILE.CSV的第一行中?！癟his is text”是 MyTag1 的當前值，3.1416是 MyTag2 的當前值，5 是 MyTag3 的當前值。調用函數(shù)FileWriteFields (C:DATAFILE.CSV, 1, MyTag1,3);若將文本串MyTag1 寫到C：DATAFILE.CSV 的末尾，調用函數(shù)FileWriteFi

52、elds (C:DATAFILE.CSV, 0, MyTag1,3);StartTag 兩側必須加引號。FileWriteStr此函數(shù)往指定文件寫入指定數(shù)目的字節(jié)(或一整行)。調用格式：FileWriteStr(Filename,FileOffset,String,LineFeed);參數(shù) 描述Filename 指定寫入的文件。若文件不存在，則創(chuàng)建它。FileOffset 指定此文件的起始位置。若 FileOffset 為 0，此函數(shù)將寫到文件末尾。若為1，則寫到開頭String 指定要寫入文件中的字符。LineFeed 規(guī)定是否在寫操作之后添加換行。當寫入一文本文件時，可以把LineFeed

53、 置為1。此函數(shù)在寫入后返回新的字節(jié)位置。你可以在下次寫時將此返回值當作FileOffset() 函數(shù)的返回值來使用。組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 22例如：將名為MsgTag 的字符串變量寫入文件C:DATAFILE.TXT 的末尾。調用函數(shù)：FileWriteStr (C:DATAFILE.TXT, 0, MsgTag, 1);GetBackupProgress此函數(shù)用于在組態(tài)王進行網絡歷史數(shù)據(jù)備份合并時獲得進度百分比。使用時需要通過命令語言調用來獲得進度值。語法使用格式：GetBackupProgress( str szStationName);參數(shù)：szStationNa

54、me 遠程站點名稱。返回值：整型，為0100 間的進度值。例如：備份進度= GetBackupProgress(“IO 采集站”);GetDate此函數(shù)將以秒為單位的長整型數(shù)轉換為相應的日期數(shù)值，分別以年、月、日等的日期數(shù)值輸出。該長整型秒數(shù)的基準為UTC(格林尼治)時間1970 年1 月1 日00:00:00。轉換完成輸出的日期也為UTC(格林尼治)日期。語法使用格式GetDate(DateTime,Year,Month,Day);參數(shù) 描述DateTime： 需要進行日期轉換的數(shù)，整型，為輸入?yún)?shù)Year： 年，整型，轉換后得到的數(shù)據(jù)，輸出參數(shù)Month： 月，整型，轉換后得到的數(shù)據(jù)，輸出

55、參數(shù)Day： 日，整型，轉換后得到的數(shù)據(jù)，輸出參數(shù)組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 23例如：自UTC(格林尼治)時間1970 年1 月1 日00:00:00 到2003 年8 月8 日0:8:9 的秒的數(shù)值為1060301289，使用GetDate()函數(shù)可以從這個數(shù)值中分離出所表示的日期年、月、日。函數(shù) GetDate(1060301289,年,月,日); 執(zhí)行后，得到的“年”的值為2003，“月” 的值為8，“日” 的值為 8。獲得其中時間的函數(shù)為GetTime()。GetDatelocal此函數(shù)將以秒為單位的長整型數(shù)轉換為相應的日期數(shù)值，分別以年、月、日的日期數(shù)值輸出。該長整

56、型秒數(shù)的基準為UTC(格林尼治)時間1970 年1 月1 日00:00:00。轉換完成輸出的日期為本地日期。語法使用格式GetDatelocal(DateTime,Year,Month,Day);參數(shù) 描述DateTime： 需要進行日期轉換的數(shù)，整型，為輸入?yún)?shù)Year： 年，整型，轉換后得到的數(shù)據(jù)，輸出參數(shù)Month： 月，整型，轉換后得到的數(shù)據(jù)，輸出參數(shù)Day： 日，整型，轉換后得到的數(shù)據(jù)，輸出參數(shù)例如：使用HTConvertTime 函數(shù)將自UTC(格林尼治)時間1970 年1月1 日00:00:00 到北京時間2006 年9 月26 日9:22:4 轉換為以秒為單位的長整數(shù)數(shù)值為11

57、59233724，使用GetDatelocal 函數(shù)可以從這個數(shù)值中分離出所表示的北京日期年、月、日。GetDatelocal (1159233724,年,月,日);執(zhí)行后，得到的“年”的值為2006，“月” 的值為9，“日”的值為 26。組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 24GetGroupName此函數(shù)為通過報警組ID 號獲得報警組名稱。在組態(tài)王中，每個報警組除了名稱外，還有ID 號。組態(tài)王的變量域“.Group”顯示的是變量所屬報警組的ID 號，如果要獲得相應的報警組名稱，就需要使用該函數(shù)。語法使用格式sGroupName= GetGroupName(StationName,G

58、roupID);參數(shù) 描述StationName： 報警組所在的站點名稱（該項暫時無效，使用時用空字符串代替）GroupID： 要獲取名稱的報警組的ID 號返回值為字符串型。例如：GroupName=GetGroupName(“”, 本站點原料罐液位.Group);GetKey此函數(shù)為獲得組態(tài)王當前使用的加密鎖的序列號。語法使用格式KeyID=GetKey();該函數(shù)沒有任何參數(shù)。返回值為字符串型。GetPictureScrollXPos此函數(shù)用于獲取目標畫面當前窗口的左上角的X 坐標值。語法使用格式GetPictureScrollXPos(STRING PictureName);參數(shù) 描述P

59、ictureName：畫面名稱組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 25返回值為目標畫面當前窗口的左上角的X 坐標值。例如：xx=GetPictureScrollXPos(監(jiān)控中心);GetPictureScrollYPos此函數(shù)用于獲取目標畫面當前窗口的左上角的Y 坐標值。語法使用格式GetPictureScrollYPos(STRING PictureName);參數(shù) 描述PictureName：畫面名稱返回值為目標畫面當前窗口的左上角的 Y 坐標值。例如：yy=GetPictureScrollYPos (監(jiān)控中心);GetProjectPath此函數(shù)用于獲取當前工程的路徑。語法使用

60、格式GetProjectPath();例如：在組態(tài)王數(shù)據(jù)詞典中定義內存字符串變量VarName：VarName=GetProjectPath();GetRealDBForBool此函數(shù)用于獲取變量的當前實時離散值。語法使用格式GetRealDBForBool( VarName);參數(shù) 描述組態(tài)王命令語言函數(shù)速查手冊北京亞控科技發(fā)展 26VarName：變量名稱，字符串格式說明：變量只能是離散量。返回值為離散型。例如：bb= GetRealDBForBool( 原料油出料閥);GetRealDBForFloat此函數(shù)用于獲取變量的當前實時模擬值。語法使用格式GetRealDBForFloat (