三維力控監(jiān)控組態(tài)軟件的腳本程序函數(shù)清單

1、第二章 腳本函數(shù)12.1 系統(tǒng)函數(shù)12.2 數(shù)學函數(shù)172.3 配方函數(shù)202.4 SQL函數(shù)212.5 設備函數(shù)242.6 字符串操作函數(shù)252.7 Window控件函數(shù)272.8 內(nèi)置數(shù)據(jù)表函數(shù)31第二章 腳本函數(shù)腳本函數(shù)內(nèi)置在界面系統(tǒng)DRAW中。目前包括“系統(tǒng)”類、“數(shù)學”類、“配方”類、“SQL查詢”類、“設備操作”類、“字符串操作”類、“Window控件”類和“內(nèi)置數(shù)據(jù)表”類函數(shù)?！跋到y(tǒng)”類、“字符串操作”類、“Window控件”類和“內(nèi)置數(shù)據(jù)表”類包括數(shù)據(jù)轉(zhuǎn)換、文件操作、系統(tǒng)功能調(diào)用、對象操作等功能函數(shù)。 “數(shù)學”類目前包含一組常用數(shù)學運算函數(shù)； “配方”類目前包含一組用于控制配方

2、管理器的函數(shù)； “SQL查詢”目前包含一組用于實現(xiàn)SQL訪問功能的函數(shù)； “設備操作”類目前包含一組實現(xiàn)計算機I/O讀寫操作的函數(shù)； 可以在動畫鏈接、對象腳本或應用程序腳本中引用腳本函數(shù)。2.1 系統(tǒng)函數(shù)ActiveApp語法 ActiveApp(AppID)。說明 把AppID所指定的程序所在的窗口置到前面，并且該窗口將獲得輸入焦點，即該窗口將接收鍵盤輸入。參數(shù) AppID為應用程序標識，類型為整型，為由StartApp函數(shù)得到的返回值。示例 ActiveApp(AppID)AlmAck語法 AlmAck()說明 當前最新報警確認,當前最新報警顯示在系統(tǒng)報警窗右側(cè)。要顯示系統(tǒng)報警。窗，首先要

3、選中系統(tǒng)參數(shù)中系統(tǒng)報警檢查框。示例 AlmAck()AlmAckAll語法 AlmAckAll(DataSourceNo, AreaNo)。說明 對數(shù)據(jù)庫中某一區(qū)域報警進行確認。DataSourceNo 數(shù)據(jù)源序號，序號從0開始。AreaNo指定區(qū)域號,-1表示所有區(qū)域。示例 AlmAckAll(0,-1)/對整個數(shù)據(jù)庫報警進行確認。AlmLogTimeSet語法 AlmLogTimeSet (StartTime)說明 報警歷史記錄或歷史報表開始時間設置。參數(shù) StartTime: 報警歷史記錄或歷史報表開始時間，類型為數(shù)值型常量、變量或數(shù)值型表達式。該數(shù)值為自1970年1月1日零時逝去的秒數(shù)

4、。示例 #almlog.AlmLogTimeSet ($CurTime - 7200)；/ 報警歷史記錄開始時間設為前2小時。/almlog為報警歷史記錄對象名稱。#almlog.AlmLogTimeSet (LongTime(“2002/1/8 16:50:00”);提示：開始時間可以通過時間控件得到。Beep語法 beep(number) 說明 蜂鳴器發(fā)出叫聲。參數(shù) 參數(shù)number用于指定不同的蜂鳴器響聲。 -1,0:為兩種報警聲。 17對應樂譜的中音1至7。 814對應樂譜的高音1至7。示例 beep(-1)；/標準報警聲。ChangeGroup語法 ChangeGroup（Group

5、Number）說明 該函數(shù)用于實時趨勢、歷史趨勢模板中的變量成組替換，替換量一般為數(shù)據(jù)庫變量。參數(shù) 為數(shù)值常量或數(shù)值表達式，該參數(shù)的值表示變量組的組號。備注 對于模板對象，只是替換位號名，參數(shù)部份保留不變。示例 ChangeGroup（2）;/該函數(shù)將實時趨勢、歷史趨勢和模板中的變量分別替換成序號為2的變量組中的變量。ChangeTag語法 ChangeTag（OldTag,NewTag）說明 該函數(shù)用于模板變量的替換，替換量一般為數(shù)據(jù)庫變量。參數(shù) OldTag為字符串常量或字符串表達式，該參數(shù)為被替換量。NewTag為字符串常量或字符串表達式，該參數(shù)為替換量。備注 只是替換位號名，參數(shù)部分保

6、留不變。示例 ChangeTag（“T1”，“LIC15”）/該函數(shù)將模板中的位號T1，替換成數(shù)據(jù)庫中的實際位號LIC15，如模板中有如下變量T1.PV，T1.SP，T1.OP，T1.EU等將變?yōu)長IC15.PV, LIC15.SP, LIC15.OP, LIC15.EU。ChangeTagByNo語法 ChangeTagByNo(no,"NEWTAG")說明 該函數(shù)用于歷史趨勢和歷史報表，替換量一般為變量。注意這里只是替換位號名，參數(shù)部分保留不變。no為數(shù)字常量或數(shù)字表達式，與歷史趨勢和歷史報表中變量的序號相同。參數(shù) no為數(shù)字常量或數(shù)字表達式，NewTag為字符串常量或

7、字符串表達式，該參數(shù)為替換量。示例 ChangeTagByNo(1,LIC504)/該函數(shù)將趨勢或模板中的序號為的變量替換成數(shù)據(jù)庫中的實際位號LIC504。CheckSecurityArea語法 CheckSecurityArea(SecurityArea)說明 檢查指定安全區(qū)是否可以操作。參數(shù) SecurityArea：逗號分割開的安全區(qū)名字符串，一般是用SecurityAreaDlg得到的用戶設定的值。返回值 布爾值，返回當前登錄的用戶是否可以對這些安全區(qū)中的某一個有操作的權(quán)限。如果有操作權(quán)限返回TRUE，否則返回FALSE。CheckUserPassword語法 CheckUserPas

8、sword(UserName, Password) 說明 檢查指定用戶的密碼。參數(shù) UserName: 用戶名。Password: 用戶密碼。返回值 整型 0 -用戶名密碼正確。1 -密碼錯誤。2 -該用戶不具備這項權(quán)限或用戶名不存在。CheckUserPopedom語法 CheckUserFuncPopedom(UserName, FuncUID)說明 檢查某用戶是否具備某項功能權(quán)限。參數(shù) UserName：用戶名。FunUID：功能權(quán)限的UID。返回值：整型 0 -該用戶具備此項權(quán)限。1 -該用戶不具備這項權(quán)限或用戶名不存在。CloseAllWindow語法 CloseAllWindow(

9、)說明 關閉所有窗口CloseWindow語法 CloseWindow（）說明 關閉當前窗口，一般用于彈出式窗口的關閉。CloseWindowEx語法 CloseWindowEx("WindowName")說明 關閉指定窗口。參數(shù) WindowName: 窗口名稱，字符串變量或常量。示例 CloseWindowEx("Draw1.drw");/將窗口名稱Draw1.drw的窗口關閉。ConvertTo語法 ConvertTo(MasterOrSlave)說明 雙機熱備狀態(tài)的切換函數(shù)。參數(shù) MasterOrSlave 0:由工作狀態(tài)切換到備份狀態(tài) 1:由備

10、份狀態(tài)切換到工作狀態(tài)。示例 ConvertTo(tag1.pv);/當tag1.pv的值為0時，由工作狀態(tài)切換到備份狀態(tài);當tag1.pv的值為1時，由備份狀態(tài)切換到工作狀態(tài)。DeviceClose語法 DeviceClose (DeviceName, DataSourNo)說明 停止設備通訊。參數(shù) DeviceName：設備名稱，類型為字符串常量或變量，該名稱由I/O設備定義時創(chuàng)建。DataSourNo：為整型，為數(shù)據(jù)源序號，-1表示本地數(shù)據(jù)源。數(shù)據(jù)源序號與數(shù)據(jù)源定義列表中所看到的順序相同，序號從0開始。示例 DeviceClose ("MyDev1",-1);/停止設備

11、MyDev1。DeviceDialup語法 DeviceDialup(DeviceName, telenum, DataSourNo)說明 改變設備撥號號碼。參數(shù) DeviceName：設備名稱，類型為字符串常量或變量，該名稱由I/O設備定義時創(chuàng)建。telenum：電話號碼，類型為字符串常量或變量。DataSourNo：為整型，為數(shù)據(jù)源序號，-1表示本地數(shù)據(jù)源。數(shù)據(jù)源序號與數(shù)據(jù)源定義列表中所看到的順序相同，序號從0開始。示例 DeviceDialup ("MyDev1", "6756888",-1);/啟動設備MyDev1。備注 該函數(shù)用于動態(tài)切換I/O

12、采集設備的撥號號碼。DeviceOpen語法 DeviceOpen (DeviceName, DeviceAddress, DataSourNo)說明 啟動設備通訊，并將地址切換到由DeviceAddress參數(shù)所指定地址上。參數(shù) DeviceName：設備名稱，類型為字符串常量或變量，該名稱由I/O設備定義時創(chuàng)建。DeviceAddress：設備地址，I/O設備的邏輯地址，類型為字符串常量或變量。如果該 項為空串""，意思是使用上次啟動地址，如果沒有啟動過將使用設備定義時指定的缺省地址。DataSourNo：為整型，為數(shù)據(jù)源序號，-1表示本地數(shù)據(jù)源。數(shù)據(jù)源序號與數(shù)據(jù)源定義

13、列表中所看到的順序相同，序號從0開始。示例 DeviceOpen ("MyDev1", "",-1);/啟動設備MyDev1。DeviceOpen ("MyDev1", "1".-1);/啟動設備MyDev1，并將地址切換到1。備注 該函數(shù)用于動態(tài)切換I/O采集設備（如一個串口接多臺設備，但是這些設備不同時工作，或其數(shù)據(jù)不需要同時觀看），或采集包（如該數(shù)據(jù)包數(shù)據(jù)變化慢且不經(jīng)?？吹牧浚isableOperate語法 DisableOperate (flag)說明 禁止用戶對變量的操作。參數(shù) flag禁止標志。取值

14、含義：0：允許操作；1：表示禁止操作；2：除了禁止用戶操作外，還將禁止任何腳本中向數(shù)據(jù)庫設置數(shù)據(jù)請求。示例 DisableOperate (1);/禁止操作。 DisableOperate (0);/允許操作。Display語法 Display(WinName)說明 顯示名字為WinName的窗口。備注 顯示名字為WinName的窗口。如果該窗口已經(jīng)運行，則該窗口將成為當前活動窗口。示例 Display(“Win01”) /顯示窗口Win01。DisplayEx語法 DisplayEx("WinName.drw",left,top,right,bottom)說明 改變窗口大

15、小和位置,將指定的窗口大小按Left,top,right,bottom的數(shù)值改變，如果該窗口已經(jīng)運行，則該窗口將成為當前活動窗口。示例 DisplayEx("DRAW2.drw",30,50,60,20)/按30,50,60,20大小。改變DRAW2.drw的大小，同時將它做為當前活動窗口。Enable語法 Enable(flag)說明 允許或禁止對圖形對象。注意：該函數(shù)只對圖元對象起作用。flag為一常數(shù)值或數(shù)值表達式，其值為時圖形目標被禁止，否則將允許對該圖形目標操作。示例 Enable(0);/ 目標被禁止。EventDisp語法 EventDisp()說明 系統(tǒng)事件

16、包括程序起停信息，操作記錄，系統(tǒng)錯誤信息等。示例 EventDisp()/調(diào)用該函數(shù)將出現(xiàn)一事件顯示框。Exit語法 Exit(code)說明 code取值為，。表示退出程序。表示窗口最小化。表示退出所有ForceControl程序。表示重新啟動系統(tǒng)。表示關閉系統(tǒng)。示例 Exit(0);/ 退出應用程序。FileAppend語法 FileAppend(FileName, VarName, Num)說明 往指定的文件中追加數(shù)據(jù)，即從文件尾開始寫數(shù)據(jù)。參數(shù) FileName：文件名。VarName:從該變量開始寫，按照變量的名稱中的數(shù)字順序依次訪問。如變量為var01,其后變量依次為var02,v

17、ar03.。Num:要寫的數(shù)據(jù)個數(shù)。示例 FileAppend("dat01",var01,10)/從var01開始依次向文件附加dat01，data02.,到dat10，共寫入10個數(shù)據(jù)。FileCopy語法 FileCopy(SourFileName,DestFileName , Overwrite)說明 文件復制。復制已有文件（由文件名SourFileName指定）到一新文件（由文件名DestFileName指定）。參數(shù) SourFileName：字符串常量，或字符串表達式，為源文件名（完整的路徑），即已存在文件。 DestFileName：字符串常量，或字符串表達式

18、，為新文件名（完整的路徑）。Overwrite：整型量，覆蓋標志。該量如果為0，如果同名文件已經(jīng)存在，那么復制失??；非0將覆蓋已有文件。返回值 為1成功；為0失敗。示例 FileCopy("c:abctext1.txt", c:text2.txt, 0); /將c:盤下abc目錄下的text1.txt文件，復制到根目錄，并命名為text2.txt。如果text2.txt。存在，復制失敗。FileDataCount語法 FileDataCount(FileName)說明 取得文件中的數(shù)據(jù)個數(shù)，即得到文件中的數(shù)據(jù)項數(shù)。參數(shù) FileName：文件名。返回值:文件中的數(shù)據(jù)個數(shù)。示

19、例 count = FileDataCount("dat01");/count為文件中的數(shù)據(jù)個數(shù)。FileDelete語法 FileDelete(FileName)說明 刪除指定的文件。參數(shù) FileName：文件名。示例 FileDelete(“dat01”)/刪除文件。FileInfo語法 FileInfo(FileName, InfoType)說明 獲取文件信息。如不指定絕對路徑，則使用力控工程路徑。參數(shù) FileName-字符串，文件名稱或者文件夾名稱，支持使用通配符。infotype-整型：1 指定文件是否存在，存在返回1，反之返回0。2 指定文件夾是否存在，存在

20、返回1，反之返回0。3 指定文件大小，文件不存在返回-1，存在返回文件大小，如為負值表明文件超過0x10000000。4 文件最后修改日期，返回為整數(shù)型時間。5 搜索到的文件數(shù)，用戶使用指定文件名(可使用通配符*?搜索到的所有文件個數(shù)。FileMove語法 FileMove(SourFileName,DestFileName )說明 文件/目錄改名或移動。將已有文件/目錄（由文件名SourFileName指定或目錄）改名，或移動到一新的位置（由文件名DestFileName指定）。參數(shù) SourFileName：字符串常量，或字符串表達式，為源文件名或目錄名（完整的路徑），即已存在文件或目錄。

21、DestFileName：字符串常量，或字符串表達式，為新文件名或目錄名（完整的路徑）。返回值 為1成功；為0失敗。備注 如果移動到不同的驅(qū)動器上，將進行文件、目錄復制。示例 1）FileMove("c:abctext1.txt", c:abctext2.txt); /將文件text1.txt改名為text2.txt。 2）FileMove("c:doc1text1.txt", c:doc2text1.txt);/將c:盤下doc1目錄下的text1.txt文件，移動到到目錄doc2下。3）FileMove("c:doc1, c:doc2);/

22、將c:盤下目錄doc1改名為doc2。FileRead語法 FileRead(FileName,VarName,Offset,Num)說明 從指定的文件中回讀數(shù)據(jù)。參數(shù) FileName：文件名。Offset: 偏置。從該偏置開始讀。偏置以0為基準。Num:要讀取的數(shù)據(jù)個數(shù)。VarName:從該變量開始寫，按照變量的順序號依次訪問。備注 假如第一個變量為VAR01，則其后的變量為VAR02示例 FileRead(“dat01”, var01,0,10)/從文件dat01中讀取10個數(shù)據(jù),結(jié)果放入var01開始的變量中，后面的變量依次為var02、var03FileReadFields語法 Fi

23、leReadFields(FileName,VarName,Offset,Num)說明 從指定的逗號分割文件中回讀一條記錄數(shù)據(jù)。參數(shù) FileName：文件名。Offset: 偏置記錄數(shù)。從該偏置記錄開始讀。偏置以0為基準。Num:要讀取的數(shù)據(jù)個數(shù)。VarName: 從該變量開始寫，按照變量的名稱中的數(shù)字順序依次訪問。備注 如變量為var01,其后變量依次為var02,var03示例 FileReadFields(“dat01”, var01,0,10)/從文件dat01中讀取10個數(shù)據(jù),結(jié)果放入var01開始的變量中，后面的變量依次為var02、var03FileWrite語法 FileWr

24、ite(FileName,VarName,Offset ,Num)說明 往指定的文件中寫數(shù)據(jù)。參數(shù) FileName：文件名。VarName：從該變量開始寫，按照變量的順序號依次訪問。如變量為var1,其后變量依次為var2,var3Num:要寫的數(shù)據(jù)個數(shù)。示例 FileWrite(“dat01”, var1,0,10);/從var1開始依次向文件dat01寫入10個數(shù)據(jù)。FileWriteFields語法 FileWriteFields(FileName,VarName,Offset ,Num)說明 往指定的文件中逗號分割的記錄文件，每一條記錄為一行。參數(shù) FileName：文件名。VarN

25、ame：從該變量開始寫，按照變量的順序號依次訪問。Num:要寫的數(shù)據(jù)個數(shù)。Offset:指定寫此文件的起始位置。若 Offset 為 -1，此函數(shù)將寫到文件末尾。若為1，則寫到開頭，其他的數(shù)字表示記錄數(shù)。示例 FileWriteFields(“dat01”, var01,0,10)；/從var01開始依次向文件dat01寫入10個數(shù)據(jù)。FindWindow語法 FindWindow (Title)說明 用于判斷指定的窗口是否存在，窗口由其標題來標識。參數(shù) Title 窗口標題，為程序最上面標題條中所顯示的內(nèi)容。該名稱必須與窗口標題條中顯示的標題一致。返回值：類型為整型，為窗口句柄，0表示窗口不

26、存在。示例 IF( FindWindow("ForceControl - Db1") = 0) THENMsgBox("數(shù)據(jù)庫未啟動！");ENDIFGetAppPath語法 GetAppPath()說明 取得當前應用目錄。返回值 類型為字符串，完整的應用路徑字符串。示例 StrPath = GetAppPath()；GetCurAlm語法 GetCurAlm(alminfor,VAR$)說明 返回值為當前報警優(yōu)先級。若報警已經(jīng)確認則返回值為。參數(shù) alminfor為某一區(qū)域的當前最新報警信息。$ALARMTXT00為區(qū)域當前最新報警信息。$ALARMT

27、XT01為區(qū)域1當前最新報警信息。$ALARMTXT02為區(qū)域2當前最新報警信息。$ALARMTXT為整個數(shù)據(jù)庫當前最新報警信息。VAR$為字符型變量，函數(shù)返回時保存當前發(fā)生報警位號名。返回值 整型。示例 IF (GetCurAlm($ALARMTXT00,S1) > 0) THEN MsgBox("DB Area 0 is alarming TAG="+S1);ENDIF/ 如果區(qū)域中出現(xiàn)報警，假設報警位號/是LIC504，將出現(xiàn)一信息框，內(nèi)容為：/DB Area 0 is alarming Tag=LIC504；GetDataSourceStat語法 GetDat

28、aSourceStat（DataSourceNo）說明 獲取數(shù)據(jù)源狀態(tài)。參數(shù) DataSourceNo 數(shù)據(jù)源序號，序號從0開始。返回值 0 表示數(shù)據(jù)源狀態(tài)正常，否則故障。示例 GetDataSourceStat（0）；GetHisData語法 double GetHisData(Var,Year, Month, Day, Hour,Minute,Second)說明 獲取歷史數(shù)據(jù)。參數(shù) Var 欲存取的變量，該變量必須是數(shù)據(jù)庫變量，該參數(shù)不能包含在""中。Year :整型，表示年,范圍19992037 。0表示當年。Month: 整型，表示月, 范圍112。0表示當月。Da

29、y: 整型，表示日, 范圍131。0表示當天，負值表示前多少天，如-1表示前1天，-2 表示前2天。Hour: 整型，表示時, 范圍023。 負值表示前多少小時，如-1 表示前1小時，-2 表示前2小時。Minute: 整型， 表示分, 范圍059。負值表示前多少分鐘，如-1 表示前1分鐘，-2 表示前2分鐘。Second:表示秒, 范圍059。負值表示前多少秒，如-1 表示前1秒，-2 表示前2秒。返回值 實型，該點在指定時刻的歷史值。示例 1）val = GetHisData(FI101.PV,2000,12,21,10,0,0);取數(shù)據(jù)庫中的點FI101.PV在2000年12月21日10

30、時00分00秒的歷史數(shù)據(jù)。2）val = GetHisData(FI101.PV,0,0,-1,10,0,0);取數(shù)據(jù)庫中的點FI101.PV在本年本月昨日10時00分00秒的歷史數(shù)據(jù)。GetHisDataEx語法 GetHisDataEx(Var,Year, Month, Day, Hour,Minute,Second,MilliSec)參數(shù) Var 欲存取的變量，該變量必須是數(shù)據(jù)庫變量，該參數(shù)不能包含在""中。Year :整型，表示年,范圍19992037 。0表示當年。Month: 整型，表示月, 范圍112。0表示當月。Day: 整型，表示日, 范圍131。0表示當

31、天，負值表示前多少天，如-1表示前1天，-2 表示前2天Hour: 整型，表示時, 范圍023。 負值表示前多少小時，如-1 表示前1小時，-2 表示前2小時Minute: 整型， 表示分, 范圍059。負值表示前多少分鐘，如-1 表示前1分鐘，-2 表示前2分鐘Second:表示秒, 范圍059。負值表示前多少秒，如-1 表示前1秒，-2 表示前2秒MilliSec: :表示毫秒, 范圍0999。示例 返回值：實型，該點在指定時刻的歷史值。1）val = GetHisDataEx(FI101.PV,2000,12,21,10,0,0,100);取數(shù)據(jù)庫中的點FI101.PV在2000年12月

32、21日10時00分00秒100毫秒時的歷史數(shù)據(jù)。2）val = GetHisDataEx(FI101.PV,0,0,-1,10,0,500);取數(shù)據(jù)庫中的點FI101.PV在本年本月昨日10時00分00秒500毫秒時的的歷史數(shù)據(jù)。GetObjLogicLayer語法 GetObjLogicLayer(nLayerID)說明 調(diào)用該函數(shù)將返回圖元在第nLayerID層是否顯示。參數(shù)： nLayerID：返回圖元。GetRect語法 #name.GetRect(left,top,right,bottom) 說明 獲取圖元矩形的大小。參數(shù) left ：返回圖元在界面的左邊距坐標值。top ：返回圖元

33、在界面的上邊距坐標值。right ：返回圖元在界面的右邊距坐標值。bottom：返回圖元在界面的下邊距坐標值。示例 #name.GetRect(left,top,right,bottom)； /返回圖元的4個邊距值。GetStatisData語法 GetStatisData(Var,Year, Month, Day, Hour,TimeSpan,Type,Time)說明 獲取統(tǒng)計數(shù)據(jù)參數(shù) Year, Month, Day, Hour指定的是開始時間，TimeSpan指定的是時間長度。Var 欲存取的變量，該變量必須是數(shù)據(jù)庫變量，該參數(shù)不能包含在""中。Year :整型，表示

34、年,范圍19992037。0表示當年。Month: 整型，表示月, 范圍112。0表示當月。Day: 整型，表示日, 范圍131。0表示當天，負值表示前多少天，如-1 表示前1天，-2 表示前2天。Hour: 整型，表示時, 范圍023。 負值表示前多少小時，如-1 表示前1小時，-2 表示前2小時。TimeSpan:整型，為時間范圍，單位為小時。前多少小時內(nèi)的統(tǒng)計數(shù)據(jù)。如果Hour為8，TimeSpan為1，表示8點9點的統(tǒng)計數(shù)據(jù)（注意：對應于數(shù)據(jù)表中9點的數(shù)據(jù)）；TimeSpan為2，表示6點8點的統(tǒng)計數(shù)據(jù)。Flag: 表示取何種統(tǒng)計數(shù)據(jù)。0：表示Aver； 1: 最大值 2: 最小值。T

35、ime: 字符型變量，為達到最大/最小值的時間。返回值 實型，該點在指定時間段的統(tǒng)計值。示例 1）val = GetStatisData (FI101.PV,2000,12,21,10, 1，0,strTime);取數(shù)據(jù)庫中的點FI101.PV在2000年12月21日1011時的平均值。2）val = GetStatisData (FI101.PV,0,0,-1,10, 2，1,strTime);取數(shù)據(jù)庫中的點FI101.PV在本年本月昨日1012時的最大值。3）val = GetStatisData (FI101.PV,0,0,-1,18, 3，2,strTime);取數(shù)據(jù)庫中的點FI101

36、.PV在本年本月昨日1821時的最小值。GetTagKind語法 GetTagKind(TagName, DataSource)說明 獲取點類型，即得到點在實時數(shù)據(jù)庫中的類型號參數(shù) TagName: 點名稱，字符串變量或常量。DataSource : 整型，數(shù)據(jù)源序號，數(shù)據(jù)源序號以0開始，注意該序號會因數(shù)據(jù)源的刪減而變動。返回值 點類型號，整型。示例 KIND = GetTagKind(“FI1001”,0);GetUserCount語法 GetUserCount()說明 獲得用戶列表中的數(shù)量。（已注冊的用戶）返回值 返回值類型，整型。示例 KIND=GetUserCount()；/返回注冊用

37、戶的總數(shù)GetUserListNode語法 GetUserListNode (ListUserPosition)說明 按用戶列表的位置，獲得用戶名。參數(shù) ListUserPosition：用戶列表中的節(jié)點序號。返回值 字符串型， 用戶名 如果字符串為空，表示執(zhí)行異常。GetVarSecurityArea語法 GetVarSecurityArea(VarName)說明 得到指定變量對應的安全區(qū)名。參數(shù) VarName：變量名。返回值 返回變量設定的安全區(qū)的名。示例 Tag2.Desc = GetVarSecurityArea(Tag1)/得到變量Tag1設定的安全區(qū)名并放到變量Tag2.desc

38、中。Hide語法 Hide()說明 隱藏圖形目標。如果目標處于隱藏狀態(tài)，它將不接受鼠標動作。但可以執(zhí)行雜項/一般動作。備注 該函數(shù)只對圖元對象起作用HideWindow語法 HideWindow(WinNamede)說明 隱藏名字為WinNamede的窗口。如果窗口處于隱藏狀態(tài)，它將不接受鼠標動作。但可以執(zhí)行雜項/一般動作。參數(shù) 字符串。示例 HideWindow(“aaa”);InfoResource語法 InfoResource(ResourceType)說明 返回系統(tǒng)的各種系統(tǒng)資源。參數(shù) 1 返回系統(tǒng)可以物理內(nèi)存字節(jié)數(shù)。2 返回系統(tǒng)物理內(nèi)存字節(jié)總數(shù)。3 返回系統(tǒng)可用物理內(nèi)存百分比。4 返

39、回當前系統(tǒng)正在運行的任務數(shù)。InsertHisData語法 InsertHisData (Var, Data, Year,Month,Day,Hour,Minute,Second,Millisec)說明 向數(shù)據(jù)庫中插入歷史數(shù)據(jù)。參數(shù) Var: 該參數(shù)不能包含在""中。數(shù)據(jù)庫變量，該變量的數(shù)據(jù)源指明了向哪個數(shù)據(jù)庫插入數(shù)據(jù)，而其數(shù)據(jù)庫參數(shù)指明了是數(shù)據(jù)庫的哪點參數(shù)。必須為數(shù)值型變量。注意：要插入的值不是Var變量的當前值，而是下一個參數(shù)Data。Data:要插入的數(shù)值，為數(shù)值型變量，常量或表達式。參數(shù)Year,Month,Day,Hour,Minute,Second, Milli

40、sec用于指定將要插入的歷史數(shù)據(jù)發(fā)生時刻。即歷史數(shù)據(jù)時間插入點。Year :整型，表示年,范圍19992037 。0表示當年。Month: 整型，表示月, 范圍112。0表示當月。Day: 整型，表示日, 范圍131。0表示當天，負值表示前多少天，如-1 表示前1天，-2 表示前2天。Hour: 整型，表示時, 范圍023。 負值表示前多少小時，如-1 表示前1小時，-2 表示前2小時。Minute: 整型， 表示分, 范圍059。負值表示前多少分鐘，如-1 表示前1分鐘，-2 表示前2分鐘。Second:表示秒, 范圍059。負值表示前多少秒，如-1 表示前1秒，-2 表示前2秒。示例 1）

41、InsertHisData(FI101.PV,50.5,2000,12,21,10,0,0,0);向數(shù)據(jù)庫中插入的點為FI101.PV，數(shù)值為50.5，時間為2000年12月21日10時0分0秒0毫秒。2) InsertHisData (FI101.PV, 75.0, 0,0,-1,10,0,0,100);向數(shù)據(jù)庫中插入的點為FI101.PV，數(shù)值為75.00, 時間為在本年本月昨日10時00分00秒100毫秒。IntoConfig語法 IntoConfig()說明 進入組態(tài)狀態(tài)。IntTime語法 IntTime(time, format)說明 用來獲得日期時間的 年 月 日 時 分 秒。參

42、數(shù) time：自1970年1月1日零時逝去的秒數(shù)。format： 要得到的時間格式標識。0：年1：月2：日3：時4：分5：秒示例 year IntTime(curtim, 0)；/將整型變量curtim中的時間值的年度賦值給變量year。IsWeb語法 IsWeb()說明 用于判斷是否在瀏覽器上運行，可以用該值有選擇的執(zhí)行腳本。返回值 整型，1表示在瀏覽器上運行；否則運行在VIEW上。示例 IF (IsWeb() = 0) THENA1.pv = a1.pv + 1;ENDIFLayerDown語法 LayerDown()說明 將圖元下調(diào)一個圖層。備注 調(diào)用該函數(shù)將圖元排列下調(diào)一個圖層。Lay

43、erToBottom語法 LayerToBottom()說明 將圖形對象排列到最后面。備注 調(diào)用該函數(shù)將圖形對象排列到最后面，即它不覆蓋任何其它圖形。LayerToTop()語法 LayerToTop()說明 將圖形對象排列到最前面。備注 調(diào)用該函數(shù)將圖形對象排列到最前面，即不被其它任何圖形覆蓋。LayerUp語法 LayerUp()說明 將圖元上調(diào)一個圖層。備注 調(diào)用該函數(shù)將圖元排列上調(diào)一個圖層。LogicLayerConfiger語法 LogicLayerConfiger()說明 顯示邏輯圖層配置對話框。示例 LogicLayerUsing(-1);/使用所有層；所添加的圖層的配置對話框。

44、LogicLayerConfiger()；/顯示所有圖層的顯示/隱藏配置框。LogicLayerShow語法 LogicLayerShow(Show)說明 LogicLayerUsing所添加的圖層顯示或者隱藏。參數(shù) Show,是否顯示, 1顯示,0隱藏。示例 LogicLayerUsing(0);/使用第1層。LogicLayerUsing(1);/使用第2層。LogicLayerShow(1);/1,2層顯示。LogicLayerShow(0);/1,2層隱藏。LogicLayerUsing語法 LogicLayerUsing(LayerID)說明 添加LogicLayerShow 和 L

45、ogicLayerConfiger 函數(shù)操作的圖層。參數(shù) LayerID圖層索引，范圍-131，-1和0代表所有圖層，132代表第1至第32層。示例 LogicLayerUsing(1);/使用第一層。LogicLayerUsing(-1);/使用所有層。Login語法 Login()說明 用戶注冊，調(diào)用該函數(shù)將出現(xiàn)用戶注冊對話框。LoginEx語法 LoginEx(UserName, Password)說明 該函數(shù)直接用用戶名和密碼不用彈出對話框直接登錄，常用于用戶自己組態(tài)一個登錄對話框的時候使用。參數(shù) UserName：登錄用戶名。 Password：登錄密碼。返回值：整型，0表示失敗,

46、1表示成功。示例 ret=LoginEx("UserName","Password")；Logout語法 Logout()說明 用戶注消，調(diào)用該函數(shù)將出現(xiàn)用戶注消對話框。LogoutEx語法： LogoutEx()說明 強制注銷當前的登錄用戶，不彈注銷對話框。返回值 整型，0-注銷成功，1-異常：沒有登錄用戶，或其他原因。示例 ret= LogoutEx()；LongTime語法 LongTime(String)說明 將字符串形式表示的時間轉(zhuǎn)成整型數(shù)。參數(shù) String：要轉(zhuǎn)換的字符格式的時間，類型為字符串常量、變量或字符串表達式。 時間格式規(guī)定如下“Y

47、YYY/MM/DD hh:mm:ss”，YYYY為年；MM為月；DD為日；hh為時;mm為分；ss為秒。返回值 為整型數(shù)表示的時間，該數(shù)值為自1970年1月1日零時逝去的秒數(shù)。示例 n = LongTime("2002/1/8 16:50:00")MsgBox語法 MsgBox(Message)說明 顯示一提示框。參數(shù) Message 為字符串常量或字符串表達式其值為提示框中顯示的信息。示例 MsgBox(“System Alarm”)PlaySound語法 PlaySound(AviName,flag)說明 播放一段由文件名AviName指定的音樂。參數(shù) AviName：

48、Avi文件名。flag：播放方式取值為0或1。0:代表異步;1:代表同步。示例 PlaySound(“Avi01”,0) /異步方式播放AVI文件Avi01。PostMessage語法 PostMessage(AppID,Msg,wparam,lparam)說明 該函數(shù)用于用于向指定的程序發(fā)送一條消息。參數(shù) AppID：應用程序ID。參數(shù)類型：整型。MSG：發(fā)送的消息號。參數(shù)類型：整型。wparam：要發(fā)送的消息參數(shù)。整型。lparam：要發(fā)送的消息參數(shù)。整型。返回值：整型，1表示成功。示例 ret=PostMessage(AppID,5555,0,0)；Print語法 print(WinNa

49、me)說明 打印名稱為“WinName”的窗口內(nèi)容。參數(shù) 字符串。示例 Print(“Win01”) /打印窗口Win01。PrintEX語法 PrintEx(WindowName,left,top,right,bottom)說明 打印窗口的特定區(qū)域。參數(shù) WindowName: 窗口名稱，字符串變量或常量。 left,top,right,bottom均為為整型，指定的是要打印的矩形區(qū)域。其中l(wèi)eft，top分別為矩形區(qū)域左上角橫坐標和左上角縱坐標；right，bottom分別為矩形區(qū)域右上角橫坐標和右上角縱坐標。左右上角坐標可以通過將光標移至相應位置，并記錄光標當前位置而得到。示例 Prin

50、tEx("Draw1.drw",50, 50, 550, 650);PrintSetup說明 設置打印機。調(diào)用該函數(shù)彈出打印機設置對話框，在該對話框中可以對打印機進行設置。示例 PrintSetup()；Rand語法 rand(number)說明 產(chǎn)生隨機數(shù)。參數(shù) number為隨機數(shù)的上界，下界為0。示例 Rand(100) 會產(chǎn)生0100之間的隨機數(shù)（不包括100）。ReachTime語法 ReachTime(hour,minute)說明 當時間到達后返回值為真,否則為假。hour小時值，取值為，表示任何一小時minute分鐘值，取值為。參數(shù) hour小時值，取值為，表

51、示任何一小時minute分鐘值，取值為示例 IF (ReachTime(8,30) THENBEEP(1);ENDIF;/每天上午時分該函數(shù)取值為真,這時將發(fā)出一聲。SendEvent語法 SendEvent(EventType,EventKind, EventContent,$UserName)說明 該函數(shù)用于向pLog程序發(fā)送一條事件記錄。該函數(shù)可以發(fā)送系統(tǒng)事件和操作事件。事件類型可以是：消息、報警、事件等類型。參數(shù) EventType：事件類型。參數(shù)類型：整型。0 表示系統(tǒng)產(chǎn)生；1 表示人為操作產(chǎn)生，如：關閉程序、VIEW下置數(shù)據(jù)等。 EventKind：事件性質(zhì)。參數(shù)類型：整型。0 表

52、示消息事件；1 表示報警事件；2 表示錯誤事件；3 表示其它性質(zhì)的事件。EventContent：要發(fā)送的內(nèi)容。字符串類型。$UserName為系統(tǒng)提供的登錄的用戶。可以自由指定為其它字符串類型的用戶名。返回值：整型，0表示成功。示例 ret=SendEvent(1,2,"測試操作記錄",$UserName)；/在日志文件中記錄一條錯誤信息操作記錄，記錄內(nèi)容為“測試操作記錄”。SendKey語法 SendKey（AppId,Title, KeyDesc）說明 該函數(shù)用于向指定的窗口發(fā)送擊將擊鍵消息，就向在該窗口中用鍵盤輸入信息一樣。該函數(shù)與StartApp配合使用，讓力控

53、eq oac(,R)R可以控制其它應用程序。如啟動某一程序，然后讓其做某一動作，如執(zhí)行一菜單命令。參數(shù) AppID為應用程序標識，類型為整型，為由StartApp函數(shù)得到的返回值。Title 窗口標題，一般為程序最上面標題條中所顯示的內(nèi)容。用于準確指明程序中指定的窗口，如果為空" "，則為該程序中所有窗口。KeyDesc為字符串，表示一組鍵的序列。可以是多個鍵的組合。組合鍵間用“+”號分隔。如 “Alt+F+P”表示按下Alt鍵，然后按下F和P鍵。鍵代碼如下（注意：代碼要寫在引號內(nèi)）：Space 空格。Backspace 回退。Break 終止。Caps Lock 大小寫切

54、換。Delelte 刪除。End 末尾。Enter 回車。Esc 取消。Home 回頭。Insert 插入。Page Up 上一頁。Page Down 下一頁。Print Screen 拷屏。Tab 制表鍵。Shift 上擋鍵。Ctrl 控制鍵。% 百分號。Alt Alt鍵。功能鍵：F1到F12代表功能鍵；字母或數(shù)字鍵直接用其值來代表。示例 SendKey(appid, "","A");/按下字母A鍵。SendKey(appid, "","Ctrl + A"); /按下trl鍵后，再按下A鍵。SendKey(app

55、id, "","F1"); /按下功能鍵F1。SendKey(appid, "win1","Shift + F1"); /按下shift鍵后，再按下F1鍵。SetHisDataState（state type）語法 SetHisDataState（StateType）說明 設置取歷史數(shù)據(jù)函數(shù)的錯誤返回值的狀態(tài)值。當調(diào)用GetHisData時如果取值時間為不存在的值時,按照此函數(shù)的設置值返回不同的結(jié)果。參數(shù) StateType:狀態(tài)類型。0 - 調(diào)用GetHisData時如果取值時間為不存在的值時,返回最后的有效值。1 - 調(diào)用G