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

1、第二章 腳本函數(shù)12.1 系統(tǒng)函數(shù)12.2 數(shù)學(xué)函數(shù)172.3 配方函數(shù)202.4 SQL函數(shù)212.5 設(shè)備函數(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)”類(lèi)、“數(shù)學(xué)”類(lèi)、“配方”類(lèi)、“SQL查詢”類(lèi)、“設(shè)備操作”類(lèi)、“字符串操作”類(lèi)、“Window控件”類(lèi)和“內(nèi)置數(shù)據(jù)表”類(lèi)函數(shù)?！跋到y(tǒng)”類(lèi)、“字符串操作”類(lèi)、“Window控件”類(lèi)和“內(nèi)置數(shù)據(jù)表”類(lèi)包括數(shù)據(jù)轉(zhuǎn)換、文件操作、系統(tǒng)功能調(diào)用、對(duì)象操作等功能函數(shù)。 “數(shù)學(xué)”類(lèi)目前包含一組常用數(shù)學(xué)運(yùn)算函數(shù)； “配方”類(lèi)目前包含一組用于控制配方

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

36、.PV在本年本月昨日1821時(shí)的最小值。GetTagKind語(yǔ)法 GetTagKind(TagName, DataSource)說(shuō)明 獲取點(diǎn)類(lèi)型，即得到點(diǎn)在實(shí)時(shí)數(shù)據(jù)庫(kù)中的類(lèi)型號(hào)參數(shù) TagName: 點(diǎn)名稱(chēng)，字符串變量或常量。DataSource : 整型，數(shù)據(jù)源序號(hào)，數(shù)據(jù)源序號(hào)以0開(kāi)始，注意該序號(hào)會(huì)因數(shù)據(jù)源的刪減而變動(dòng)。返回值 點(diǎn)類(lèi)型號(hào)，整型。示例 KIND = GetTagKind(“FI1001”,0);GetUserCount語(yǔ)法 GetUserCount()說(shuō)明 獲得用戶列表中的數(shù)量。（已注冊(cè)的用戶）返回值 返回值類(lèi)型，整型。示例 KIND=GetUserCount()；/返回注冊(cè)用

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

38、中。Hide語(yǔ)法 Hide()說(shuō)明 隱藏圖形目標(biāo)。如果目標(biāo)處于隱藏狀態(tài)，它將不接受鼠標(biāo)動(dòng)作。但可以執(zhí)行雜項(xiàng)/一般動(dòng)作。備注 該函數(shù)只對(duì)圖元對(duì)象起作用HideWindow語(yǔ)法 HideWindow(WinNamede)說(shuō)明 隱藏名字為WinNamede的窗口。如果窗口處于隱藏狀態(tài)，它將不接受鼠標(biāo)動(dòng)作。但可以執(zhí)行雜項(xiàng)/一般動(dòng)作。參數(shù) 字符串。示例 HideWindow(“aaa”);InfoResource語(yǔ)法 InfoResource(ResourceType)說(shuō)明 返回系統(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、回當(dāng)前系統(tǒng)正在運(yùn)行的任務(wù)數(shù)。InsertHisData語(yǔ)法 InsertHisData (Var, Data, Year,Month,Day,Hour,Minute,Second,Millisec)說(shuō)明 向數(shù)據(jù)庫(kù)中插入歷史數(shù)據(jù)。參數(shù) Var: 該參數(shù)不能包含在""中。數(shù)據(jù)庫(kù)變量，該變量的數(shù)據(jù)源指明了向哪個(gè)數(shù)據(jù)庫(kù)插入數(shù)據(jù)，而其數(shù)據(jù)庫(kù)參數(shù)指明了是數(shù)據(jù)庫(kù)的哪點(diǎn)參數(shù)。必須為數(shù)值型變量。注意：要插入的值不是Var變量的當(dāng)前值，而是下一個(gè)參數(shù)Data。Data:要插入的數(shù)值，為數(shù)值型變量，常量或表達(dá)式。參數(shù)Year,Month,Day,Hour,Minute,Second, Milli

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

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

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

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

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

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

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

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

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

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

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

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

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

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

54、換。Delelte 刪除。End 末尾。Enter 回車(chē)。Esc 取消。Home 回頭。Insert 插入。Page Up 上一頁(yè)。Page Down 下一頁(yè)。Print Screen 拷屏。Tab 制表鍵。Shift 上擋鍵。Ctrl 控制鍵。% 百分號(hào)。Alt Alt鍵。功能鍵：F1到F12代表功能鍵；字母或數(shù)字鍵直接用其值來(lái)代表。示例 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）語(yǔ)法 SetHisDataState（StateType）說(shuō)明 設(shè)置取歷史數(shù)據(jù)函數(shù)的錯(cuò)誤返回值的狀態(tài)值。當(dāng)調(diào)用GetHisData時(shí)如果取值時(shí)間為不存在的值時(shí),按照此函數(shù)的設(shè)置值返回不同的結(jié)果。參數(shù) StateType:狀態(tài)類(lèi)型。0 - 調(diào)用GetHisData時(shí)如果取值時(shí)間為不存在的值時(shí),返回最后的有效值。1 - 調(diào)用G