MCGS嵌入版運(yùn)行環(huán)境操作函數(shù)

1、MCGS內(nèi)部函數(shù)運(yùn)行環(huán)境操作函數(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)用正

2、常。<>0：調(diào)用不正常。參 數(shù)：WndName， 用戶窗口名，字符型。實(shí) 例：!CloseAllWindow("工況圖")，關(guān)閉除了用戶窗口“工況圖”以外的其他窗口，若“工況圖”窗口沒有打開，則在關(guān)閉其他窗口的同時(shí)打開該窗口；!CloseAllWindow(" ")，關(guān)閉所有窗口。!CloseAllSubWnd()函數(shù)意義：關(guān)閉窗口中的所有子窗口。返 回 值：浮點(diǎn)型，=0為操作。實(shí) 例：!CloseAllSubWnd() ，關(guān)閉當(dāng)前窗口的所有子窗口。!CloseSubWnd（WndName）函數(shù)意義：關(guān)閉子窗口。返 回 值：浮點(diǎn)型，=1為操作

3、成功，<>1為操作失敗。參 數(shù) 值：WndName：子窗口的名字。實(shí) 例：!CloseSubWnd(窗口1)，關(guān)閉子窗口“窗口1”。!EnableStgy(StgyName,n)函數(shù)意義：打開或關(guān)閉某個(gè)策略，如報(bào)警策略或循環(huán)策略等。返 回 值：數(shù)值型。返回值=0：調(diào)用正常，<>0：調(diào)用不正常。參 數(shù)：SstgyName，策略名；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ù)意義：按

4、設(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)。注 意：

5、設(shè)備名稱是在設(shè)備構(gòu)件基本屬性頁(yè)中設(shè)置的。 !GetLastMouseActionTime()函數(shù)意義：獲取最后一次鼠標(biāo)的動(dòng)作發(fā)生的時(shí)間。返 回 值：開關(guān)型。返回為time_t類型的時(shí)間值，可以在時(shí)間操作腳本函數(shù)中使用。參 數(shù)：無(wú)。實(shí) 例：在畫面，系統(tǒng)對(duì)話框上的鼠標(biāo)事件中添加!GetLastMouseActionTime()，獲取鼠標(biāo)最后動(dòng)作時(shí)間。 !GetStgyName(Index)函數(shù)意義：按運(yùn)行策略的順序獲得各策略塊的名字。返 回 值：字符型。參 數(shù)：Index，數(shù)值型。實(shí) 例：!GetStgyName(0)，取0號(hào)運(yùn)行策略的名稱。!GetWindowName(Ind

6、ex)函數(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)。!OpenSubWnd（參數(shù)1,參數(shù)2，參數(shù)3，參數(shù)4，參數(shù)5，參數(shù)6）函數(shù)意義：顯示子窗口。返 回 值：

7、字符型，如成功就返回子窗口n，n表示打開的第n個(gè)子窗口。參 數(shù) 值：參數(shù)1：要打開的子窗口名。參數(shù)2：整型，打開子窗口相對(duì)于本窗口的X坐標(biāo)。參數(shù)3：整型，打開子窗口相對(duì)于本窗口的Y坐標(biāo)。參數(shù)4：整型，打開子窗口的寬度。參數(shù)5：整型，打開子窗口的高度。參數(shù)6：整型，打開子窗口的類型。0位：是否模式打開，使用此功能，必須在此窗口中使用CloseSubWnd來(lái)關(guān)閉本子窗口，子窗口外別的構(gòu)件對(duì)鼠標(biāo)操作不響應(yīng)1位：是否菜單模式，使用此功能，一旦在子窗口之外按下按鈕，則子窗口關(guān)閉。2位：是否顯示水平滾動(dòng)條，使用此功能，可以顯示水平滾動(dòng)條3位：是否垂直顯示滾動(dòng)條，使用此功能，可以顯示垂直滾動(dòng)條4位：是否顯示

8、邊框，選擇此功能，在子窗口周圍顯示細(xì)黑線邊框5位：是否自動(dòng)跟蹤顯示子窗口，選擇此功能，在當(dāng)前鼠標(biāo)位置上顯示子窗口。此功能用于鼠標(biāo)打開的子窗口，選用此功能則忽略iLeft,iTop的值，如果此時(shí)鼠標(biāo)位于窗口之外，則在窗口對(duì)中顯示子窗口6位：是否自動(dòng)調(diào)整子窗口的寬度和高度為缺省值，使用此功能則忽略iWidth和iHeight的值。子窗口的關(guān)閉辦法：使用關(guān)閉窗口直接關(guān)閉，則把整個(gè)系統(tǒng)中使用到的此子窗口完全關(guān)閉使用指定窗口的CloseSubWnd關(guān)閉，可以使用OpenSubWnd返回的控件名，也可以直接指定子窗口關(guān)閉，此時(shí)只能關(guān)閉此窗口下的子窗口。!SetActiveX()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)

9、效，考慮兼容性問(wèn)題，故保留。!CallBackSvr()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!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è)備的工作周期，Cmd

10、Str中包含新的工作周期，單位為ms。6：執(zhí)行指定的設(shè)備命令，CmdStr中包含指定命令的格式。實(shí) 例：!SetDevice(OmronPLC,1," " )，啟動(dòng)設(shè)備構(gòu)件“OmronPLC”開始工作。 !SetMousePace(開關(guān)型)函數(shù)意義：設(shè)置鼠標(biāo)靈敏度。參 數(shù)：開關(guān)型參數(shù)為每次按鍵消息需要設(shè)置的鼠標(biāo)移動(dòng)間隔，一般情況下請(qǐng)輸入正整數(shù)，如果輸入0值表示禁止該功能實(shí) 例：!SetMousePace(1); 默認(rèn)情況下該功能為關(guān)閉狀態(tài)，鼠標(biāo)靈敏度為0，如果想啟用該功能在啟動(dòng)策略中調(diào)用!SetMousePace腳本函數(shù)指定步長(zhǎng)值。 !SetNumPanelSiz

11、e(Type,Size)函數(shù)意義：根據(jù)需要和顯示屏的大小調(diào)整軟鍵盤的大小。返 回 值：開關(guān)型。返回值=0：修改成功。新設(shè)置將在下一次打開輸入鍵盤時(shí)生效。返回值=1：修改失敗，參數(shù)錯(cuò)誤。（可能是沒有匹配的type ，或者size參數(shù)超出范圍）。參 數(shù)：Type，鍵盤類型，數(shù)值型；1：代表修改數(shù)值輸入鍵盤。2：代表修改字符輸入鍵盤；。3：代表修改用戶登錄對(duì)話框。Size，鍵盤大小，數(shù)值型；數(shù)值范圍：200像素1024像素；實(shí) 例：!SetNumPanelSize(1,500)，將數(shù)值輸入鍵盤改為500*500大小，該正方形相對(duì)于屏幕居中。所有修改將在下一次打開輸入框時(shí)生效，運(yùn)行環(huán)境退出后，將自動(dòng)保

12、留上次輸入框的大小。注意事項(xiàng)：鍵盤放大縮小功能在重新下載工程時(shí)沒有刪除配置文件，換工程后設(shè)置仍然有效，除非重新進(jìn)行了設(shè)置。如果要去掉原來(lái)的設(shè)置則需要手工刪除panelSize.ini文件，該文件位于harddiskmcgsbin目錄下。  !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ù)意義：按照名字操作用戶窗口，如打開、

13、關(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í) 例：!SysWindo

14、w()。!SetStyMode(StgyName)函數(shù)意義：通過(guò)腳本函數(shù)（位于系統(tǒng)函數(shù)-運(yùn)行環(huán)境類）實(shí)現(xiàn)函數(shù)調(diào)用方式的策略調(diào)用。返回 值：開關(guān)型，返回值恒為0。參 數(shù)：StgyName，策略名，字符型。實(shí) 例：!SetStgyMode(閥門關(guān)閉)，執(zhí)行一次運(yùn)行策略“閥門關(guān)閉”，“閥門關(guān)閉”策略執(zhí)行完畢后，才返回調(diào)用者，調(diào)用者繼續(xù)執(zhí)行以下程序。 !GetCurrentLanguageIndex( ) 函數(shù)意義：用于獲取當(dāng)前使用的語(yǔ)言的索引值。 返 回 值：開關(guān)型。返回值為語(yǔ)言項(xiàng)索引值。 索引值按照組態(tài)下拉框依次排序0，1，2 參 數(shù)： 無(wú)。 實(shí) 例：N=!GetCurrentLangu

15、ageIndex( ) ，其中N為開關(guān)型變量 。 !SetCurrentLanguageIndex ( 開關(guān)型 ) 函數(shù)意義：通過(guò)索引項(xiàng)設(shè)定當(dāng)前語(yǔ)言環(huán)境 返 回 值：開關(guān)型。返回值為0表示執(zhí)行成功，否則表示失敗。 參 數(shù)：開關(guān)型。語(yǔ)言索引值。如果索引參數(shù)值超出當(dāng)前選擇語(yǔ)言范圍，那么函數(shù)不生效。 實(shí) 例：!SetCurrentLanguageIndex(1)，表示設(shè)置當(dāng)前語(yǔ)言為英文（選擇語(yǔ)言為CH，EN）。 !GetLocalLanguageStr( 開關(guān)型 ) 函數(shù)意義：獲得指定自定義ID對(duì)應(yīng)的當(dāng)前語(yǔ)言的內(nèi)容。 返 回 值：字符型。 參 數(shù)：開關(guān)型。自定義ID索引值。如果無(wú)當(dāng)前ID對(duì)應(yīng)自定義文

16、本，則返回空值。 實(shí) 例：!GetLocalLanguageStr（2），前提是有ID為2的自定義文本內(nèi)容，如果當(dāng)前語(yǔ)言為英文，則返回ID為2的自定義文本記錄的英文內(nèi)容。 !GetLanguageNameByIndex(開關(guān)型) 函數(shù)意義：根據(jù)語(yǔ)言索引值返回語(yǔ)言名稱，返回值為字符型。 返 回 值：字符型，當(dāng)前語(yǔ)言的名稱。 參 數(shù)：開關(guān)型。語(yǔ)言的索引值。如果當(dāng)前索引值無(wú)對(duì)應(yīng)語(yǔ)言，則返回空值。 實(shí) 例：!GetLanguageNameByIndex(1) ，假如當(dāng)前語(yǔ)言為中文、英文，則返回值為English。數(shù)據(jù)對(duì)象操作函數(shù)   !AnswerAlm(DatName) 

17、;函數(shù)意義：應(yīng)答數(shù)據(jù)對(duì)象DatName所產(chǎn)生的報(bào)警。如對(duì)應(yīng)的數(shù)據(jù)對(duì)象沒有報(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ù)：Dat

18、name，數(shù)據(jù)對(duì)象名；n，數(shù)值型，以秒表示的存盤間隔時(shí)間。實(shí)    例：!ChangeDataSave(溫度,5)， 溫度的存盤間隔時(shí)間為5秒。 !ChangeSaveData(DatName,Num1,Num2) 該函數(shù)在通用版中可以使用，在嵌入版中不能使用！函數(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)

19、用正常，<>0：調(diào)用不正常。參    數(shù)：DatName：數(shù)據(jù)對(duì)象名。Num1：數(shù)值型時(shí)間量，單位：小時(shí)。本函數(shù)用Num1<0的一些數(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í)  

20、;  例：!ChangeSaveData(電機(jī)1,-2,5)，把組對(duì)象“電機(jī)1”對(duì)應(yīng)的存盤數(shù)據(jù)中昨天的存盤數(shù)據(jù)的存盤間隔改為5秒鐘。 !FlushDataInitValueToDisk() 函數(shù)意義：把所有數(shù)據(jù)對(duì)象的初始值寫入磁盤。返 回 值：數(shù)值型，返回值=0：調(diào)用正常，<>0：調(diào)用不正常。參    數(shù)：無(wú)。 !CopySaveDat() 函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。 !DelSaveDat(DatName,Num) 函數(shù)意義：刪除組對(duì)象DatName對(duì)

21、應(yīng)的存盤數(shù)據(jù)中最早Num小時(shí)內(nèi)的存盤數(shù)據(jù)，如果 Num <= 0 ,那么就是刪除該組對(duì)象全部的存盤數(shù)據(jù)。如果 Num > 0, 就刪除以當(dāng)前時(shí)間為基點(diǎn)Num個(gè)小時(shí)之前的內(nèi)容,刪除時(shí)是按文件刪除的，如果數(shù)據(jù)不足一個(gè)存盤文件，是不會(huì)被刪除的。返 回 值：數(shù)值型，返回值=0：調(diào)用正常，<>0：調(diào)用不正常。參    數(shù)：DatName，組對(duì)象名。          Num , 參數(shù)名。實(shí)    例：!DelSaveDat(電機(jī)溫度

22、，12) ，刪除組對(duì)象“電機(jī)溫度”對(duì)應(yīng)的存盤數(shù)據(jù)中以當(dāng)前時(shí)間為基點(diǎn)倒推12個(gè)小時(shí)之前的數(shù)據(jù)。但從當(dāng)前時(shí)間至倒推的12個(gè)小時(shí)之內(nèi)的內(nèi)容會(huì)被保存。注    意：該函數(shù)只對(duì)組對(duì)象操作有效。 !DelAllSaveDat() 函數(shù)意義：刪除組對(duì)象DataName對(duì)應(yīng)的所有存盤數(shù)據(jù)。注意，此函數(shù)不能用來(lái)刪除組對(duì)象所對(duì)應(yīng)的報(bào)警存盤數(shù)據(jù)。返 回 值：數(shù)值型，返回值=0：調(diào)用正常，<>0：調(diào)用不正常。參    數(shù)：DatName：組對(duì)象名；實(shí)    例：!DelAllSaveDat（電機(jī)溫

23、度），刪除組對(duì)象“電機(jī)溫度”對(duì)應(yīng)的所有存盤數(shù)據(jù)注    意：該函數(shù)只對(duì)組對(duì)象操作有效。  !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í)存盤。 !ExportHisDataToCSV(文件

24、名,組對(duì)象名,字段名,開始時(shí)間,結(jié)束時(shí)間,最大記錄數(shù),導(dǎo)出模式,導(dǎo)出參數(shù),進(jìn)度指示數(shù)據(jù)對(duì)象名,取消控制數(shù)據(jù)對(duì)象名) 函數(shù)意義： 1.導(dǎo)出指定組對(duì)象存盤數(shù)據(jù)，導(dǎo)出的條件包括：開始時(shí)間-結(jié)束時(shí)間，最大導(dǎo)出總條數(shù); 2.導(dǎo)出字段列表，組對(duì)象為MCGS_ALARM則表示導(dǎo)出報(bào)警歷史數(shù)據(jù)； 3.可指定導(dǎo)出文件名和路徑，主要是U盤導(dǎo)出，可以追加方式也可覆蓋方式導(dǎo)出； 4.可顯示導(dǎo)出過(guò)程進(jìn)度情況； 5.可取消和中止長(zhǎng)時(shí)間的導(dǎo)出過(guò)程； 6.導(dǎo)出格式為csv文件，導(dǎo)出的第一行為字段名字。返 回 值：開關(guān)型。返回1  

25、60; 指定組對(duì)象錯(cuò)誤，可能組對(duì)象沒有保存歷史數(shù)據(jù)或者沒有該組對(duì)象返回2    指定的時(shí)間格式錯(cuò)誤返回3    指定的無(wú)效的數(shù)據(jù)對(duì)象名返回4    無(wú)效的導(dǎo)出模式返回5    同時(shí)只能支持一個(gè)csv導(dǎo)出參    數(shù)：文件名：字符型，指定導(dǎo)出的文件絕對(duì)路徑名，指定的第一級(jí)目錄不能創(chuàng)建，其子目錄如果不存在則可以創(chuàng)建。這樣避免U盤不存在時(shí)創(chuàng)建U盤目錄。注意：第一級(jí)目錄不能自動(dòng)創(chuàng)建用戶必須保證其存在；組對(duì)象名：導(dǎo)出的組對(duì)象名字。字段名：字符型，用逗號(hào)分隔

26、的要導(dǎo)出的字段名，不需要指定時(shí)間字段，默認(rèn)第一二個(gè)字段就為記錄時(shí)間字段。如果為空字符串則導(dǎo)出所有字段。開始時(shí)間，結(jié)束時(shí)間：用表示的時(shí)間字符串 “YYYY-MM-DD HH：MM：SS”；最大記錄數(shù)：希望導(dǎo)出的最大記錄數(shù)，超過(guò)該記錄數(shù)就返回，停止導(dǎo)出；導(dǎo)出模式：“1”表示覆蓋現(xiàn)有文件，“2”表示追加到文件最后；導(dǎo)出參數(shù)：暫時(shí)為空，保留以后使用；進(jìn)度指示數(shù)據(jù)對(duì)象名：開關(guān)型數(shù)據(jù)對(duì)象，導(dǎo)出過(guò)程中該對(duì)象值反映出當(dāng)前已導(dǎo)出記錄條數(shù)，如果導(dǎo)出過(guò)程中其他異常結(jié)束則通過(guò)該對(duì)象返回同函數(shù)返回錯(cuò)誤碼；         

27、0;          進(jìn)度指示錯(cuò)誤碼：              返回-1-文件不能打開              返回-2-沒有可導(dǎo)出的數(shù)據(jù)       &

28、#160;      返回-4-文件操作出現(xiàn)錯(cuò)誤控制數(shù)據(jù)對(duì)象名：指定一個(gè)開關(guān)型數(shù)據(jù)對(duì)象,該對(duì)象控制導(dǎo)出執(zhí)行，啟動(dòng)導(dǎo)出時(shí)會(huì)自動(dòng)設(shè)置該變量為0，用戶在導(dǎo)出過(guò)程中想取消導(dǎo)出則可以設(shè)置該值為<0的任何值，導(dǎo)出函數(shù)運(yùn)行結(jié)束后會(huì)自動(dòng)設(shè)置對(duì)象值為1；                進(jìn)度指示錯(cuò)誤碼：        &#

29、160;     返回0-導(dǎo)出成功              返回-1-導(dǎo)出路徑不存在              返回1-指定組對(duì)象錯(cuò)誤，可能組對(duì)象沒有保存歷史數(shù)據(jù)或者沒有該組對(duì)象       

30、60;      返回2-指定的時(shí)間格式錯(cuò)誤              返回3-指定的無(wú)效的數(shù)據(jù)對(duì)象名              返回4-無(wú)效的導(dǎo)出模式         

31、     返回5-同時(shí)只能支持一個(gè)csv導(dǎo)出實(shí)    例: ret= !ExportHisDataToCSV("usb harddiskyang.csv","group","data1,data4","2007/1/1 0:0:0","2009/1/1 0:0:0",20000,1,"",進(jìn)度,控制) !GetAlmValue(DatName,Value,Flag) 函數(shù)意義：

32、讀取數(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)警限值；

33、=7 偏差報(bào)警基準(zhǔn)值；實(shí)    例:!GetAlmValue(電機(jī)溫度,Value,3)，讀取數(shù)據(jù)對(duì)象“電機(jī)溫度”的報(bào)警上限值，放入數(shù)值型數(shù)據(jù)對(duì)象Value中。 !GetEventDT() 函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。 !GetEventP() 函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。 !GetEventT() 函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。 !MoveSaveDat() 函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)

34、題，故保留。 !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)保

35、存數(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()。注    意：此函數(shù)單獨(dú)使用不起作用，需要和函數(shù)!Flushdatainitvaluetodisk()一起使用。 !SaveDataOnTime(Time,TimeMS,DataName) 

36、函數(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í)間函數(shù)轉(zhuǎn)換出的時(shí)間量。時(shí)間精度到秒。TimeMS，數(shù)值型，指定存盤時(shí)間的毫秒數(shù)。實(shí)    例：t =!TimeStr2I("2001年2月21日3時(shí)2分3秒")；!SaveDataOnTime (t,0,DataGroup)， 按照指定時(shí)間保存數(shù)據(jù)對(duì)象。 !SaveSingleDataInit(Na

37、me) 函數(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,Flag) 函數(shù)意義：設(shè)置數(shù)據(jù)對(duì)象DatNam

38、e對(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í)  

39、0; 例：!SetAlmValue(電機(jī)溫度,200,3)，把數(shù)據(jù)對(duì)象“電機(jī)溫度”的報(bào)警上限值設(shè)為200 !TransToUSB(組對(duì)象名,起始時(shí)間,結(jié)束時(shí)間,導(dǎo)出狀態(tài),進(jìn)度指示,轉(zhuǎn)出模式,保留參數(shù))函數(shù)意義：將XXX組對(duì)象的存盤數(shù)據(jù)導(dǎo)出到"USB HARDDISK"目錄下，保存為“XXX.csv”文件，模擬環(huán)境則是保存到與可執(zhí)行文件相同路徑下。返 回 值：開關(guān)型。 0：參數(shù)沒有錯(cuò)誤。  1：第一個(gè)參數(shù)錯(cuò)誤。（請(qǐng)檢查是否組對(duì)象名稱，或“MCGS_ALARM”）  2: 時(shí)間參數(shù)格式錯(cuò)誤。  3：狀態(tài)變量的類型錯(cuò)誤。（兩個(gè)變量

40、都必須是開關(guān)量）  5：同時(shí)只能支持一個(gè)csv導(dǎo)出。參    數(shù)： 組對(duì)象名：字符型，要導(dǎo)出的組對(duì)象名稱（或“MCGS_ALARM”）。起始時(shí)間：字符型，要導(dǎo)出的歷史數(shù)據(jù)的開始時(shí)間，格式：YYYY-MM-DD HH:MM:SS。結(jié)束時(shí)間：字符型，要導(dǎo)出的歷史數(shù)據(jù)的結(jié)束時(shí)間，格式：YYYY-MM-DD HH:MM:SS。導(dǎo)出狀態(tài)：開關(guān)型，進(jìn)度指示數(shù)據(jù)對(duì)象名（開關(guān)量），輸出導(dǎo)出狀態(tài)。    正常導(dǎo)出存盤后輸出當(dāng)前已經(jīng)導(dǎo)出的記錄條數(shù)。    當(dāng)創(chuàng)建導(dǎo)出文件“XXX.csv”失敗時(shí)輸出1。（請(qǐng)檢查下位機(jī)

41、是否正常插入了U盤）     當(dāng)前沒有記錄可導(dǎo)出時(shí)輸出2。（請(qǐng)檢查對(duì)應(yīng)的組對(duì)象是否有存盤信息，或者開始時(shí)間結(jié)束時(shí)間是否設(shè)置正確）    導(dǎo)出過(guò)程中出現(xiàn)未知數(shù)據(jù)類型時(shí)輸出3。（不應(yīng)該出現(xiàn)）    導(dǎo)出過(guò)程中出現(xiàn)文件操作異常時(shí)輸出4。（請(qǐng)檢查U盤容量是否足夠）進(jìn)度指示：開關(guān)量，指定一個(gè)數(shù)字型或開關(guān)型對(duì)象,該對(duì)象控制導(dǎo)出執(zhí)行，啟動(dòng)導(dǎo)出時(shí)會(huì)自動(dòng)設(shè)置該變量為0，用戶在導(dǎo)出過(guò)程中想取消導(dǎo)出可設(shè)置該變量為<0的任何值，導(dǎo)出函數(shù)運(yùn)行結(jié)束后會(huì)自動(dòng)設(shè)置對(duì)象值為1。     

42、60;     注：6.5（01.0010）之前的版本，此參數(shù)為原導(dǎo)出狀態(tài)變量2，顯示的是導(dǎo)出數(shù)據(jù)總條數(shù)。轉(zhuǎn)出模式：開關(guān)型，保留，設(shè)置為0。保留參數(shù)：字符型，保留, 設(shè)置為空字符串。實(shí) 例：!TransToUSB(MCGS_ALARM , 2008-12-1 00:00:00 , 2008-12-31 00:00:00 , Switch01 , Switch02 , 0 , "")。注意事項(xiàng)：該函數(shù)最多只能導(dǎo)出30000條記錄。當(dāng)滿足導(dǎo)出時(shí)間條件的記錄數(shù)大于30000時(shí)，只導(dǎo)出前30000條記錄。  !CopyDa

43、teFileToDisk(pathName,dataType,copyState) 函數(shù)意義: 拷貝當(dāng)前運(yùn)行工程的數(shù)據(jù)到指定的目錄pathName中。返 回 值:1：在拷貝的過(guò)程中,數(shù)據(jù)對(duì)象copyState,由0轉(zhuǎn)變?yōu)榉?.表示用戶不想繼續(xù)拷貝。0：表示拷貝成功。-1：當(dāng)前工程中,當(dāng)前運(yùn)行工程中沒有組對(duì)象要存盤。-2：創(chuàng)建目錄pathName失敗。    -3：創(chuàng)佳索引文件MCGS_DATA.ini失敗或者對(duì)此文件進(jìn)行寫操作失敗。-4：參數(shù)dataType的值,不正確,目前只支持值為0。-5：磁盤空間不足。-6：參數(shù)copyState不是數(shù)據(jù)對(duì)象類型。

44、-7：參數(shù)copyState是數(shù)據(jù)對(duì)象類型,但不是開關(guān)型數(shù)據(jù)對(duì)象。-8：參數(shù)copyState在一開始調(diào)用此腳本時(shí),就為非0。參數(shù)說(shuō)明:pathName：字符串型.要拷貝數(shù)據(jù)到此的路徑名.例如:在模擬環(huán)境可以寫"d:test",在運(yùn)行環(huán)境可寫"harddisktest"。dataType：開關(guān)型.拷貝數(shù)據(jù)的類型,0表示歷史數(shù)據(jù),1表示報(bào)警數(shù)據(jù).目前只支持拷貝歷史數(shù)據(jù),報(bào)警數(shù)據(jù)還沒有處理。copyState：數(shù)據(jù)對(duì)象型.是否拷貝的標(biāo)志.當(dāng)為0表示可以拷貝,為非0表示取消當(dāng)前的拷貝。實(shí)    例：!CopyDateFileToD

45、isk("harddisktest",0,copyState) 把當(dāng)前工程中歷史數(shù)據(jù)拷貝到目錄"harddisktest"中(如copyState為0表示拷貝,為非表示取消)。說(shuō)    明：一般此腳本要配合組態(tài)環(huán)境中的一個(gè)小程序DataTrans.exe來(lái)一起操作.把拷貝的數(shù)據(jù)目錄,通過(guò)U盤或其他方式,導(dǎo)到上位機(jī)(PC),通過(guò)用程序DataTrans.exe來(lái)進(jìn)行數(shù)據(jù)的轉(zhuǎn)換。用戶登錄操作函數(shù)!ChangePassword()函數(shù)意義：彈出密碼修改窗口，供當(dāng)前登錄的用戶修改密碼。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；<

46、;>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í) 例：!Editu

47、sers()。!EnableExitLogon(n)函數(shù)意義：打開/關(guān)閉退出時(shí)的權(quán)限檢查。返 回 值：數(shù)值型。返回值=1：操作成功；返回值=0：操作失敗。參 數(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í)的提示信息。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。參 數(shù)：n，數(shù)值型，為1時(shí)表示在退出時(shí)彈出提示信息對(duì)話框。為0則退出時(shí)不出現(xiàn)信息對(duì)話框。實(shí) 例：!EnableExit

48、Prompt(1)， 在退出時(shí)彈出提示信息對(duì)話框。!GetCurrentGroup()函數(shù)意義：讀取當(dāng)前登錄用戶的所在用戶組名。返 回 值：字符型，當(dāng)前登錄用戶組名，如沒有登錄返回空。參 數(shù)：無(wú)。實(shí) 例：!GetCurrentGroup()。!GetCurrentUser()函數(shù)意義：讀取當(dāng)前登錄用戶的用戶名。返 回 值：字符型，當(dāng)前登錄用戶的用戶名，如沒有登錄返回空。參 數(shù)：無(wú)。實(shí) 例：!GetCurrentUser()。!LogOff()函數(shù)意義：注銷當(dāng)前用戶。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!LogOff()。!LogOn()函

49、數(shù)意義：彈出登錄對(duì)話框。返 回 值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。參 數(shù)：無(wú)。實(shí) 例：!LogOn()。字符串操作函數(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ù)值；st

50、r，字符型，格式化數(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)前沒有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)換為

51、數(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)制字符串。返 回 值：字符型

52、。參 數(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。!Lcase(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str的所有字符轉(zhuǎn)換成小寫。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!LCase("sedERT")= "sedert&qu

53、ot;。!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("

54、dsfk ") = "dsfk "!lVal(str)函數(shù)意義：將字符串轉(zhuǎn)化為長(zhǎng)數(shù)值型數(shù)值返 回 值：開關(guān)型，轉(zhuǎn)換出的數(shù)值。參 數(shù)：str，字符型。待轉(zhuǎn)換的字符串。實(shí) 例：!lVal("12345678")=12345678。!Mid(str,n,k)函數(shù)意義：從字符型數(shù)據(jù)對(duì)象str左邊第n個(gè)字符起，取k個(gè)字符。數(shù)字字符時(shí)，從零開始算起。返 回 值：字符型。參 數(shù)：str， 字符型，源字符串；n， 數(shù)值型，起始位置；k， 數(shù)值型，取字符數(shù)。實(shí) 例：!Mid("ABCDEFG"，3，2) = "DE"。!O

55、ct2I(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í) 例：!Rtrim(" dsfk ") =&quo

56、t; 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ù)意義：格式化字符串，可以格式化

57、任意多個(gè)數(shù)值。使用方法為!StrFormat("%d",23)，或!StrFormat("%g-%g-%g",2.3,2.1,2.2)等，類似C語(yǔ)言中的 Printf的語(yǔ)法。返 回 值：字符型。參 數(shù)：FormatStr， 字符型，格式化字符串。后面的參數(shù)可以任意多個(gè)。實(shí) 例：!StrFormat("%g-%g",12,12.34)= "12-12.34"。!Trim(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str中左右兩端的空格剔除。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!Trim(" dsf

58、k ") ="dsfk"。!Ucase(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str的所有字符轉(zhuǎn)換成大寫。返 回 值：字符型。參 數(shù)：str， 字符型。實(shí) 例：!UCase("sedERT") ="SEDERT"。!Val(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象str的值轉(zhuǎn)換成數(shù)值。返 回 值：數(shù)值型。參 數(shù)：str， 字符型。實(shí) 例：!Val("0.712") = 0.712。定時(shí)器操作函數(shù)可用的系統(tǒng)定時(shí)器范圍為1到127，即系統(tǒng)內(nèi)嵌127個(gè)系統(tǒng)定時(shí)器。用戶可以隨意使用其中的任意一個(gè)。定時(shí)器返回時(shí)間值為數(shù)值型，

59、單位為秒,分，時(shí)，但是小數(shù)位最多可以表示到毫秒。因?yàn)椴捎酶↑c(diǎn)數(shù)表示，隨著數(shù)值增大會(huì)略有誤差。!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í)

60、器工作。返 回 值：數(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)用失敗。 參

61、數(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),1)函數(shù)意義：以字符串的形式返回當(dāng)前定時(shí)器的值。返回 值：字符型變量， 將定時(shí)器的值以字符型的方式輸出（時(shí)間格式）。參 數(shù)：定時(shí)器號(hào)。實(shí) 例：Time=!TimerStr(1,1)，取定時(shí)器的值以“00：00：00”形式輸出給Time。!TimerState(定時(shí)器號(hào))函數(shù)意義：取定時(shí)器