MCGS系統(tǒng)內(nèi)部函數(shù)參考手冊(cè).doc

MCGS系統(tǒng)內(nèi)部函數(shù)MCGS內(nèi)部為用戶提供了一些常用的數(shù)學(xué)函數(shù)和對(duì)MCGS內(nèi)部對(duì)象操作的函數(shù)。組態(tài)時(shí)，可在表達(dá)式中或用戶腳本程序中直接使用這些函數(shù)。為了與其它名稱相區(qū)別，系統(tǒng)內(nèi)部函數(shù)的名稱一律以“！”符號(hào)開頭。下面分別介紹各個(gè)函數(shù)的用途和使用方法。運(yùn)行環(huán)境操作函數(shù)!CallBackSvr(DatName)函數(shù)意義：調(diào)用后臺(tái)對(duì)象返 回 值：數(shù)值型，后臺(tái)對(duì)象的值參 數(shù)：DatName，對(duì)象名，數(shù)值型 實(shí) 例：X=！CallBackSvr（X），調(diào)用后臺(tái)數(shù)值型對(duì)象X注 意：本函數(shù)在新版本MCGS系統(tǒng)內(nèi)部，已經(jīng)無(wú)效。為了保留與舊版本的兼容性，暫時(shí)保留。 !ChangeLoopStgy(StgyName，n)函數(shù)意義：改變循環(huán)策略的循環(huán)時(shí)間返 回 值：數(shù)值型。返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：StgyName，策略名；n，數(shù)值型，以毫秒數(shù)表示循環(huán)策略的循環(huán)時(shí)間實(shí) 例：!ChangeLoopStgy(報(bào)警策略，5000)，將報(bào)警策略的循環(huán)時(shí)間改為為5秒!CloseAllWindow(WndName)函數(shù)意義：關(guān)閉所有窗口，如果在字符串”WndName”中指定了一個(gè)窗口，則打開這個(gè)窗口，關(guān)閉其他窗口。如果”WndName”為空串，則關(guān)閉所有窗口。返 回 值：數(shù)值型。返回值：=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：WndName， 用戶窗口名，字符型。實(shí) 例：!CloseAllWindow(“工況圖”)，關(guān)閉除了用戶窗口“工況圖”以外的其他窗口，若“工況圖”窗口沒(méi)有打開，則在關(guān)閉其他窗口的同時(shí)打開該窗口!CloseAllWindow(“”)，關(guān)閉所有窗口。!EnableStgy(StgyName，n)函數(shù)意義：打開或關(guān)閉某個(gè)策略，如報(bào)警策略或循環(huán)策略等。返 回 值：數(shù)值型。返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：StgyName，策略名；n，數(shù)值型，為1時(shí)表示打開此策略，為0時(shí)表示關(guān)閉此策略。實(shí) 例：!EnableStgy(報(bào)警策略，1)， 打開報(bào)警策略；!EnableStgy(報(bào)警策略，0)， 關(guān)閉報(bào)警策略，使報(bào)警策略無(wú)效!GetDeviceName(Index)函數(shù)意義：按設(shè)備順序取到設(shè)備的名字。返 回 值：字符型。調(diào)用成功返回設(shè)備名，調(diào)用失敗時(shí)返回空字符串。參 數(shù)：Index，數(shù)值型。實(shí) 例：!GetDeviceName(0) ，取0號(hào)設(shè)備構(gòu)件的名稱。!GetDeviceState(DevName)函數(shù)意義：按設(shè)備名查詢?cè)O(shè)備的狀態(tài)。返 回 值：數(shù)值型。=-1調(diào)用不正常。=1 設(shè)備處于正常的工作狀態(tài)。=2 設(shè)備正在工作，但設(shè)備不正常。=3 設(shè)備處于停止工作狀態(tài)，且設(shè)備正常。=4 設(shè)備處于停止?fàn)顟B(tài)，且設(shè)備有錯(cuò)。參 數(shù)：DevName，設(shè)備名，字符型。實(shí) 例：!GetDeviceState( OmronPLC)，讀取設(shè)備構(gòu)件“OmronPLC”的當(dāng)前工作狀態(tài)。!GetStgyName(Index)函數(shù)意義：按運(yùn)行策略的順序獲得各策略塊的名字。返 回 值：字符型。參 數(shù)：Index，數(shù)值型。實(shí) 例：!GetStgyName(0)，取0號(hào)運(yùn)行策略的名稱。!GetWindowName(Index)函數(shù)意義：按用戶窗口的順序獲得用戶窗口的名字。返 回 值：字符型。參 數(shù)：Index， 數(shù)值型。實(shí) 例：!GetWindowName(0) ，讀取0號(hào)用戶窗口的名稱。!GetWindowState(WndName)函數(shù)意義：按照名字取得用戶窗口的狀態(tài)。返 回 值：數(shù)值型。返回0：用戶窗口處于關(guān)閉狀態(tài)。返回1：用戶窗口處于打開狀態(tài)。返回2：用戶窗口處于隱藏狀態(tài)。參 數(shù)：WndName，用戶窗口名稱，字符型。實(shí) 例：!GetWindowState(工況圖)，獲得用戶窗口“工況圖”的狀態(tài)!SetActiveX(Activename，n，str)函數(shù)意義：操作指定的動(dòng)畫構(gòu)件， 向窗口中的ActiveX控件發(fā)出控件命令返 回 值：無(wú)參 數(shù)：Activename，字符型，控件名稱，用“.”分割窗口名和控件名，如:窗口0.控件1表示在用戶窗口“窗口0”中的名為“控件1”的控件。n，數(shù)值型，命令類型，請(qǐng)?zhí)?；str，字符型，命令字符串，具體含義請(qǐng)參照控件幫助。實(shí) 例：!SetActiveX(“窗口0.控件0”,1,”start”)，啟動(dòng)窗口0的控件0開始工作。!SetDevice(DevName，DevOp，CmdStr)函數(shù)意義：按照設(shè)備名字對(duì)設(shè)備進(jìn)行操作。返 回 值：數(shù)值型。返回值：=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DevName，設(shè)備名，字符型；DevOp，設(shè)備操作碼，數(shù)值型；CmdStr，設(shè)備命令字符串，只有當(dāng)DevOp=6時(shí)CmdStr才有意義。DevOp取值范圍及相應(yīng)含義：1：?jiǎn)?dòng)設(shè)備開始工作。2：停止設(shè)備的工作使其處于停止?fàn)顟B(tài)。3：測(cè)試設(shè)備的工作狀態(tài)。4：?jiǎn)?dòng)設(shè)備工作一次。5：改變?cè)O(shè)備的工作周期，CmdStr中包含新的工作周期，單位為ms。6：執(zhí)行指定的設(shè)備命令，CmdStr中包含指定命令的格式。實(shí) 例：!SetDevice(OmronPLC，1， )，啟動(dòng)設(shè)備構(gòu)件“OmronPLC”開始工作。!SetStgy(StgyName)函數(shù)意義：執(zhí)行StgyName指定的運(yùn)行策略。返 回 值：數(shù)值型。返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：StgyName，策略名，字符型。實(shí) 例：!SetStgy(閥門關(guān)閉)，執(zhí)行一次運(yùn)行策略“閥門關(guān)閉”。!SetWindow(WndName，Op)函數(shù)意義：按照名字操作用戶窗口，如打開、關(guān)閉、打印。返 回 值：數(shù)值型。返回值：=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：WndName， 用戶窗口名， 字符型。Op: 操作用戶窗口的方法，數(shù)值型。Op=1：打開窗口并使其可見。Op=2：打開窗口并使其不可見。Op=3：關(guān)閉窗口。Op=4：打印窗口。Op=5：刷新窗口。實(shí) 例：!SetWindow(工況圖，1)，打開用戶窗口“工況圖”，并使其可見。!SysWindow()函數(shù)意義：執(zhí)行該函數(shù)后，打開用戶窗口管理窗口，在管理窗口中可以選擇打開或關(guān)閉指定的用戶窗口。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!SysWindow()!DisableCtrlAltDel()函數(shù)意義：屏蔽熱鍵Ctrl+Alt+Del的功能。無(wú)法打開任務(wù)管理器窗口或執(zhí)行鎖定計(jì)算機(jī)注銷關(guān)機(jī)密碼修改等操作。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!DisableCtrlAltDel()注 意此函數(shù)在網(wǎng)絡(luò)版客戶端和WIN98操作系統(tǒng)下無(wú)效。!EnableCtrlAltDel()函數(shù)意義：恢復(fù)熱鍵Ctrl+Alt+Del的功能。使用任務(wù)管理器關(guān)閉不響應(yīng)的程序或執(zhí)行鎖定計(jì)算機(jī)注銷關(guān)機(jī)修改密碼等,為了維護(hù)系統(tǒng)安全的操作。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!EnableCtrlAltDel()注 意：1. 不要把這兩個(gè)腳本函數(shù)同時(shí)使用，否則，看不到任何效果，沒(méi)有任何意義；2. 不要把這兩個(gè)函數(shù)放到循環(huán)中使用；3. 在使用這2個(gè)腳本函數(shù)時(shí)，最好與登錄密碼同時(shí)使用，以達(dá)到真正的熱鍵屏蔽效果。4. 此函數(shù)在網(wǎng)絡(luò)版客戶端和WIN98操作系統(tǒng)下無(wú)效。 !RestartProject()函數(shù)意義：當(dāng)檢查組態(tài)工程在運(yùn)行過(guò)程中出現(xiàn)非正常狀態(tài)，可以調(diào)用該函數(shù)重新啟動(dòng)運(yùn)行環(huán)境。該功能必須在加密狗生效時(shí)方可工作。返 回 值：無(wú)。參 數(shù)：無(wú)。實(shí) 例：!RestartProject()數(shù)據(jù)對(duì)象操作函數(shù)!AnswerAlm(DatName)函數(shù)意義：應(yīng)答數(shù)據(jù)對(duì)象DatName所產(chǎn)生的報(bào)警。如對(duì)應(yīng)的數(shù)據(jù)對(duì)象沒(méi)有報(bào)警產(chǎn)生或已經(jīng)應(yīng)答，則本函數(shù)無(wú)效。返 回 值：數(shù)值型，=0為操作成功；0為操作失敗。參 數(shù)：DatName，數(shù)據(jù)對(duì)象名；實(shí) 例：!AnswerAlm(電機(jī)溫度)，應(yīng)答數(shù)據(jù)對(duì)象“電機(jī)溫度”所產(chǎn)生的報(bào)警。!ChangeDataSave(Datname，n)函數(shù)意義：改變數(shù)據(jù)對(duì)象Datname存盤的周期。返 回 值：數(shù)值型，=0為操作成功；0為操作失敗。參 數(shù)：Datname，數(shù)據(jù)對(duì)象名；n，數(shù)值型，以秒表示的存盤間隔時(shí)間實(shí) 例：ChangeDataSave(溫度，5)， 溫度的存盤間隔時(shí)間為5秒!ChangeSaveDat(DatName，Num1，Num2)函數(shù)意義：改變數(shù)據(jù)對(duì)象DatName所對(duì)應(yīng)存盤數(shù)據(jù)的存盤間隔，把Num1小時(shí)以前的存盤數(shù)據(jù)（以當(dāng)前時(shí)間為0點(diǎn)）的存盤間隔改為Num2秒。本操作只對(duì)組對(duì)象有效，對(duì)單個(gè)的數(shù)據(jù)對(duì)象無(wú)效。當(dāng)DataName =空字符，或Num1=0或Num2=0時(shí)，本操作無(wú)效。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名。Num1：數(shù)值型時(shí)間量，單位：小時(shí)。本函數(shù)用Num10的一些數(shù)值來(lái)表示一些特殊意義的操作：=-1 改變當(dāng)天對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤數(shù)據(jù)的存盤間隔；=-2 改變昨天對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤數(shù)據(jù)的存盤間隔；=-3 改變本星期對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤數(shù)據(jù)的存盤間隔；=-4 改變上星期對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤數(shù)據(jù)的存盤間隔；=-5 改變本月對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤數(shù)據(jù)的存盤間隔；=-6 改變上個(gè)月對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤數(shù)據(jù)的存盤間隔；Num2：數(shù)值型時(shí)間量，新的存盤間隔，單位：秒。實(shí) 例：! ChangeSaveDat(電機(jī)1， -2， 5)，把組對(duì)象“電機(jī)1”對(duì)應(yīng)的存盤數(shù)據(jù)中昨天的存盤數(shù)據(jù)的存盤間隔改為5秒鐘。!CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag )函數(shù)意義：拷貝數(shù)據(jù)庫(kù)中數(shù)據(jù)表的數(shù)據(jù)返 回 值：開關(guān)型，返回值=0：調(diào)用正常；返回值0：調(diào)用不正常。參 數(shù)：Tdb，目標(biāo)數(shù)據(jù)庫(kù)名；Sdb，源數(shù)據(jù)庫(kù)名；TabName，數(shù)據(jù)表名；TimeField，定義的時(shí)間字段名；Flag，拷貝方式，0：覆蓋拷貝；1：添加拷貝。實(shí) 例： ！CopySaveDat（Tdb，Sdb，TabName，TimeField，0），將數(shù)據(jù)庫(kù)Sdb中表TabName中的數(shù)據(jù)拷貝到數(shù)據(jù)庫(kù)Tdb中，表名仍是TabName，定義的時(shí)間字段為TimeField，拷貝方式為覆蓋拷貝。!DelAllSaveDat(DatName)函數(shù)意義：刪除數(shù)據(jù)對(duì)象DatName對(duì)應(yīng)的所有存盤數(shù)據(jù)。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName，數(shù)據(jù)對(duì)象名。實(shí) 例：! DelAllSaveDat(電機(jī)溫度) ，刪除數(shù)據(jù)對(duì)象“電機(jī)溫度”對(duì)應(yīng)的所有存盤數(shù)據(jù)。!DelAllAlmDat（DatName）函數(shù)意義：刪除數(shù)據(jù)對(duì)象DataName對(duì)應(yīng)的所有報(bào)警存盤數(shù)據(jù)。注意，此函數(shù)不能用來(lái)刪除組對(duì)象所對(duì)應(yīng)的報(bào)警存盤數(shù)據(jù)。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名；實(shí) 例：！DelAllAlmDat（電機(jī)溫度），刪除數(shù)據(jù)對(duì)象“電機(jī)溫度”對(duì)應(yīng)的所有報(bào)警存盤數(shù)據(jù)!DelAlmDat(DatName，Num)函數(shù)意義：刪除數(shù)據(jù)對(duì)象DataName對(duì)應(yīng)的報(bào)警存儲(chǔ)數(shù)據(jù)中最早Num小時(shí)內(nèi)的報(bào)警存儲(chǔ)數(shù)據(jù)，如Num=0或DatName=空字符，則該函數(shù)無(wú)效。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名；Num：數(shù)值型時(shí)間值，單位：小時(shí)。實(shí) 例：! DelAlmDat(電機(jī)溫度，1)，刪除數(shù)據(jù)對(duì)象“電機(jī)溫度”對(duì)應(yīng)的報(bào)警存盤數(shù)據(jù)中最早1小時(shí)內(nèi)的數(shù)據(jù)。!DelSaveDat(DatName，Num)函數(shù)意義：刪除數(shù)據(jù)對(duì)象DataName對(duì)應(yīng)的存盤數(shù)據(jù)中最早Num小時(shí)內(nèi)的存盤數(shù)據(jù)，如Num=0或DatName=空字符，則該函數(shù)無(wú)效。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名；Num：數(shù)值型時(shí)間值，單位：小時(shí)。實(shí) 例：! DelSaveDat(電機(jī)溫度，12) ，刪除數(shù)據(jù)對(duì)象“電機(jī)溫度”對(duì)應(yīng)的存盤數(shù)據(jù)中最早12小時(shí)內(nèi)的數(shù)據(jù)。!EnableAlm(name，n)函數(shù)意義：打開/關(guān)閉數(shù)據(jù)對(duì)象的報(bào)警功能。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：name，變量名；n，數(shù)值型，1表示打開報(bào)警，0表示關(guān)閉報(bào)警實(shí) 例：!EnableAlm(電機(jī)溫度，1)， 打開電機(jī)溫度的報(bào)警功能!EnableDataSave(name，n)函數(shù)意義：打開/關(guān)閉數(shù)據(jù)對(duì)象的定時(shí)存盤功能。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：name，數(shù)據(jù)對(duì)象名；n，數(shù)值型，1表示打開定時(shí)存盤，0表示關(guān)閉定時(shí)存盤實(shí) 例：!EnableDataSave(溫度，1)， 打開溫度的定時(shí)存盤!GetAlmValue(DatName，Value，F(xiàn)lag)函數(shù)意義：讀取數(shù)據(jù)對(duì)象DatName報(bào)警限值，只有在數(shù)據(jù)對(duì)象DatName的“允許進(jìn)行報(bào)警處理”屬性選項(xiàng)被選中后，本函數(shù)的操作才有意義。對(duì)組對(duì)象、字符型數(shù)據(jù)對(duì)象、事件型數(shù)據(jù)對(duì)象本函數(shù)無(wú)效。對(duì)數(shù)值型數(shù)據(jù)對(duì)象，用Flag來(lái)標(biāo)識(shí)讀取何種報(bào)警限值。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名。Value：DataName的當(dāng)前的報(bào)警限值，數(shù)值型。Flag：數(shù)值型，標(biāo)志要讀取何種限值，具體意義如下：=1下下限報(bào)警值；=2 下限報(bào)警值；=3 上限報(bào)警值；=4 上上限報(bào)警值；=5 下偏差報(bào)警限值；=6 上偏差報(bào)警限值；=7 偏差報(bào)警基準(zhǔn)值；實(shí) 例：! GetAlmValue(電機(jī)溫度， Value， 3)，讀取數(shù)據(jù)對(duì)象“電機(jī)溫度”的報(bào)警上限值，放入數(shù)值型數(shù)據(jù)對(duì)象Value中。!GetEventDT(EvName)函數(shù)意義：返回當(dāng)前事件和上一次事件之間的時(shí)間差，單位為秒。返 回 值：數(shù)值型。返回的時(shí)間差參 數(shù)：EvName，事件變量名，事件型。實(shí) 例：!GetEventDT(EvName)，取事件變量EvName當(dāng)前事件和上一次事件之間的時(shí)間差，單位為秒。!GetEventP(EvName)函數(shù)意義：取到當(dāng)前事件的附加說(shuō)明字符串。返 回 值：字符型。返回的附加說(shuō)明字符串。參 數(shù)：EvName，事件變量名，事件型。實(shí) 例：!GetEventP(EvName) ，取事件型變量EvName的當(dāng)前事件的附加說(shuō)明字符串。!GetEventT(EvName)函數(shù)意義：取到當(dāng)前事件產(chǎn)生的時(shí)間，以秒為單位，相對(duì)于1980年以來(lái)的秒數(shù)。如沒(méi)有事件產(chǎn)生，返回-1。返 回 值：數(shù)值型。參 數(shù)：EvName，事件變量名，事件型。實(shí) 例：!GetEventT(EvName)，取事件型變量EvName的當(dāng)前事件產(chǎn)生時(shí)刻。!MoveAlmDat(DatName，F(xiàn)ileName，Num1，Num2，F(xiàn)lag)函數(shù)意義：把數(shù)據(jù)對(duì)象DatName所對(duì)應(yīng)的報(bào)警存盤信息中的第Num1小時(shí)到Num1+Num2小時(shí)內(nèi)（以當(dāng)前時(shí)間為0點(diǎn)）的報(bào)警存盤信息提取出來(lái)，轉(zhuǎn)存到FileName所指定的數(shù)據(jù)庫(kù)文件中（Access數(shù)據(jù)庫(kù)）。當(dāng)DatName=空字符，或FileName=空字符，或Num20時(shí)，本函數(shù)無(wú)效。刪除數(shù)據(jù)對(duì)象DatName對(duì)應(yīng)的所有報(bào)警存儲(chǔ)數(shù)據(jù)。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名。FileName：新的報(bào)警存盤文件名(包括路徑)，字符型。Num1：數(shù)值型時(shí)間量，單位：小時(shí)。本函數(shù)用Num10的一些數(shù)值來(lái)表示一些特殊意義的操作（此時(shí)Num2無(wú)效）：=-1 轉(zhuǎn)存當(dāng)天的所有報(bào)警信息存盤數(shù)據(jù)；=-2 轉(zhuǎn)存昨天的所有報(bào)警信息存盤數(shù)據(jù)；=-3 轉(zhuǎn)存本星期的所有報(bào)警信息存盤數(shù)據(jù)；=-4 轉(zhuǎn)存上星期的所有報(bào)警信息存盤數(shù)據(jù)；=-5 轉(zhuǎn)存本月的所有報(bào)警信息存盤數(shù)據(jù)；=-6 轉(zhuǎn)存上個(gè)月的所有報(bào)警信息存盤數(shù)據(jù)；Num2：數(shù)值型時(shí)間量，單位：小時(shí)。Flag：轉(zhuǎn)存標(biāo)志，數(shù)值型。Flag=0時(shí)，創(chuàng)建一個(gè)新文件(如原文件已存在，則把原文件改名為*.BK1)；Flag=1時(shí)，在原有的基礎(chǔ)上增加新的數(shù)據(jù)。實(shí) 例：!MoveAlmDat(電機(jī)溫度， D:Tempttt.mdb，-6，0，1)，把數(shù)據(jù)對(duì)象“電機(jī)溫度”對(duì)應(yīng)的報(bào)警存盤數(shù)據(jù)中的上個(gè)月的所有報(bào)警信息存盤數(shù)據(jù)轉(zhuǎn)存添加到數(shù)據(jù)庫(kù)文件D:Tempttt.mdb中。!MoveSaveDat(DatName，F(xiàn)ileName，Num1，Num2，F(xiàn)lag)函數(shù)意義：把數(shù)據(jù)對(duì)象DatName所對(duì)應(yīng)的存盤數(shù)據(jù)中的第Num1小時(shí)到Num1+Num2小時(shí)內(nèi)（以當(dāng)前時(shí)間為0點(diǎn)）的存盤數(shù)據(jù)提取出來(lái)，轉(zhuǎn)存到FileName所指定的數(shù)據(jù)庫(kù)文件中（Access數(shù)據(jù)庫(kù)）。當(dāng)DatName=空字符，或FileName=空字符，或Num20時(shí)，本函數(shù)無(wú)效。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名。FileName：新的存盤數(shù)據(jù)文件名(包括路徑)，字符型。Num1：數(shù)值型時(shí)間量，單位：小時(shí)。本函數(shù)用Num10的一些數(shù)值來(lái)表示一些特殊意義的操作（此時(shí)Num2無(wú)效）：=-1 轉(zhuǎn)存當(dāng)天對(duì)應(yīng)數(shù)據(jù)對(duì)象的所有存盤數(shù)據(jù)；=-2 轉(zhuǎn)存昨天對(duì)應(yīng)數(shù)據(jù)對(duì)象的所有存盤數(shù)據(jù)；=-3 轉(zhuǎn)存本星期對(duì)應(yīng)數(shù)據(jù)對(duì)象的所有存盤數(shù)據(jù)；=-4 轉(zhuǎn)存上星期對(duì)應(yīng)數(shù)據(jù)對(duì)象的所有存盤數(shù)據(jù)；=-5 轉(zhuǎn)存本月對(duì)應(yīng)數(shù)據(jù)對(duì)象的所有存盤數(shù)據(jù)；=-6 轉(zhuǎn)存上個(gè)月對(duì)應(yīng)數(shù)據(jù)對(duì)象的所有存盤數(shù)據(jù)；Num2：數(shù)值型時(shí)間量，單位：小時(shí)。Flag：轉(zhuǎn)存標(biāo)志，數(shù)值型。Flag=0時(shí)，創(chuàng)建一個(gè)新文件(如原文件已存在，則把原文件改名為*.BK1)；Flag=1時(shí)，在原有的基礎(chǔ)上增加新的數(shù)據(jù)。實(shí) 例：! MoveSaveDat(電機(jī)溫度， D:Tempttt.mdb，-6，0，1) 把數(shù)據(jù)對(duì)象“電機(jī)溫度”對(duì)應(yīng)的存盤數(shù)據(jù)中的上個(gè)月的所有存盤數(shù)據(jù)轉(zhuǎn)存添加到數(shù)據(jù)庫(kù)文件“D:Tempttt.mdb”中。!SaveData(DatName)函數(shù)意義：把數(shù)據(jù)對(duì)象DataName對(duì)應(yīng)的當(dāng)前值存入存盤數(shù)據(jù)庫(kù)中。本函數(shù)的操作使對(duì)應(yīng)的數(shù)據(jù)對(duì)象的值存盤一次。此數(shù)據(jù)對(duì)象必須具有存盤屬性，且存盤時(shí)間需設(shè)為0秒。否則會(huì)操作失敗。返 回 值：數(shù)值型，=0為操作成功；0為操作失敗。參 數(shù)：DatName，數(shù)據(jù)對(duì)象名。實(shí) 例：! SaveData(電機(jī)1)，把組對(duì)象“電機(jī)1”的所有成員對(duì)應(yīng)的當(dāng)前值存盤一次。!SaveDataInit()函數(shù)意義：本操作把設(shè)置有“退出時(shí)自動(dòng)保存數(shù)據(jù)對(duì)象的當(dāng)前值作為初始值”屬性的數(shù)據(jù)對(duì)象的當(dāng)前值存入組態(tài)結(jié)果數(shù)據(jù)中作為初始值，防止突然斷電而無(wú)法保存，以便MCGS下次啟動(dòng)時(shí)這些數(shù)據(jù)對(duì)象能自動(dòng)恢復(fù)其值。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：無(wú)。實(shí) 例：! SaveDataInit()!SaveDataOnTime(Time，TimeMS,DataName)函數(shù)意義：使用指定時(shí)間保存數(shù)據(jù)。本函數(shù)通常用于指定時(shí)間來(lái)保存數(shù)據(jù)，實(shí)現(xiàn)與通常機(jī)制不一樣的存盤方法。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：Time，整型，使用時(shí)間函數(shù)轉(zhuǎn)換出的時(shí)間量。時(shí)間精度到秒。TimeMS，整型，指定存盤時(shí)間的毫秒數(shù)。DataName， 數(shù)據(jù)對(duì)象名。實(shí) 例：t = !TimeStr2I(“2001年2月21日3時(shí)2分3秒”)!SaveDataOnTime (t，0,DataGroup)， 按照指定時(shí)間保存數(shù)據(jù)對(duì)象!SaveSingleDataInit(Name)函數(shù)意義：本操作把數(shù)據(jù)對(duì)象的當(dāng)前值設(shè)置為初始值（不管該對(duì)象是否設(shè)置有“退出時(shí)自動(dòng)保存數(shù)據(jù)對(duì)象的當(dāng)前值作為初始值”屬性），防止突然斷電而無(wú)法保存，以便MCGS下次啟動(dòng)時(shí)這些數(shù)據(jù)對(duì)象能自動(dòng)恢復(fù)其值。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：Name，數(shù)據(jù)對(duì)象名。實(shí) 例：!SaveSingleDataInit(溫度)，把溫度的當(dāng)前值設(shè)置成初始值。!SetAlmValue(DatName，Value，F(xiàn)lag)函數(shù)意義：設(shè)置數(shù)據(jù)對(duì)象DatName對(duì)應(yīng)的報(bào)警限值，只有在數(shù)據(jù)對(duì)象DatName“允許進(jìn)行報(bào)警處理”的屬性被選中后，本函數(shù)的操作才有意義。對(duì)組對(duì)象、字符型數(shù)據(jù)對(duì)象、事件型數(shù)據(jù)對(duì)象本函數(shù)無(wú)效。對(duì)數(shù)值型數(shù)據(jù)對(duì)象，用Flag來(lái)標(biāo)識(shí)改變何種報(bào)警限值。返 回 值：數(shù)值型，返回值=0：調(diào)用正常；0：調(diào)用不正常。參 數(shù)：DatName：數(shù)據(jù)對(duì)象名。Value：新的報(bào)警值，數(shù)值型。Flag：數(shù)值型，標(biāo)志要操作何種限值，具體意義如下：=1下下限報(bào)警值；=2下限報(bào)警值；=3上限報(bào)警值；=4上上限報(bào)警值；=5下偏差報(bào)警限值；=6上偏差報(bào)警限值；=7偏差報(bào)警基準(zhǔn)值；實(shí) 例：! SetAlmValue(電機(jī)溫度， 200， 3)，把數(shù)據(jù)對(duì)象“電機(jī)溫度”的報(bào)警上限值設(shè)為200用戶登錄操作函數(shù)!ChangePassword()函數(shù)意義：彈出密碼修改窗口，供當(dāng)前登錄的用戶修改密碼。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!ChangePassword()!CheckUserGroup(strUserGroup)函數(shù)意義：檢查當(dāng)前登錄的用戶是否屬于strUserGroup用戶組的成員。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：strUserGroup，字符型，用戶組的名稱。實(shí) 例：! CheckUserGroup(管理員組)!Editusers()函數(shù)意義：彈出用戶管理窗口，供管理員組的操作者配置用戶。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!Editusers()!EnableExitLogon(n)函數(shù)意義：打開/關(guān)閉退出時(shí)的權(quán)限檢查返 回 值：無(wú)參 數(shù)：n，數(shù)值型，為1時(shí)表示在退出時(shí)進(jìn)行權(quán)限檢查，當(dāng)權(quán)限不足時(shí)，會(huì)進(jìn)行提示。為0則退出時(shí)不進(jìn)行權(quán)限檢查。實(shí) 例：!EnableExitLogon(1)， 在退出時(shí)進(jìn)行權(quán)限檢查!EnableExitPrompt (n)函數(shù)意義：打開/關(guān)閉退出時(shí)的提示信息返 回 值：無(wú)參 數(shù)：n，數(shù)值型，為1時(shí)表示在退出時(shí)彈出提示信息對(duì)話框。為0則退出時(shí)不出現(xiàn)信息對(duì)話框。實(shí) 例：!EnableExitLogon(1)， 在退出時(shí)彈出提示信息對(duì)話框!GetCurrentGroup()函數(shù)意義：讀取當(dāng)前登錄用戶的所在用戶組名。返 回 值：字符型，當(dāng)前登錄用戶組名，如沒(méi)有登錄返回空。參 數(shù)：無(wú)。實(shí) 例：!GetCurrentGroup()!GetCurrentUser()函數(shù)意義：讀取當(dāng)前登錄用戶的用戶名。返 回 值：字符型，當(dāng)前登錄用戶的用戶名，如沒(méi)有登錄返回空。參 數(shù)：無(wú)。實(shí) 例：!GetCurrentUser()!LogOff()函數(shù)意義：注銷當(dāng)前用戶。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!LogOff()!LogOn()函數(shù)意義：彈出登錄對(duì)話框。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!LogOn()!GetUserNameByIndex()函數(shù)意義：按索引號(hào)取得當(dāng)前用戶名。返 回 值：字符型。與索引號(hào)相對(duì)應(yīng)的當(dāng)前用戶名。參 數(shù)：索引號(hào)值。實(shí) 例：!GetUserNameByIndex(0) ,索引為0的用戶名稱。!GetGroupNameByIndex()函數(shù)意義：按索引號(hào)取得當(dāng)前用戶組名。返 回 值：字符型。與索引號(hào)相對(duì)應(yīng)的當(dāng)前用戶組名。參 數(shù)：索引號(hào)值。實(shí) 例：!GetGroupNameByIndex(0) ,索引為0的用戶組名稱。!GetProjectTotalUsers ()函數(shù)意義：取得當(dāng)前工程用戶總數(shù)。返 回 值：開關(guān)型。當(dāng)前工程用戶總數(shù)。參 數(shù)：無(wú)實(shí) 例： !GetProjectTotalUsers(),激活該函數(shù),取得當(dāng)前工程的用戶總數(shù)。字符串操作函數(shù)!Ascii2I(s)函數(shù)意義：返回字符串s的首字母的Ascii值。返 回 值：開關(guān)型。參 數(shù)：s， 字符型。實(shí) 例：!Ascii2I(“Afd”) =65!Bin2I(s)函數(shù)意義：把二進(jìn)制字符串轉(zhuǎn)換為數(shù)值。返 回 值：開關(guān)型。參 數(shù)：s， 字符型。實(shí) 例：!Bin2I(“101”) =5!Format(n，str)函數(shù)意義：格式化數(shù)值型數(shù)據(jù)對(duì)象返 回 值：字符型。參 數(shù)：n，數(shù)值型，要格式化的數(shù)值；str，字符型，格式化數(shù)值的格式。表示為0.00樣式。小數(shù)點(diǎn)后的0的個(gè)數(shù)表示需要格式化出的小數(shù)位數(shù)。小數(shù)點(diǎn)前的0為一個(gè)時(shí)，表示小數(shù)點(diǎn)前根據(jù)實(shí)際數(shù)值顯示。當(dāng)小數(shù)點(diǎn)前沒(méi)有0時(shí)，表示為.xx式樣，當(dāng)小數(shù)點(diǎn)前的0不止一個(gè)時(shí)，使用0來(lái)填充不夠的位數(shù)。實(shí) 例：!Format(1.236，0.00) = 1.24；!Format(1.236，.00) = .24；!Format(1.236，00.00) = 01.24；!Hex2I(s)函數(shù)意義：把16進(jìn)制字符串轉(zhuǎn)換為數(shù)值。返 回 值：開關(guān)型。參 數(shù)：s， 字符型。實(shí) 例：!Hex2I (“11”) =17!I2Ascii(s)函數(shù)意義：返回指定Ascii值的字符。返 回 值：字符型。參 數(shù)：s， 開關(guān)型。實(shí) 例：!I2Ascii(65) =”A”!I2Bin(s)函數(shù)意義：把數(shù)值轉(zhuǎn)換為二進(jìn)制字符串。返 回 值：字符型。參 數(shù)：s，開關(guān)型。實(shí) 例：!I2Bin (5) =“101”!I2Hex(s)函數(shù)意義：把數(shù)值轉(zhuǎn)換為16進(jìn)制字符串。返 回 值：字符型。參 數(shù)：s，開關(guān)型。實(shí) 例：!I2Hex (17) =“11”!I2Oct(s)函數(shù)意義：把數(shù)值轉(zhuǎn)換為8進(jìn)制字符串。返 回 值：字符型。參 數(shù)：s，開關(guān)型。實(shí) 例：!I2Oct (9) =“11”!InStr(n，str1，str2)函數(shù)意義：查找一字符串在另一字符串中最先出現(xiàn)的位置返 回 值：數(shù)值型。參 數(shù)：n，數(shù)值型，開始搜索的位置；str1，字符串，被搜索的字符串；str2，字符串，要搜索的字符串實(shí) 例：!InStr(3，sdlkfjwe，we) = 7實(shí) 例：!InStr(1，wesdlkfjwe，we) = 1,表示從str1字符串的第一個(gè)字符位置搜索str2字符串，返回最先出現(xiàn)的位置!Lcase(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str的所有字符轉(zhuǎn)換成小寫。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!LCase(sedERT) = sedert!Left(str，n)函數(shù)意義：字符型數(shù)據(jù)對(duì)象str左邊起，取n個(gè)字符。返 回 值：字符型。參 數(shù)：str：字符型，源字符串；n，數(shù)值型，取字符個(gè)數(shù)。實(shí) 例：!Left(ABCDEFG，2) =AB!Len(Str)函數(shù)意義：求字符型數(shù)據(jù)對(duì)象str的字符串長(zhǎng)度（字符個(gè)數(shù)）。返 回 值：數(shù)值型。參 數(shù)：str， 字符型。實(shí) 例：!Len(ABCDEFG) = 7!Ltrim(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str中最左邊的空格剔除。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!LTrim( dsfk ) = dsfk !lVal(str)函數(shù)意義：將數(shù)值類字符串轉(zhuǎn)化為長(zhǎng)整型數(shù)值返 回 值：開關(guān)型，轉(zhuǎn)換出的數(shù)值。參 數(shù)：str，字符型。要求待轉(zhuǎn)換的字符串為數(shù)值類字符串實(shí) 例：!lVal(“12345678”)=12345678!Mid(str，n，k)函數(shù)意義：從字符型數(shù)據(jù)對(duì)象str左邊第n個(gè)字符起，取k個(gè)字符。返 回 值：字符型。參 數(shù)：str， 字符型，源字符串；n， 數(shù)值型，起始位置；k， 數(shù)值型，取字符數(shù)。實(shí) 例：!Mid(ABCDEFG，3，2) = CD!Oct2I(s)函數(shù)意義：把8進(jìn)制字符串轉(zhuǎn)換為數(shù)值。返 回 值：開關(guān)型。參 數(shù)：s， 字符型。實(shí) 例：!Oct2I (“11”) =9!Right(str，n)函數(shù)意義：從字符型數(shù)據(jù)對(duì)象str右邊起，取n個(gè)字符。返 回 值：字符型。參 數(shù)：str，字符型，源字符串；n，數(shù)值型，取字符個(gè)數(shù)。實(shí) 例：!Right(ABCDEFG，2) =FG!Rtrim(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str中最右邊的空格剔除。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!LTrim( dsfk ) = dsfk!Str(x)函數(shù)意義：將數(shù)值型數(shù)據(jù)對(duì)象x的值轉(zhuǎn)換成字符串。返 回 值：字符型。參 數(shù)：x， 數(shù)值型。實(shí) 例：!Str(0.712) =0.712!StrComp(str1，str2)函數(shù)意義：比較字符型數(shù)據(jù)對(duì)象str1和str2是否相等，返回值為0時(shí)相等，否則不相等。不區(qū)分大小寫字母。返 回 值：數(shù)值型。參 數(shù)：str1， 字符型；str2， 字符型。實(shí) 例：!StrComp(ABC,abc) = 0!StrFormat(FormatStr,任意個(gè)數(shù)變量)函數(shù)意義：格式化字符串，可以格式化任意多個(gè)數(shù)值。使用方法為!StrFormat(“%d”,23)或!StrFormat(“%g-%g-%g”,2.3,2.1,2.2)等，類似C語(yǔ)言中的Printf的語(yǔ)法。返 回 值：字符型。參 數(shù)：FormatStr，字符型，格式化字符串，如：“%d”、 “%g”。后面的參數(shù)可以任意多個(gè)。實(shí) 例：!StrFormat(%g-%g,12,12.34)= 12-12.34注 意：輸出多個(gè)數(shù)值時(shí)，可以使用在多個(gè)格式化字符串之間，添加分格符的方法，區(qū)別任意個(gè)數(shù)的輸出變量。如：%g-%g、%g-%g-%g。!Trim(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str中左右兩端的空格剔除。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!Trim( dsfk ) =dsfk!Ucase(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str的所有字符轉(zhuǎn)換成大寫。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!UCase(sedERT) =SEDERT!Val(str)函數(shù)意義：把數(shù)值類字符型數(shù)據(jù)對(duì)象str的值轉(zhuǎn)換成數(shù)值。返 回 值：數(shù)值型。參 數(shù)：str， 字符型。實(shí) 例：!Val(0.712) = 0.712注 意：使用表簽控件顯示輸出時(shí)，必需設(shè)置小數(shù)位數(shù)的個(gè)數(shù)；否則系統(tǒng)將以四舍五入的規(guī)則，顯示輸出整數(shù)數(shù)值。定時(shí)器操作函數(shù)定時(shí)器號(hào)：系統(tǒng)定時(shí)器的序號(hào)1127，MCGS系統(tǒng)內(nèi)嵌127個(gè)系統(tǒng)定時(shí)器。系統(tǒng)定時(shí)器以秒為定時(shí)單位。!TimerClearOutput(定時(shí)器號(hào))函數(shù)意義: 斷開定時(shí)器的數(shù)據(jù)輸出連接返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)。實(shí) 例：!TimerClearOutput(1)，斷開1號(hào)定時(shí)器的數(shù)據(jù)輸出連接!TimerRun(定時(shí)器號(hào))函數(shù)意義：?jiǎn)?dòng)定時(shí)器開始工作返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)實(shí) 例：!TimerRun(1)，啟動(dòng)1號(hào)定時(shí)器工作。!TimerStop(定時(shí)器號(hào))函數(shù)意義：停止定時(shí)器工作返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)實(shí) 例：!TimerStop(1 )，停止1號(hào)定時(shí)器工作。!TimerSkip(定時(shí)器號(hào)，步長(zhǎng)值)函數(shù)意義：在計(jì)時(shí)器當(dāng)前時(shí)間數(shù)上加/減指定值返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)；步長(zhǎng)值實(shí) 例：!TimerSkip(1，3)，1號(hào)定時(shí)器當(dāng)前值+3!TimerReset(定時(shí)器號(hào)，數(shù)值)函數(shù)意義：設(shè)置定時(shí)器的當(dāng)前值，由第二個(gè)參數(shù)設(shè)定，第二個(gè)參數(shù)可以是MCGS變量返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。 參 數(shù)：定時(shí)器號(hào)；數(shù)值實(shí) 例：!TimerReset(1，12)，設(shè)置1號(hào)定時(shí)器的值為12!TimerValue(定時(shí)器號(hào)，0)函數(shù)意義：取定時(shí)器的當(dāng)前值返 回 值：將定時(shí)器的值以數(shù)值型的方式輸出（數(shù)值格式）參 數(shù)：定時(shí)器號(hào)實(shí) 例：Data3=!TimerValue(1，0)，取定時(shí)器1的值給Data3!TimerStr(定時(shí)器號(hào)，轉(zhuǎn)換類型)函數(shù)意義：以時(shí)間類字符串的形式返回當(dāng)前定時(shí)器的值返 回 值：字符型變量， 將定時(shí)器的值以字符型的方式輸出（時(shí)間格式）參 數(shù)：定時(shí)器號(hào)轉(zhuǎn)換類型值：開關(guān)型= 0：取定時(shí)器的值以“00：00”形式輸出；= 1：取定時(shí)器的值以“00：00：00”形式輸出；= 2：取定時(shí)器的值以“0 00：00：00”形式輸出；= 3：取定時(shí)器的值以“0 00：00：00.000”形式輸出；實(shí) 例：Time=!TimerStr(1，1)，取定時(shí)器的值以“00：00：00”形式輸出給Time!TimerState(定時(shí)器號(hào))函數(shù)意義：取定時(shí)器的工作狀態(tài)返 回 值：數(shù)值型變量，0 - 定時(shí)器停止，1 - 定時(shí)器運(yùn)行參 數(shù)：定時(shí)器號(hào)實(shí) 例：data1=!TimerState(1)，取定時(shí)器1的工作狀態(tài)給data1 !TimerSetLimit(定時(shí)器號(hào)，上限值，參數(shù)3)函數(shù)意義：設(shè)置定時(shí)器的最大值，即設(shè)置定時(shí)器的上限返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)；上限值；參數(shù)3，1 - 表示運(yùn)行到60后停止；0 - 表示運(yùn)行到60后重新循環(huán)運(yùn)行實(shí) 例：!TimerSetLimit(1，60，1)，設(shè)置1號(hào)定時(shí)器的上限為60，運(yùn)行到60后停止。!TimerSetOutput(定時(shí)器號(hào)，數(shù)值型變量)函數(shù)意義：設(shè)置定時(shí)器的值輸出連接的數(shù)值型變量返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)；數(shù)值型變量，定時(shí)器的值輸出連接的數(shù)值型變量實(shí) 例：!TimerSetOutput(1，Data0)，將1號(hào)定時(shí)器的數(shù)據(jù)連接到Data0!TimerWaitFor(定時(shí)器號(hào)，數(shù)值)函數(shù)意義：等待定時(shí)器工作到“數(shù)值”指定的值后，腳本程序才向下執(zhí)行返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：定時(shí)器號(hào)；數(shù)值， 等待定時(shí)器工作到指定的值實(shí) 例：!TimerWaitFor(1，55)，等定時(shí)器工作到55秒后再執(zhí)行其他操作系統(tǒng)操作函數(shù)!AppActive(Title)函數(shù)意義：激活指定的應(yīng)用程序。使用時(shí)一般先用!Shell函數(shù)啟動(dòng)指定的應(yīng)用程序，然后用本函數(shù)激活應(yīng)用程序，再用!SendKeys函數(shù)發(fā)送擊鍵消息，控制應(yīng)用程序的執(zhí)行。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：Title，字符型，字符串表達(dá)式，所要激活的應(yīng)用程序窗口的標(biāo)題。實(shí) 例：!Shell(D:OfficeExcel.exe，6)! AppActive(“Microsorft Excel Book1”) 說(shuō) 明：AppActivate 語(yǔ)句將焦點(diǎn)移動(dòng)到命名的應(yīng)用程序或窗口，但并不影響焦點(diǎn)是否最大化或最小化。當(dāng)用戶采取行動(dòng)改變焦點(diǎn)或?qū)⒋翱陉P(guān)閉時(shí)，就會(huì)將焦點(diǎn)從活動(dòng)的應(yīng)用程序窗口移動(dòng)出去?？捎?Shell 函數(shù)啟動(dòng)一個(gè)應(yīng)用程序并設(shè)置窗口樣式。在決定激活哪個(gè)應(yīng)用程序時(shí)，將 title 與每一個(gè)運(yùn)行中的應(yīng)用程序的標(biāo)題字符串進(jìn)行比較。如果沒(méi)有完全匹配，就激活任何這樣的應(yīng)用程序，其標(biāo)題字符串以 title 開頭。如果以 title 命名的應(yīng)用程序有很多實(shí)例，則激活任意一個(gè)實(shí)例。!Beep()函數(shù)意義：發(fā)出嗡鳴聲。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!Beep()!EnableDDEConnection(DatName,n)函數(shù)意義：?jiǎn)?dòng)/停止數(shù)據(jù)對(duì)象的DDE連接。返 回 值：數(shù)值型。返回值=0：調(diào)用失敗；0:調(diào)用成功。參 數(shù)：DatName，數(shù)據(jù)對(duì)象名；n，數(shù)值型，為1時(shí)表示啟動(dòng)數(shù)據(jù)對(duì)象的DDE連接。為0時(shí)則停止數(shù)據(jù)對(duì)象的DDE連接。實(shí) 例：!EnableDDEConnection(溫度，1)，啟動(dòng)數(shù)據(jù)對(duì)象“溫度”的DDE連接。!EnableDDEInput(DatName,n)函數(shù)意義：?jiǎn)?dòng)/停止數(shù)據(jù)對(duì)象的DDE連接時(shí)外部數(shù)值的輸入。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0:調(diào)用失敗。參 數(shù)：DatName,數(shù)據(jù)對(duì)象名；n，數(shù)值型，為1時(shí)表示啟動(dòng)數(shù)據(jù)對(duì)象的DDE連接，接收外部數(shù)值的輸入。為0時(shí)則停止數(shù)據(jù)對(duì)象的DDE連接過(guò)程中外部數(shù)值的輸入。實(shí) 例：!EnableDDEConnection(壓力，1)，啟動(dòng)數(shù)據(jù)對(duì)象“壓力”的DDE連接，接收外部數(shù)值的輸入。!EnableDDEOutput (DatName,n)函數(shù)意義：?jiǎn)?dòng)/停止數(shù)據(jù)對(duì)象的DDE連接時(shí)向外部輸出數(shù)值。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0:調(diào)用失敗。參 數(shù)：DatName,數(shù)據(jù)對(duì)象名；n，數(shù)值型，為1時(shí)表示啟動(dòng)數(shù)據(jù)對(duì)象的DDE連接時(shí)向外部輸出數(shù)值的功能。為0時(shí)則停止數(shù)據(jù)對(duì)象的DDE連接時(shí)向外部輸出數(shù)值的功能。實(shí) 例：!EnableDDEConnection(壓力，1)，啟動(dòng)數(shù)據(jù)對(duì)象“壓力”通過(guò) DDE連接向外部輸出數(shù)值的功能。!LinePrtOutput (str)函數(shù)意義：輸出到行式打印機(jī)。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0:調(diào)用失敗。參 數(shù)：str，字符型。實(shí) 例：!LinePrtOutput (“ABCDEFG”)，將字符串輸出到行式打印機(jī)。!PlaySound(SndFileName，Op)函數(shù)意義：播放聲音文件。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：SndFileName，字符型，聲音文件的名字。Op，開關(guān)型= 0：停止播放。= 1：同步播放，播放完畢后再返回（在播放完成之前不能進(jìn)行其它的操作）。= 2：播放一遍，啟動(dòng)播放，立即返回。= 3：循環(huán)播放，啟動(dòng)循環(huán)播放后立即返回。實(shí) 例：!PlaySound(“c:ring.wav”，1)播放聲音文件。!SendKeys(string)函數(shù)意義：將一個(gè)或多個(gè)按鍵消息發(fā)送到活動(dòng)窗口，就如同在鍵盤上進(jìn)行輸入一樣。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；0：調(diào)用失敗。參 數(shù)：string，字符串表達(dá)式，指定要發(fā)送的按鍵消息。實(shí) 例：!SendKeys(%F4)，給當(dāng)前激活的程序發(fā)送Alt+F4擊鍵消息。說(shuō) 明：每個(gè)按鍵由一個(gè)或多個(gè)字符表示。為了指定單一鍵盤字符，必須按字符本身的鍵。例如，為了表示字母 A，可以用 A 作為 string。為了表示多個(gè)字符，就必須在字符后面直接加上另一個(gè)字符。例如，要表示 A、B 及 C，可用 ABC 作為 string。對(duì) SendKeys 來(lái)說(shuō)，加號(hào) (+)、插入符 ()、百分比符號(hào) (%)、上劃線 () 及圓括號(hào) ( ) 都具有特殊意義。為了指定上述任何一個(gè)字符，要將它放在大括號(hào) () 當(dāng)中。例如，要指定正號(hào)，可用 + 表示。為了指定大括號(hào)字符，請(qǐng)使用 及 。為了在按下按鍵時(shí)指定那些不顯示的字符，例如：ENTER 或 TAB 以及那些表示動(dòng)作而非字符的按鍵，請(qǐng)使用下列代碼：按鍵代碼BACKSPACEBACKSPACE, BS, 或 BKSPBREAKBREAKCAPS LOCKCAPSLOCKDEL or DELETEDELETE 或 DELDOWN ARROWDOWNEND ENDENTERENTER或 ESCESCHOME HOMEINS or INSERT INSERT 或 INSLEFT ARROWLEFTNUM LOCKNUMLOCKPAGE DOWNPGDNPAGE UPPGUPRIGHT ARROWRIGHTSCROLL LOCKSCROLLLOCKTAB TABUP ARROW UPF1F1F2F2F3F3F4F4F5F5F6F6F7F7F8F8F9F9F10F10F1