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

MCGS系統(tǒng)(xiting)內(nèi)部函數(shù)

MCGS內(nèi)部為用戶提供了一些常用的數(shù)學(xué)(skixu?函數(shù)和對MCGS內(nèi)部對

象操作的函數(shù)。組態(tài)時，可在表達(dá)式中或用戶腳本程序中直接使用(shiybng)這

些函數(shù)。為了與其它名稱相區(qū)別，系統(tǒng)內(nèi)部函數(shù)的名稱一律以符號

。)開頭。下面分別介紹各個函數(shù)的用途和使用方法。

運(yùn)行環(huán)境(hudnjing)操作函數(shù)

!CallBackSvr(DatName)

函數(shù)意義：調(diào)用后臺對象

返回值：數(shù)值型，后臺對象的值

參數(shù)：DatName,對象名，數(shù)值型

實(shí)例：X=!CallBackSvr(X),調(diào)用后臺數(shù)值型對象X

注意：本函數(shù)在新版木MCGS系統(tǒng)內(nèi)部，已經(jīng)無效。為了保留與舊版本的兼容

性，暫時保留。

!ChangeLoopStgy(StgyName,n)

函數(shù)意義：改變循環(huán)策略的循環(huán)時間

返回值：數(shù)值型。返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：StgyName,策略名；n,數(shù)值型，以毫秒數(shù)表示循環(huán)策略的循環(huán)時間

實(shí)例：！ChangeLoopStgy(報(bào)警策略，5000),將我警策略的循環(huán)時間改為為5

秒

!CloseAllWindow(VVndName)

函數(shù)意義：關(guān)閉所有窗口，如果在字符串"WndName”中指定了一個窗口，則打

開這個窗口，關(guān)閉其他窗口。如果"NndName”為空串，則關(guān)閉所有窗口。

返回值：數(shù)值型。返回值：巾：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：WndName,用戶窗口名，字符型。

實(shí)例：！CloseAUWindow(“工況圖”)，關(guān)閉除了用戶窗口“工況圖”以外的

其他窗口，若“工況圖”窗口沒有打開，則在關(guān)閉其他窗口的同時打開該窗口

!CloseAllWindow(關(guān)閉所有窗口。

!EnableStgy(StgyName,n)

函數(shù)意義：打開或關(guān)閉某個策略，如報(bào)警策略或循環(huán)策略等。

返回值：數(shù)值型。返回值巾：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：StgyName,策略名；

n,數(shù)值型，為1時表示打開此策略，為0時表示關(guān)閉此策略。

實(shí)例：！EnableStgy(強(qiáng)警(bdojing)策略，1),打開(ddkdi)報(bào)警策略；

!EnableStgy(報(bào)警(bdojing)策略，0),關(guān)閉(gudnbi)報(bào)警策略,使報(bào)警策略

無效

!GetDeviceName(Index)

函數(shù)(hGnshti)意義：按設(shè)備順序取到設(shè)備的名字。

返回值：字符型。調(diào)用成功返回設(shè)備名，調(diào)用失敗時返回空字符串。

參數(shù)：Index,數(shù)值型。

實(shí)例1!GotDoviceNano(0),取0號設(shè)備構(gòu)件的名稱▽

!GetDeviceState(DevName)

函數(shù)意義：按設(shè)備名查詢設(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è)備有錯。

參數(shù)：DevName,設(shè)備名，字符型。

實(shí)例：！GetDeviceState(OmronPLC),讀取設(shè)備構(gòu)件“OmronPLC”的當(dāng)前工作

狀態(tài)。

!GetStgyName(Index)

函數(shù)意義：按運(yùn)行策略的順序獲得各策略塊的名字。

返回值：字符型。

參數(shù)：Index,數(shù)值型。

實(shí)例：！GetStgyName(O),取0號運(yùn)行策略的名稱。

!GetWindowName(Index)

函數(shù)意義：按用戶窗口的順序獲得用戶窗口的名字。

返回值：字符型。

參數(shù)：Index,數(shù)值型。

實(shí)例：！GetWindowNane(0),讀取。號用戶窗口的名稱。

!GetWindowState(WndName)

函數(shù)意義：按照名字取得用戶窗口的狀態(tài)。

返回值：數(shù)值型。

返回0：用戶窗口處于關(guān)閉狀態(tài)。

返回1：用戶窗口處于打開狀態(tài)。

返回2：用戶窗口處于隱藏狀態(tài)。

參數(shù)：WndName,用戶(ybngh￡i)窗口名稱，字符型。

實(shí)例：！GetWindowSlate(工況圖)，獲得(hubdS用戶窗口“工況圖”的狀態(tài)

(zhuangtai)

!SetActiveX(Activename,n,str)

函數(shù)(hdnshti)意義：操作指定(zhlding)的動畫構(gòu)件，向窗口中的ActiveX控

件發(fā)出控件命令

返回值，無

參數(shù)：Activename,字符型，控件名稱，用”分割窗口名和控件名，如：窗

口0.控件1表示在用戶窗口“窗口0”中的名為“控件1”的控件。

n,數(shù)值型，命令類型，請?zhí)?；

str,字符型，命令字符串，具體含義請參照控件幫助。

實(shí)例：！SetActiveX(“窗口?？丶?"，1,"start”),啟動窗口0的控件0

開始工作。

!SetDcvice(DevNamc,DevOp,CnidStr)

函數(shù)意義：按照設(shè)備名字對設(shè)備進(jìn)行操作。

返回值：數(shù)值型。返回值：=0：調(diào)用正常；＜〉0：調(diào)用不正常。

參數(shù)：DevName,設(shè)備名，字符型；

DevOp,設(shè)備操作碼，數(shù)值型；

CmdStr,設(shè)備命令字符串，只有當(dāng)Dev0p=6時CmdStr才有意義。

DevOp取值范圍及相應(yīng)含義：

1：啟動設(shè)備開始工作。

2：停止設(shè)備的工作使其處于停止?fàn)顟B(tài)。

3：測試設(shè)備的工作狀態(tài)。

4：啟動設(shè)備工作一次。

5：改變設(shè)備的工作周期，CmdSlr中包含新的工作周期，單位為ms。

6：執(zhí)行指定的設(shè)備命令，CmdStr中包含指定命令的格式。

實(shí)例：！SetDeviceSmronPLC,L〃〃),啟動設(shè)備構(gòu)件“OmronPLC”開始工

作。

!SetStgy(StgyNamc)

函數(shù)意義：執(zhí)行SlgyName指定的運(yùn)行策略。

返回值：數(shù)值型。返回值二0：調(diào)用正常；＜＞0：調(diào)用不正常。

參數(shù)：StgyName,策略名，字符型。

實(shí)例：！SetStgy(閥門關(guān)閉)，執(zhí)行一次運(yùn)行策略“閥門關(guān)閉”。

!SetWindow(WndName,Op)

函數(shù)(hGnshU)意義:按照名字(而ngzi)操作用戶窗口，如打開、關(guān)閉、打印。

返回值：數(shù)值(shUzf)型。返回值：=0：調(diào)用(didoybng)正常；<>0：調(diào)用(di

aoyong)不正常。

參數(shù)：WndName,用戶窗口名，字符型。

Op:操作用戶窗口的方法，數(shù)值型。

Op=l：打開窗口并使其可見。0p=2：打開窗口并使其不可見。

Op=3：關(guān)閉窗口v0p=4：打印窗口。Op=5：刷新窗口v

實(shí)例：！SetWindow(工況圖，1),打開用戶窗口“工況圖”，并使其可見。

!SysVVindow()

函數(shù)意義：執(zhí)行該函數(shù)后，打開用戶窗口管理窗口，在管理窗口中可以選擇打

開或關(guān)閉指定的用戶窗口。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：無。

實(shí)例；!SysWindow()

!DisableCtrlAltDel()

函數(shù)意義：屏蔽熱鍵Ctrl+Alt+Del的功能。無法打開任務(wù)管理器窗口或執(zhí)行鎖

定計(jì)算機(jī)、注銷、關(guān)機(jī)、密碼修改等操作。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：無。

實(shí)例：IDisableCtrlAltDelO

注意此函數(shù)在網(wǎng)絡(luò)版客戶端和WIN98操作系統(tǒng)下無效。

!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ù)：無。

實(shí)例:!EnableCtrlAltDel()

注意：1.不要把這兩個腳本函數(shù)同時使用，否則，看不到任何效果，沒專任

何意義；

2.不要把這兩個函數(shù)放到循環(huán)中使用；

3.在使用這2個腳本函數(shù)時，最好與登錄密碼同時使用，以達(dá)到真正的熱鍵屏

蔽效果。

4.此函數(shù)在網(wǎng)絡(luò)版客戶端和WIN98操作系統(tǒng)下無效。

!RestartProject()

函數(shù)(hdnshti)意義：當(dāng)檢查組態(tài)工程在運(yùn)行過程中出現(xiàn)非正常狀態(tài)

(zhuangtai),可以調(diào)用該函數(shù)重新啟動運(yùn)行環(huán)境。該功能必須在加密狗生效

(shengxiio)時方可工作。

返回值：無。

參數(shù)：無。

實(shí)例：！RestartProject()

數(shù)據(jù)(Shtljfl)對象操作函數(shù)

!AnswerAlm(DatName)

函數(shù)(hdnsh。)意義：應(yīng)答數(shù)據(jù)對象DatName所產(chǎn)生的報(bào)警。如對應(yīng)的數(shù)據(jù)對象

沒有報(bào)警產(chǎn)生或已經(jīng)應(yīng)答，則本函數(shù)無效。

返回值：數(shù)值型，=0為操作成功；?()為操作失敗。

參數(shù)：DcitName,數(shù)據(jù)對象名；

實(shí)例：！AnswerAlm(電機(jī)溫度)，應(yīng)答數(shù)據(jù)對象“電機(jī)溫度”所產(chǎn)生的報(bào)警。

!ChangeDataSave(Datnamc,n)

函數(shù)意義:改變數(shù)據(jù)對象Datname存盤的周期。

返回值：數(shù)值型，二0為操作成功；<〉0為操作失敗。

參數(shù)：Datname,數(shù)據(jù)對象名；

n,數(shù)值型，以秒表示的存盤間隔時間

實(shí)例：ChangeDataSave(溫度，5),溫度的存盤間隔時間為5秒

!ChangeSaveDat(DatName,Numl,Num2)

函數(shù)意義：改變數(shù)據(jù)對象DatName所對應(yīng)存盤數(shù)相的存盤間隔，把Numl小時以

前的存盤數(shù)據(jù)(以當(dāng)前時間為0點(diǎn))的存盤間隔改為Num2秒。本操作只對組對

象有效,對單個的數(shù)據(jù)對象無效。當(dāng)DataName二空字符,或Numl=0或Num2=0

時，本操作無效。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatName：數(shù)據(jù)對象名。

Numl：數(shù)值型時間量，單位：小時。本函數(shù)用Numl<0的一些數(shù)值來表示一些特

殊意義的操作：

=-1改變當(dāng)天對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；

二-2改變昨天對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；

=-3改變本星期對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；

=-4改變上星期對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；

二-5改變本月對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；

=-6改變上個月對應(yīng)數(shù)據(jù)對象所有存盤數(shù)據(jù)的存盤間隔；

Num2：數(shù)值型時間量，新的存盤間隔，單位：秒。

實(shí)例：!ChangeSaveDat(電機(jī)(didnji)1,-2,5),把組對象(duixidng)

“電機(jī)(diinji)l”對應(yīng)(duiying)的存盤數(shù)據(jù)中昨天的存盤數(shù)據(jù)的存盤間隔改

為5秒鐘。

!CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag)

函數(shù)(hGnshtl)意義：拷貝數(shù)據(jù)庫中數(shù)據(jù)表的數(shù)據(jù)

返回值：開關(guān)型，返回值二0：調(diào)用正常；返回情00：調(diào)用不正常。

參數(shù)：Tdb,目標(biāo)數(shù)據(jù)庫名；Sdb,源數(shù)據(jù)庫名；TabName,數(shù)據(jù)表名；

TimeField,定義的時間字段名;Flag,拷貝方式，0：覆蓋拷貝；1：添加拷

貝。

實(shí)例：!CopySaveDat(Tdb,Sdb,TabName,TimeField,0),將數(shù)據(jù)庫

Sdb中表TabName中的數(shù)據(jù)拷貝到數(shù)據(jù)庫Tdb中，表名仍是TabName,定義的時

間字段為TimeField,拷貝方式為覆蓋拷貝。

!DelAllSaveDat(DatName)

函數(shù)意義：刪除數(shù)據(jù)對象DatName對應(yīng)的所有存盤數(shù)據(jù)。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatName,數(shù)據(jù)對象名。

實(shí)例：！DelAllSaveDat(電機(jī)溫度)，刪除數(shù)據(jù)對象“電機(jī)溫度”對應(yīng)的所有

存盤數(shù)據(jù)。

!DelAllAlmDat(DatName)

函數(shù)意義：刪除數(shù)據(jù)對象DataName對應(yīng)的所有報(bào)警存盤數(shù)據(jù)。注意，此函數(shù)不

能用來刪除組對象所市應(yīng)的報(bào)警存盤數(shù)據(jù)。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatName：數(shù)據(jù)對象名；

實(shí)例：！DelAHAlmDal(電機(jī)溫度)，刪除數(shù)據(jù)對象“電機(jī)溫度”對應(yīng)的所有

報(bào)警存盤數(shù)據(jù)

IDelAlmDatfDatNamefNum)

函數(shù)意義：刪除數(shù)據(jù)對象DataName對應(yīng)的報(bào)警存儲數(shù)據(jù)中最早Num小時內(nèi)的報(bào)

警存儲數(shù)據(jù)，如Num<=0或DatName二空字符，則該函數(shù)無效。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatName：數(shù)據(jù)對象名；

Num：數(shù)值型時間值，單位：小時。

實(shí)例：！DelAlmDat(電機(jī)(didnji)溫度，1),刪除數(shù)據(jù)(sh€ij￡i)對象“電機(jī)(di

dnji)溫度”對應(yīng)的報(bào)警(bCiojing)存盤數(shù)據(jù)中最早1小時(xi西oshi)內(nèi)的數(shù)

據(jù)。

!DelSaveDat(DatName,Num)

函數(shù)意義:刪除數(shù)據(jù)對象DataName對應(yīng)的存盤數(shù)據(jù)中最早Num小時內(nèi)的存盤數(shù)

據(jù)，如Num<=0或DatName=空字符，則該函數(shù)無效。

返回值，數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正?！?/p>

參數(shù)：DatName：數(shù)據(jù)對象名；

Num：數(shù)值型時間值，單位：小時。

實(shí)例：！DelSaveDat(電機(jī)溫度，12),刪除數(shù)據(jù)對象“電機(jī)溫度”對應(yīng)的存

盤數(shù)據(jù)中最早12小時內(nèi)的數(shù)據(jù)。

!EnableAlm(nameyn)

函數(shù)意義：打開/關(guān)閉數(shù)據(jù)對象的報(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ù)對象的定時存盤功能。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：name,數(shù)據(jù)對象名；

n,數(shù)值型，1表示打開定時存盤，0表示關(guān)閉定時存盤

實(shí)例：！EnableDataSave(溫度，1),打開溫度的定時存盤

!GetAlmValue(DatName,Value,Flag)

函數(shù)意義：讀取數(shù)據(jù)對象DatName報(bào)警限值，只有在數(shù)據(jù)對象DatName的“允

許進(jìn)行報(bào)警處理”屬性選項(xiàng)被選中后，本函數(shù)的操作才有意義。對組對象、字

符型數(shù)據(jù)對象、事件型數(shù)據(jù)對象本函數(shù)無效。對數(shù)值型數(shù)據(jù)對象，用Flag來標(biāo)

識讀取何種報(bào)警限值。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatName：數(shù)據(jù)對象名。

Value：DataName的當(dāng)前的報(bào)警限值，數(shù)值型。

Flag：數(shù)值型，標(biāo)志要讀取何種限值，具體意義如下：

二1下下限報(bào)警值；

=2下限報(bào)警值；

=3上限(shGngxiGn)報(bào)警值；

=4上上限(shdngxidn)報(bào)警值；

=5下偏差(pidnchd)報(bào)警限值;

=6上偏差(pidnchd)報(bào)警限值；

=7偏差(pidnchG)報(bào)警基準(zhǔn)值；

實(shí)例：！GetAlmValue(電機(jī)溫度，Value,3),讀取數(shù)據(jù)對象“電機(jī)溫度”

的報(bào)警上限值，放入數(shù)值型數(shù)據(jù)對象Valu。中。

!GetEventDT(EvName)

函數(shù)意義：返回當(dāng)前事件和上一次事件之間的時間差，單位為秒。

返回值：數(shù)值型。返回的時間差

參數(shù)：EvName,事件變量名，事件型。

實(shí)例：！GelEvenlDT(EvName),取事件變量EvName當(dāng)前事件和上一次事件之間

的時間差，單位為秒。

!GctEvcntP(EvName)

函數(shù)意義：取到當(dāng)前事件的附加說明字符串。

返回值：字符型。返回的附加說明字符串。

參數(shù)：EvName,事件變量名，事件型。

實(shí)例：！GetEventP(EvNanle),取事件型變量EvName的當(dāng)前事件的附加說明字

符串。

!GetEventT(EvName)

函數(shù)意義：取到當(dāng)前事件產(chǎn)生的時間，以秒為單位，相對于1980年以來的秒

數(shù)。如沒有事件產(chǎn)生，返回T。

返回值：數(shù)值型。

參數(shù)：EvName,事件變量名，事件型。

實(shí)例：！GelEvenlT(EvName),取事件型變量EvName的當(dāng)前事件產(chǎn)生時刻。

!MoveAlmDat(DatNanie,FileName,NumLNum2,Flag)

函數(shù)意義：把數(shù)據(jù)對象DatNamc所對應(yīng)的報(bào)警存盤信息中的第Numl小時到

Numl+Num2小時內(nèi)(以當(dāng)前時間為。點(diǎn))的報(bào)警存盤信息提取出來，轉(zhuǎn)存到

FileName所指定的數(shù)據(jù)庫文件中(Access數(shù)據(jù)庫)。當(dāng)DatName二空字符，或

FileName二空字符，或Num2<0時，本函數(shù)無效。刪除數(shù)據(jù)對象DalName對應(yīng)的

所有報(bào)警存儲數(shù)據(jù)。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù):DatName：數(shù)據(jù)對象名。

FileName：新的報(bào)警（bdojing）存盤文件名（包括（bGokub）路徑），字符（zifu）

型。

Numl：數(shù)值型時間量，單位（ddnwii）：小時。本函數(shù)用Numl<0的一些數(shù)值來表

示一些特殊意義的操作（cdozub）（此時Num2無效）：

=7轉(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)存上個月的所有報(bào)警信息存盤數(shù)據(jù)；

Num2：數(shù)值型時間量，單位：小時。

Flag：轉(zhuǎn)存標(biāo)志，數(shù)值型。

Flag二0時，創(chuàng)建一個新文件（如原文件已存在，則把原文件改名為***.BK1）；

Flag=l時，在原有的基礎(chǔ)上增加新的數(shù)據(jù)。

實(shí)例：！MoveAlmDat（電機(jī)溫度,“D:\Temp\ttt.mdb”,-6,0,1）,把數(shù)據(jù)對

象“電機(jī)溫度”對應(yīng)的報(bào)警存盤數(shù)據(jù)中的上個月的所有報(bào)警信息存盤數(shù)據(jù)轉(zhuǎn)存

添加到數(shù)據(jù)庫文件〃D:\Teinp\ttt.mdb〃中。

!MoveSaveDat（DatName,FileName,Numl,Num2,Flag）

函數(shù)意義：把數(shù)據(jù)對象DatName所對應(yīng)的存盤數(shù)據(jù)中的第Numl小時到

Numl+Num2小時內(nèi)（以當(dāng)前時間為0點(diǎn)）的存盤數(shù)據(jù)提取出來，轉(zhuǎn)存到

FileName所指定的數(shù)據(jù)庫文件中（Access數(shù)據(jù)庫）。當(dāng)DatName二空字符，或

FileName二空字符,或Num2<0時,本函數(shù)無效。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatNam。：數(shù)據(jù)對象名。

FileName：新的存盤數(shù)據(jù)文件名（包括路徑），字符型。

Numl：數(shù)值型時間量，單位：小時。

本函數(shù)用Numl<0的一些數(shù)值來表示一些特殊意義的操作（此時Num2無效）：

二-1轉(zhuǎn)存當(dāng)天對應(yīng)數(shù)據(jù)對象的所有存盤數(shù)據(jù)；

=-2轉(zhuǎn)存昨天對應(yīng)數(shù)據(jù)對象的所有存盤數(shù)據(jù)；

二-3轉(zhuǎn)存本星期對應(yīng)數(shù)據(jù)對象的所有存盤數(shù)據(jù)；

二-4轉(zhuǎn)存上星期對應(yīng)數(shù)據(jù)對象的所有存盤數(shù)據(jù)；

=-5轉(zhuǎn)存本月對應(yīng)數(shù)據(jù)對象的所有存盤數(shù)據(jù)；

二-6轉(zhuǎn)存上個月對應(yīng)數(shù)據(jù)對象的所有存盤數(shù)據(jù)；

Num2：數(shù)值型時間量，單位：小時。

Flag：轉(zhuǎn)存標(biāo)志，數(shù)值型。

Flag=0時，創(chuàng)建(chudngjidn)一個新文件(如原文件已存在(ctinzdi),則把原

文件改名為***.BK1)；Flag=l時,在原有的基礎(chǔ)(jichU)上增加新的數(shù)據(jù)。

實(shí)例：！MoveSaveDat(電機(jī)(didnji)溫度，〃D:\Temp\ttt.nidb〃，-6,0,1)

把數(shù)據(jù)(shCijCi)對象“電機(jī)溫度”對應(yīng)的存盤數(shù)據(jù)中的上個月的所有存盤數(shù)據(jù)轉(zhuǎn)

存添加到數(shù)據(jù)庫文件“D:\Temp\ttt.mdb”中。

ISaveData(DatName)

函數(shù)意義：把數(shù)據(jù)對象DataName對應(yīng)的當(dāng)前值存入存盤數(shù)據(jù)庫中。本函數(shù)的操

作使對應(yīng)的數(shù)據(jù)對象的值存盤一次。此數(shù)據(jù)對象必須具有存盤屬性，且存盤時

間需設(shè)為0秒。否則會操作失敗。

返回值：數(shù)值型，=0為操作成功；?()為操作失敗。

參數(shù)：DcitName,數(shù)據(jù)對象名。

實(shí)例：！SaveData(電機(jī)1),把組對象“電機(jī)1”的所有成員對應(yīng)的當(dāng)前值存

盤次。

!SaveDataInit()

函數(shù)意義：本操作把設(shè)置有“退出時自動保存數(shù)據(jù)對象的當(dāng)前值作為初始值”

屬性的數(shù)據(jù)對象的當(dāng)前值存入組態(tài)結(jié)果數(shù)據(jù)中作為初始值，防止突然斷電而無

法保存，以便MCGS下次啟動時這些數(shù)據(jù)對象能自動恢復(fù)其值。

返回值：數(shù)值型，返回值=0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：無。

實(shí)例：！SaveDaralnit()

!SaveDataOnTime(Time,TimeMS,DataName)

函數(shù)意義：使用指定時間保存數(shù)據(jù)。本函數(shù)通常用于指定時間來保存數(shù)據(jù)，實(shí)

現(xiàn)與通常機(jī)制不一樣的存盤方法。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：Time,整型，使用時間函數(shù)轉(zhuǎn)換出的時間量。時間精度到秒。

TimeMS,整型，指定存盤時間的亳秒數(shù)。

DataName,數(shù)據(jù)對象名。

實(shí)例：t=!TimeStr2I(^2001年2月21日3時2分3秒”)

ISaveDataOnTime(t,0,DataGroup),按照指定時間保存數(shù)據(jù)對象

!SaveSingleDataInit(Name)

函數(shù)意義：本操作把數(shù)據(jù)對象的當(dāng)前值設(shè)置為初始值(不管該對象是否設(shè)置有

“退出時自動保存數(shù)據(jù)對象的當(dāng)前值作為初始值”屬性)，防止突然斷電而無

法保存，以便MCGS下次啟動時這些數(shù)據(jù)對象能自動恢復(fù)其值。

返回值：數(shù)值型，返回值=0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：Name,數(shù)據(jù)(shCijfi)對象名。

實(shí)例：！SaveSingleDatalnit(溫度(w?nd￡i)),把溫度(wQnd。)的當(dāng)前值設(shè)置成

初始值。

!SetAlmValue(DatName,Value,Flag)

函數(shù)(hGnshd)意義：設(shè)置數(shù)據(jù)(shdjU)對象DatName對應(yīng)的報(bào)警限值，只有在數(shù)

據(jù)對象DatNam。"允許進(jìn)行報(bào)警處理”的屬性被選中后，木函數(shù)的操作才有意

義。對組對象、字符型數(shù)據(jù)對象、事件型數(shù)據(jù)對象本函數(shù)無效。對數(shù)值型數(shù)據(jù)

對象，用Flag來標(biāo)識改變何種報(bào)警限值。

返回值：數(shù)值型，返回值二0：調(diào)用正常；<>0：調(diào)用不正常。

參數(shù)：DatName：數(shù)據(jù)對象名。

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ù)對象“電機(jī)溫度”的報(bào)

警上限值設(shè)為200

用戶登錄操作函數(shù)

!ChangePassword()

函數(shù)意義：彈出密碼修改窗口，供當(dāng)前登錄的用戶修改密碼。

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：無。

實(shí)例：！Changepassword()

!CheckUserGroup(strUserGroup)

函數(shù)意義：檢查當(dāng)前登錄的用戶是否屬于strUserGroup用戶組的成員。

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：strUserGroup,字符型，用戶組的名稱。

實(shí)例：！CheckUserGroup(〃管理員組〃)

!Edituscrs()

函數(shù)意義：彈出用戶管理窗口，供管理員組的操牛者配置用戶。

返回值：數(shù)值(shDzi)型。返回值二0：調(diào)用(didoybng)成功；<>0：調(diào)用(did

oyong)失敗。

參數(shù)：無。

實(shí)例：!Editusers()

!EnableExitLogon(n)

函數(shù)(hdnshti)意義：打開(ddkdi)/關(guān)閉退出時的權(quán)限檢查

返回值：無

參數(shù)：n,數(shù)值型，為1時表示在退出時進(jìn)行權(quán)限檢查，當(dāng)權(quán)限不足時，會進(jìn)

行提示。為0則退出時不進(jìn)行權(quán)限檢查。

實(shí)例：！EnableExitLogon(l),在退出時進(jìn)行權(quán)限檢查

!EnableExitPrompt(n)

函數(shù)意義；打開/關(guān)閉退出時的提示信息

返回值：無

參數(shù)：n,數(shù)值型，為1時表示在退出時彈出提示信息對話框。為。則退出時

不出現(xiàn)信息對話框。

實(shí)例：！EnableExitLogon(l),在退出時彈出提示信息對話框

!GetCurrentGroup()

函數(shù)意義：讀取當(dāng)前登錄用戶的所在用戶組名。

返回值：字符型，當(dāng)前登錄用戶組名，如沒有登錄返回空。

參數(shù)：無。

實(shí)例：!GetCurrentGroup()

!GetCurrentUser()

函數(shù)意義：讀取當(dāng)前登錄用戶的用戶名。

返回值：字符型，當(dāng)前登錄用戶的用戶名，如沒有登錄返回空。

參數(shù)：無。

實(shí)例：IGetCurrentlser()

!LogOff()

函數(shù)意義：注銷當(dāng)前用戶。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：無。

實(shí)例：！Logoff()

!LogOn()

函數(shù)意義：彈出登錄對話框。

返回值：數(shù)值(shUzf)型。返回值二0：調(diào)用(didoyOng)成功；<>0：調(diào)用(did

oybng)失敗。

參數(shù)：無。

實(shí)例：！LogOn()

!GetUserNameByIndex()

函數(shù)(hdnshCi)意義，按索引(suByln)號取得當(dāng)前用戶名。

返回值：字符型。與索引號相對應(yīng)的當(dāng)前用戶名。

參數(shù)：索引號值。

實(shí)例：！GetUserNameBylndex(O),索引為0的用戶名稱。

!GetGroupNameByIndex()

函數(shù)意義：按索引號取得當(dāng)前用戶組名。

返回值：字符型。與索引號相對應(yīng)的當(dāng)前用戶組名。

參數(shù)；索引號值。

實(shí)例：！GetGroupNameBylndex(O),索引為0的用戶組名稱。

!GetProjectTotalUsers()

函數(shù)意義：取得當(dāng)前工程用戶總數(shù)。

返回值：開關(guān)型。當(dāng)前工程用戶總數(shù)。

參數(shù)：無

實(shí)例：！GetProject"talUsers。，激活該函數(shù),取得當(dāng)前工程的用戶總數(shù)。

字符串操作函數(shù)

!Ascii2Ks)

函數(shù)意義：返回字符串s的首字母的Ascii值。

返回值：開關(guān)型。

參數(shù)：s,字符型。

實(shí)例：！Ascii21(“Afd")=65

!Bin2I(s)

函數(shù)意義：把二進(jìn)制字符串轉(zhuǎn)換為數(shù)值。

返回值：開關(guān)型。

參數(shù)：s,字符型。

實(shí)例：!Bin2I(a101J,)=5

!Format(n,str)

函數(shù)意義：格式化數(shù)值型數(shù)據(jù)對象

返回值：字符型。

參數(shù)：n,數(shù)值(shfizi)型，要格式化的數(shù)值；

str,字符(zifU)型,格式化數(shù)值的格式。表示為0.00樣式(ydngshi)。小數(shù)

點(diǎn)后的0的個數(shù)表示(bidoshi)需要格式化出的小數(shù)位數(shù)。小數(shù)點(diǎn)前的0為一個

時，表示小數(shù)點(diǎn)前根據(jù)實(shí)際數(shù)值(shOzi)顯示。當(dāng)小數(shù)點(diǎn)前沒有。時，表示

為.xx式樣，當(dāng)小數(shù)點(diǎn)前的0不止一個時，使用0來填充不夠的位數(shù)。

實(shí)例:!Format(1.236,"0.00zz)=〃1.24〃；!Format(1.236,00")=

〃.24〃；

?Format(1.236,，z00.00")=〃01.24〃；

!Hex2I(s)

函數(shù)意義：把16進(jìn)制字符串轉(zhuǎn)換為數(shù)值。

返回值：開關(guān)型。

參數(shù)；s,字符型。

實(shí)例：!Hex2T(“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í)例：!I20ct(9)=“11”

!InStr(n,strl,str2)

函數(shù)(hGnshti)意義：查找(chdzhdo)一字符串在另一字符串中最先出現(xiàn)的位置

返回值：數(shù)值(shUzf)型。

參數(shù)：n,數(shù)值型，開始搜索(s6usub)的位置；

strl,字符串，被搜索(s6usub)的字符串；

str2,字符串，要搜索的字符串

實(shí)例：！1。5"(3,〃5(]11＜門牌迫〃，〃小?")=7

實(shí)例：！InStr(1,〃wesdlkfjwe〃，〃we〃)=1,表示從strl字符串的第一個字

符位置搜索str2字符串，返回最先出現(xiàn)的位置

!Lcase(str)

函數(shù)意義：把字符型數(shù)據(jù)對象str的所有字符轉(zhuǎn)浜成小寫。

返回值；字符型。

參數(shù)：str,字符型。

實(shí)例：!LCase(，，sedERT，")="sedert"

!Left(str,n)

函數(shù)意義：字符型數(shù)據(jù)對象str左邊起，取n個字符。

返回值：字符型。

參數(shù)：str：字符型，源字符串；n,數(shù)值型，取字符個數(shù)。

實(shí)例：!Left("ABCDEFG〃,2):〃AB〃

!Len(Str)

函數(shù)意義：求字符型數(shù)據(jù)對象str的字符串長度(字符個數(shù))。

返回值：數(shù)值型。

參數(shù)：str,字符型。

實(shí)例：!Len("ABCDEFG〃)=7

ILtrim(str)

函數(shù)意義：把字符型數(shù)據(jù)對象str中最左邊的空珞剔除。

返回值：字符型。

參數(shù)：str,字符型。

實(shí)例：！LTrim(〃dsfk〃)=〃dsfk〃

!lVal(str)

函數(shù)意義：將數(shù)值類字符串轉(zhuǎn)化為長整型數(shù)值

返回值：開關(guān)型，轉(zhuǎn)換出的數(shù)值。

參數(shù)：str,字符型。要求待轉(zhuǎn)換的字符串為數(shù)值類字符串

實(shí)例：!1Vai(“12345678")=12345678

!Mid(str,n,k)

函數(shù)(hdnshtl)意義:從字符(zifii)型數(shù)據(jù)對象str左邊(zubbian)第妥個字符

起，取k個字符。

返回值：字符(zi宜)型。

參數(shù)?str,字符(zif")型，源字符串；

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í)例：!0ct2T(“11”)=9

!Right(str,n)

函數(shù)意義：從字符型數(shù)據(jù)對象str右邊起，取n個字符。

返回值：字符型。

參數(shù)：str,字符型，源字符串；n,數(shù)值型，取字符個數(shù)。

實(shí)例：！Right(〃ABCDEFG〃,2)二〃FG〃

IRtrim(str)

函數(shù)意義：把字符型數(shù)據(jù)對象str中最右邊的空珞剔除。

返回值：字符型。

參數(shù)：str,字符型。

實(shí)例：！LTrim(〃dsfk〃)=〃dsfk”

!Str(x)

函數(shù)意義：將數(shù)值型數(shù)據(jù)對象x的值轉(zhuǎn)換成字符串。

返回值：字符型。

參數(shù)：x,數(shù)值型。

實(shí)例：！Str(O.712)二〃0.712〃

!StrComp(strl,str2)

函數(shù)意義：比較字符型數(shù)據(jù)對象strl和str2是否相等，返回值為0時相等，

否則不相等。不區(qū)分大小寫字母。

返回值：數(shù)值型。

參數(shù)：strl,字符型；

str2,字符型。

實(shí)例：！StrComp(〃ABC","abc〃)=0

!StrFormat(FormatStr,任意(r6nyi)個數(shù)變量)

函數(shù)(hdnshti)意義：格式化字符串，可以格式化任意(rGnyi)多個數(shù)值。使用方

法為！StrFormat(，23)或！StrFormat("獨(dú)-%gfg”，2.3,2.1,2.2)等，類

似(IEsi)C語言(yCiydn)中的Printf的語法。

返回值：字符型。

參數(shù)：FormatStr,字符型，格式化字符串，如：“%d"、g”。后面的參

數(shù)可以任意多個。

實(shí)例：!StrFormatC%g—%g*,12,12.34)="12—12.34"

注意：輸出多個數(shù)值時，可以使用在多個格式化字符串之間，添加分格符的方

法,區(qū)別任意個數(shù)的輸出變量。如：〃%g—%g〃、"%g-%g-%g〃。

!Trim(str)

函數(shù)意義：把字符型數(shù)據(jù)對象str中左右兩端的空格剔除。

返回值：字符型。

參數(shù)：str,字符型。

實(shí)例：！Trim("dsfk〃)="dsfk"

!Ucase(str)

函數(shù)意義：把字符型數(shù)據(jù)對象str的所有字符轉(zhuǎn)於成大寫。

返回值：字符型。

參數(shù)：str,字符型。

實(shí)例：！UCase(〃sedERT〃)=〃SEDER『

IVal(str)

函數(shù)意義：把數(shù)值類字符型數(shù)據(jù)對象str的值轉(zhuǎn)換成數(shù)值。

返回值：數(shù)值型。

參數(shù)：str,字符型。

實(shí)例：！Vai(“0.712"1=0.712

注意：使用表簽控件顯示輸出時，必需設(shè)置〃小數(shù)位數(shù)〃的個數(shù)；否則系統(tǒng)將以

四舍五入的規(guī)則，顯示輸出整數(shù)數(shù)值。

定時器操作函數(shù)

定時器號：系統(tǒng)定時器的序號1—127,MCGS系統(tǒng)內(nèi)嵌127個系統(tǒng)定時器。系

統(tǒng)定時器以秒為定時單位。

!TimcrCIearOutput（定時器號）

函數(shù)（hGshti）意義：斷開定時器的數(shù)據(jù)（shdjCi）輸出連接

返回值：數(shù)值（shDzi）型。返回值二0：調(diào)用（didoybng）成功；<>0：調(diào)用（did

oyong）失敗。

參數(shù)：定時器號。

實(shí)例：！TimerClearOutput（1）,斷開1號定時器的數(shù)據(jù)輸出連接

!TimerRun（定時器號）

函數(shù)意義：啟動定時器開始工作

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：定時器號

實(shí)例：！TimerRun（l）,啟動1號定時器工作。

!TimerStop（定時器號）

函數(shù)意義：停止定時器工作

返回值；數(shù)值型。返回值=0：調(diào)用成功；<>0；調(diào)用失敗。

參數(shù)：定時器號

實(shí)例：！TimerStop（l）,停止1號定時器工作。

!TimerSkip（定時器號，步長值）

函數(shù)意義：在計(jì)時器當(dāng)前時間數(shù)上加/減指定值

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：定時器號；步長值

實(shí)例：！TimerSkip（L3）,1號定時器當(dāng)前值十3

!TimerReset（定時器號，數(shù)值）

函數(shù)意義：設(shè)置定時器的當(dāng)前值，由第二個參數(shù)設(shè)定，第二個參數(shù)可以是MCGS

變量

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：定時器號；數(shù)值

實(shí)例：！TimerReset（l,12）,設(shè)置1號定時器的值為12

!TimerValue（定時器號，0）

函數(shù)意義：取定時器的當(dāng)前值

返回值：將定時器的值以數(shù)值型的方式輸出（數(shù)值格式）

參數(shù)：定時器號

實(shí)例：Data3=!TimcrValuc（1,0）,取定時器1的值給Data3

!TimerStr（定時器號，轉(zhuǎn)換類型）

函數(shù)意義：以時間類字符串的形式返回當(dāng)前定時器的值

返回值：字符型變量，將定時器的值以字符型的方式輸出(時間格式)

參數(shù)：定時器號

轉(zhuǎn)換類型(fixing)值：開關(guān)型

=0：取定時器的值以“00：00”形式(xingshi)輸出；

=1：取定時器的值以“00：00：00”形式(xingshi)輸出；

=2：取定時器的值以“000：00：00”形式(xingshi)輸出；

=3：取定時器的值以“000：00：00.000”形式(xingshi)輸出；

實(shí)例：Time=!TimerStr(1,1),取定時器的值以“00：00：00”形式輸出給

Time

!TimerState(定時器號)

函數(shù)意義：取定時器的工作狀態(tài)

返回值：數(shù)值型變量，0-定時器停止，1-定時器運(yùn)行

參數(shù)：定時器號

實(shí)例；datal=!TimerState(1),取定時器1的工作狀態(tài)給datal

!TimerSetLimit(定時器號，上限值，參數(shù)3)

函數(shù)意義：設(shè)置定時器的最大值，即設(shè)置定時器的上限

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：定時器號；上限值；參數(shù)3,1-表示運(yùn)行到60后停止；0-表示運(yùn)

行到60后重新循環(huán)運(yùn)行

實(shí)例：！TimerSetLimit。，60,1),設(shè)置1號定時器的上限為60,運(yùn)行到60

后停止。

!TimerSetOutput(定時器號，數(shù)值型變量)

函數(shù)意義：設(shè)置定時器的值輸出連接的數(shù)值型變量

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：定時器號；數(shù)值型變量，定時器的值輸出連接的數(shù)值型變量

實(shí)例：！TimerSetOutput(l,DataO),將1號定時器的數(shù)據(jù)連接到Data。

!TimerWaitFor(定時器號，數(shù)值)

函數(shù)意義：等待定時器工作到“數(shù)值”指定的值肖，腳本程序才向下執(zhí)行

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：定時器號；數(shù)值，等待定時器工作到指定的值

實(shí)例：！TimerWaitFor(l,55),等定時器工作到55秒后再執(zhí)行其他操作

系統(tǒng)操作函數(shù)

!AppActive(Title)

函數(shù)(hGnshU)意義:激活(jihu6)指定的應(yīng)用程序。使用時一般先用!Shell函

數(shù)啟動指定(zhldlng)的應(yīng)用程序，然后用本函數(shù)激活應(yīng)用程序，再

用！SendKeys函數(shù)發(fā)送(fdsbng)擊鍵消息，控制應(yīng)用程序的執(zhí)行。

返回值：數(shù)值(shfizi)型。返回值=0：調(diào)用成功；?()：調(diào)用失敗。

參數(shù)：Title,字符型，字符串表達(dá)式，所要激活的應(yīng)用程序窗口的標(biāo)題。

實(shí)例：!Shell("D:\Office\Excel.exe”,6)

!AppActive(uMicrosorftExcel-Booklv)

說明：AppActivate語句將焦點(diǎn)移動到命名的應(yīng)用程序或窗口，但并不影響焦

點(diǎn)是否最大化或最小化。當(dāng)用戶采取行動改變焦點(diǎn)或?qū)⒋翱陉P(guān)閉時，就會將焦

點(diǎn)從活動的應(yīng)用程序窗口移動出去。可用Shell函數(shù)啟動一個應(yīng)用程序并沒置

窗口樣式。在決定激活哪個應(yīng)用程序時，將title與每一個運(yùn)行中的應(yīng)用程序

的標(biāo)題字符串進(jìn)行比較。如果沒有完全匹配，就激活任何這樣的應(yīng)用程序，其

標(biāo)題字符串以title開頭。如果以title命名的應(yīng)用程序有很多實(shí)例，則激

活任意一個實(shí)例。

!Beep()

函數(shù)意義：發(fā)出嗡鳴聲。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：無。

實(shí)例：!Beep()

!EnableDDEConnection(DatName,n)

函數(shù)意義：啟動/停止數(shù)據(jù)對象的DDE連接。

返回值：數(shù)值型。返回值二0：調(diào)用失??；C0：調(diào)用成功。

參數(shù):DatName,數(shù)據(jù)對象名;

n,數(shù)值型，為1時表示啟動數(shù)據(jù)對象的DDE連接。為0時則停止數(shù)據(jù)對象的

DDE連接。

實(shí)例：！EnableDDEConnection(溫度，1),啟動數(shù)據(jù)對象“溫度”的DDE連

接。

!Enablel)I)EInput(DatName,n)

函數(shù)意義：啟動/停止數(shù)據(jù)對象的DDE連接時外部數(shù)值的輸入。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：DatName,數(shù)據(jù)對象名；

n,數(shù)值型，為1時表示啟動數(shù)據(jù)對象的DDE連接，接收外部數(shù)值的輸入。為0

時則停止數(shù)據(jù)對象的DDE連接過程中外部數(shù)值的瑜入。

實(shí)例：！EnableDDEConnection(壓力(ydli),1>啟動數(shù)據(jù)(shCijfi)對象”壓力

(yali)"的DDE連接,接收外部數(shù)值(shUzD的輸入。

!EnableDDEOutput(DatName,n)

函數(shù)(hGnshti)意義：啟動/停止數(shù)據(jù)對象的DDE連接時向外部輸出數(shù)值。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：DatName,數(shù)據(jù)對象名；

n,數(shù)值型，為1時表示啟動數(shù)據(jù)對象的DDE連接時向外部輸出數(shù)值的功能.為

0時則停止數(shù)據(jù)對象的DDE連接時向外部輸出數(shù)值的功能。

實(shí)例：！EnableDDEConncction(壓力，1),啟動數(shù)據(jù)對象“壓力”通過DDE連

接向外部輸出數(shù)值的功能。

!LinePrtOutput(str)

函數(shù)意義：輸出到行式打印機(jī)。

返回值：數(shù)值型。返回值二0：調(diào)用成功；?()：調(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：播放一遍，啟動潘放，立即返回。

=3：循環(huán)播放，啟動循環(huán)播放后立即返回。

實(shí)例：！PlaySound("c:\ring.wav"，1)播放聲音文件。

!SendKeys(string)

函數(shù)意義：將一個或多個按鍵消息發(fā)送到活動窗口，就如同在鍵盤上進(jìn)行輸入

一樣。

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：string,字符串表達(dá)式，指定要發(fā)送的按鍵消息。

實(shí)例：！SendKeys(〃％]F4}〃)，給當(dāng)前激活的程序發(fā)送Alt+F4擊鍵消息。

說明：每個按鍵由一個或多個字符表示。為了指定單一鍵盤字符，必須按字符

本身的鍵。例如，為了表示字母A,可以用〃A〃作為stringo為了表示多個

字符，就必須在字符后面直接加上另一個字符。例如，要表示A、B及C,可

用〃ABC〃作為stringo對SendKeys來說，加號（+）、插入符O、百分比

符號（%）,上劃線及圓括號（）都具有特殊意義。為了指定上述任何一

個字符，要將它放在大括號（｛｝）當(dāng)中。例如，要指定正號，可用｛+｝表示。

為了指定大括號字符，請使用｛｛｝及｛｝｝。為了在按下按鍵時指定那些不顯示

的字符，例如：ENTER或TAB以及那些表示動作而非字符的按鍵，請使用下列

代碼：

按鍵Snjian)代碼（d氯ma）

BACKSPACE{BACKSPACE),{BS},或{BKSP}

BREAK(BREAK)

CAPSLOCK{CAPSLOCK}

DELorDELETE{DELETE}或{DEL}

DOWNARROW{DOWN)

END[END)

ENTER{ENTER)或?

ESC{ESC)

HOME{HOME}

INSorINSERT{INSERT)或{INS}

LEFTARROW{LEFT}

NUMLOCK{NUMLOCK)

PAGEDOWN{PGDN}

PAGEUP{PGUP}

RIGHTARROW(RIGHT)

SCROLLLOCK{SCROLLLOCK}

TAB{TAB}

UPARROW{UP}

Fl{Fl}F7{F7}

F2{F2}F8{F8}

F3{F3}F9{F9}

F4{F4}F10{F10}

F5{F5}Fil{Fil)

F6{F6}F12{F12}

F13{F13}F15{F15)

F14{F14}F16(F16)

為了(wVile)指定那些與SHIFT、CTRL及ALT等按鍵結(jié)合的組合鍵,可在這

些按鍵碼的前面放置一個或多個(du。gS代碼，這些代碼列舉如下：

按鍵Gnjian)代碼(daima)

SHIFT+

CTRL.

ALT%

為了說明在按下其它(qi'tA)按鍵時應(yīng)同時按下SHIFT、CTRL、及ALT的任意組

合鍵，請把那些按鍵的碼放在括號當(dāng)中。例如，為了說明按下E與C的時候

同時按下SHIFT鍵，請使用〃+(EC)〃。為了說明在按下E的時候同時按下

SHIFT鍵，但接著按C而不按SHIFT,則使用〃-EC〃。

注意：不能用SendKeys將按鍵消息發(fā)送到這樣一個應(yīng)用程序，這個應(yīng)用程序

并沒有被設(shè)計(jì)成在MicrosoftWindows中運(yùn)行。Sendkeys也無法將PRINT

SCREEN按鍵｛PRTSC｝發(fā)送到任何應(yīng)用程序。

!SetLinePrinter(n)

函數(shù)意義:打開/關(guān)閉行式打印輸出。

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：n,數(shù)值型，1,表示打開行式打印輸出；0,則關(guān)閉行式打印輸出。

實(shí)例：！SetLinePrinter(l),打開行式打印輸出。

!SetTime(nLn2,n3,n4,n5,n6)

函數(shù)意義：設(shè)置當(dāng)前系統(tǒng)時間

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：nl,數(shù)值型，沒定年數(shù)，小于1000和大于9999時不變；

n2,數(shù)值型，設(shè)定月數(shù)，大于12和小于1時不變；

n3,數(shù)值型，設(shè)定天數(shù)，大于31和小于1時不變；

n4,數(shù)值(shCizi)型，女定小時數(shù)，大于23和小于0時不變；

n5,數(shù)值(shOzi)型，沒定分鐘數(shù)，大于59和小于。時不變；

n6,數(shù)值(shfizi)型,設(shè)定秒數(shù),大于59和小于0時不變。

實(shí)例：！SetTime(2000,1,1,1,1,1),設(shè)置當(dāng)前系統(tǒng)(xitbng)時間為

2000年1月1日1時：分1秒。

!Shell(pathname>windowstyle)

函數(shù)(hdnshd)意義：啟動并執(zhí)行指定的外部可執(zhí)行文件。

返回值：數(shù)值型。返回值二0：調(diào)用成功；二1：調(diào)用失敗。

參數(shù)：pathname,字符型，要執(zhí)行的外部應(yīng)用程序的名稱，以及任何必需的參

數(shù)或命令行變量，包括路徑。

windowstyle,數(shù)值型，指定被執(zhí)行的外部應(yīng)用程序窗口的狀態(tài)。

windowstyle命名參數(shù)有以下這些值：

常量值描述

VbHide0窗口被隱藏，且焦點(diǎn)會移到隱式窗口。

VbNormalFocus1窗口具有焦點(diǎn)，且還原到它原來的大小和位

置。

VbMinimizedFocus2窗口會以一個具有焦點(diǎn)的圖標(biāo)來顯示。

VbMaximizedFocus3窗口是一個具有焦點(diǎn)的最大化窗口。

VbNormalNoFocus4窗口會被還原到最近使用的大小和位置，而

當(dāng)

前活動的窗口仍然保持活動。

VbMinimizedNoFocusG窗口會以一個圖標(biāo)來顯示。而當(dāng)前活動的的

窗

口仍然保持活動。

實(shí)例：！Shell("D:\Office\Excel.exe",3),啟動Excel,并使其最大化顯

示。

說明：如果Shell函數(shù)成功地執(zhí)行了所要執(zhí)行的文件，則它會返回程序的任

務(wù)ID。任務(wù)ID是一個唯一的數(shù)值，用來指明正在運(yùn)行的程序。

注意：Shell函數(shù)是以異步方式來執(zhí)行其它程序的。也就是說，用Shell啟

動的程序可能還沒有完成執(zhí)行過程，就已經(jīng)執(zhí)行到Shell函數(shù)之后的語句。

ISleep(mTime)

函數(shù)(hGnshti)意義：在腳本程序(chCngxU)中等待mTime毫秒，然后再執(zhí)行下條

語句。只能(zhinCng)在策略中使用，否則會造成系統(tǒng)響應(yīng)緩慢。

返回值：數(shù)值(shUzi)型。返回值二0：調(diào)用(didoying)成功；<>0：調(diào)用失

敗。

參數(shù)：mTime,數(shù)值型，要等待的毫秒數(shù)。

實(shí)例：!Sleep(10)

!TerminateApplication(AppName,Timeout)

函數(shù)意義：強(qiáng)行關(guān)閉指定的應(yīng)用程序。

返回值：數(shù)值型。返回值二0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：AppName,字符型，應(yīng)用程序標(biāo)題名，也就是顯示在任務(wù)欄上的應(yīng)用程

序的名字。

Timeout,開關(guān)型，等待超時時間，以秒為單位

實(shí)例：ITerminateApplication(^MicrosoftExcel-Bookl”,5)關(guān)閉

microsoftexcel-bookl

IWaitFor(DatLDat2)

函數(shù)意義：在腳本程序中等待設(shè)置的條件滿足，腳本程序再向下執(zhí)行。只能在

策略中使用，否則造成系統(tǒng)響應(yīng)緩慢。

返回值：數(shù)值型。返回值調(diào)用成功；<>0：調(diào)用失敗。

參數(shù)：Datl,數(shù)值型，條件表達(dá)式，如：D=15o

Dat2,數(shù)值型，等待條件滿足的超時時間，單位：ms。為0則無限等待。

實(shí)例：！WaitFor(D=15,12000),等變量D的值等于15后，程序再繼續(xù)執(zhí)

行，如果在12秒后條件仍然沒有滿足，也自動繼續(xù)執(zhí)行。此函數(shù)通常用于做實(shí)

驗(yàn)時，等待某個條件滿足，然后再接著執(zhí)行實(shí)驗(yàn)流程。他與Sleep函數(shù)以及

While循環(huán)語句、其他循環(huán)策略配合，能夠?qū)崿F(xiàn)復(fù)雜的流程調(diào)度。

注意：！WaitFor只能用丁策略中，而不能直接在窗口控件的腳本程序中使

用。

!WinHelp(HelpFileName,uCommand>dwData)

函數(shù)意義：調(diào)用Windows幫助文件。

返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。

參數(shù):HeipFileName,字符型，幫助文件名。

Ucommand,開關(guān)型，

二1,顯示由上下文編號標(biāo)識的特定主題的幫助。

=2,關(guān)閉幫助(bGngzhii)窗口。

=3,彈出幫助(bGngzhU)內(nèi)容。

=11,彈出查找(chdzhdo)幫助對話框。

當(dāng)Ucommand=2,3,11時，dwData=0,開關(guān)(kGigudn)型

當(dāng)Ucommand=1時，dwData為上下文編號(bidnhdo)的數(shù)值

實(shí)例：！WinHelp("c:\Lhlp"，3,0)打開幫助文件C:\Lhip

!Navigate(WebAddress)

函數(shù)意義：引導(dǎo)瀏覽器瀏覽其他的網(wǎng)頁，只有在使用WWW版進(jìn)行IE瀏覽時有

效。

返回值：開關(guān)型，返回值=0,調(diào)用成功；返回值<>0,調(diào)用失敗

參數(shù)：WebAddress,字符型，所要瀏覽的網(wǎng)址。

實(shí)例：'Navigate(uwww.mcgs.corn.cnv).

!DDEReconnect()

函數(shù)意義：重新檢查并恢復(fù)所有的DDE連接。

返回值：開關(guān)型，返回值二0,調(diào)用成功；返回值<>0,調(diào)用失敗

參數(shù)：無參數(shù)

實(shí)例：IDDEReconnect()

!ShowDataBackup()

函數(shù)意義：顯示數(shù)據(jù)備份恢復(fù)對話框，需要先定義有存盤屬性的數(shù)據(jù)對象，再

啟動存盤數(shù)據(jù)備份設(shè)置，此函數(shù)才有效。

返回值：數(shù)值型，返回值=0,調(diào)用成功；返回值<>0,調(diào)用失敗

參數(shù)：無參數(shù)

實(shí)例：！ShowDataBackup().

數(shù)學(xué)函數(shù)

!Atn(x)

函數(shù)意義：反正切函數(shù)。

返回值：數(shù)值型，用弧度表示。

參數(shù)：x,數(shù)值型。

實(shí)例：!Atn(l)=0.785398

!Arcsin(x)

函數(shù)意義：反正弦函數(shù)。

返回值：數(shù)值型，用弧度表示。

參數(shù)：x,數(shù)值型。范圍為-1?1之間的值。

實(shí)例：!arcsin(l)=1.5708

!Arccos(x)

函數(shù)(hGnshti)意義：反余弦(yUxidn)函數(shù)。

返回值：數(shù)值型，用弧度(血加)表示。

參數(shù)：x,數(shù)值(shUzD型。范圍為T?1之間的值。

實(shí)例：！arccos(0.5)=1.0472

!Cos(x)

函數(shù)(hGnshti)意義：余弦函數(shù)。

返回值：數(shù)值型。

參數(shù)：x,數(shù)值型，用弧度表示。

實(shí)例：!Cos(3.14159；=-1.0

!Sin(x)

函數(shù)意義：正弦函數(shù)。

返回值：數(shù)值型。

參數(shù)：x,數(shù)值型，用弧度表示。

實(shí)例：!Sin(3.14159)=0.0

!Tan(x)

函數(shù)意義：正切函數(shù)。

返回值：數(shù)值型。

參數(shù)：x,數(shù)值型，用弧度表示。

實(shí)例：!Tan(3.14159；=0.0

!Exp(x)

函數(shù)意義：指數(shù)函數(shù)。

返回值：數(shù)值型。

參數(shù)：x,數(shù)值型。

實(shí)例：!Exp(2.3020585093)=10.0

!Log(x)

函數(shù)意義：對數(shù)函數(shù)。

返回值：數(shù)值型。

參數(shù)：x,數(shù)值型。

實(shí)例：!Log(10)=2.302

!Sqr(x)

函數(shù)意義：平方根函數(shù)。

返回值：數(shù)值型。

參數(shù)：x,數(shù)值型。

實(shí)例：!Sqr(4.0)=2.0

!Abs(x)

函數(shù)(hdnshd)意義：絕對值函數(shù)(hdnshO)。

返回值：數(shù)值(shUzD型。

參數(shù):x,數(shù)值(shCizi