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

1、.：.；MCGS內部函數運轉環(huán)境操作函數!ChangeLoopStgy(StgyName,n)函數意義：改動循環(huán)戰(zhàn)略的循環(huán)時間。返 回 值：數值型。前往值=0：調用正常，0：調用不正常。參 數：StgyName，戰(zhàn)略名；n，數值型，以毫秒數表示循環(huán)戰(zhàn)略的循環(huán)時間。實 例：!ChangeLoopStgy(報警戰(zhàn)略,5000)，將報警戰(zhàn)略的循環(huán)時間改為5秒。!CloseAllWindow(WndName)函數意義：封鎖一切窗口，假設在字符串WndName中指定了一個窗口，那么翻開這個窗口，封鎖其他窗口。假設WndName為空串，那么封鎖一切窗口。返 回 值：數值型。前往值：=0：調用正常。0：調用

2、不正常。參 數：WndName， 用戶窗口名，字符型。實 例：!CloseAllWindow(工況圖)，封鎖除了用戶窗口“工況圖以外的其他窗口，假設“工況圖窗口沒有翻開，那么在封鎖其他窗口的同時翻開該窗口；!CloseAllWindow( )，封鎖一切窗口。!CloseAllSubWnd()函數意義：封鎖窗口中的一切子窗口。返 回 值：浮點型，=0為操作。實 例：!CloseAllSubWnd() ，封鎖當前窗口的一切子窗口。!CloseSubWndWndName函數意義：封鎖子窗口。返 回 值：浮點型，=1為操作勝利，1為操作失敗。參 數 值：WndName：子窗口的名字。實 例：!Clos

3、eSubWnd(窗口1)，封鎖子窗口“窗口1。!EnableStgy(StgyName,n)函數意義：翻開或封鎖某個戰(zhàn)略，如報警戰(zhàn)略或循環(huán)戰(zhàn)略等。返 回 值：數值型。前往值=0：調用正常，0：調用不正常。參 數：SstgyName，戰(zhàn)略名；n，數值型，為1時表示翻開此戰(zhàn)略，為0時表示封鎖此戰(zhàn)略。實 例：!EnableStgy(報警戰(zhàn)略,1)， 翻開報警戰(zhàn)略；!EnableStgy(報警戰(zhàn)略,0)， 封鎖報警戰(zhàn)略，使報警戰(zhàn)略無效。!GetDeviceName(Index)函數意義：按設備順序取到設備的名字。返 回 值：字符型。調用勝利前往設備名，調用失敗時前往空字符串。參 數：Index，數值型

4、。實 例：!GetDeviceName(0) ，取0號設備構件的稱號。!GetDeviceState(DevName)函數意義：按設備名查詢設備的形狀。返 回 值：數值型。=-1調用不正常。=1 設備處于正常的任務形狀。=2 設備正在任務，但設備不正常。=3 設備處于停頓任務形狀，且設備正常。=4 設備處于停頓形狀，且設備有錯。參 數：DevName，設備名，字符型。實 例：!GetDeviceState(OmronPLC)，讀取設備構件“OmronPLC的當前任務形狀。注 意：設備稱號是在設備構件根本屬性頁中設置的。!GetLastMouseActionTime()函數意義：獲取最后一次鼠標

5、的動作發(fā)生的時間。返 回 值：開關型。前往為time_t類型的時間值，可以在時間操作腳本函數中運用。參 數：無。實 例：在畫面，系統(tǒng)對話框上的鼠標事件中添加!GetLastMouseActionTime()，獲取鼠標最后動作時間。!GetStgyName(Index)函數意義：按運轉戰(zhàn)略的順序獲得各戰(zhàn)略塊的名字。返 回 值：字符型。參 數：Index，數值型。實 例：!GetStgyName(0)，取0號運轉戰(zhàn)略的稱號。!GetWindowName(Index)函數意義：按用戶窗口的順序獲得用戶窗口的名字。返 回 值：字符型。參 數：Index， 數值型。實 例：!GetWindowName(

6、0) ，讀取0號用戶窗口的稱號。!GetWindowState(WndName)函數意義：按照名字獲得用戶窗口的形狀。返 回 值：數值型。前往0：用戶窗口處于封鎖形狀。前往1：用戶窗口處于翻開形狀。前往2：用戶窗口處于隱藏形狀。參 數：WndName，用戶窗口稱號，字符型。實 例：!GetWindowState(工況圖)，獲得用戶窗口“工況圖的形狀。!OpenSubWnd參數1,參數2，參數3，參數4，參數5，參數6函數意義：顯示子窗口。返 回 值：字符型，如勝利就前往子窗口n，n表示翻開的第n個子窗口。參 數 值：參數1：要翻開的子窗口名。參數2：整型，翻開子窗口相對于本窗口的X坐標。參數3

7、：整型，翻開子窗口相對于本窗口的Y坐標。參數4：整型，翻開子窗口的寬度。參數5：整型，翻開子窗口的高度。參數6：整型，翻開子窗口的類型。0位：能否方式翻開，運用此功能，必需在此窗口中運用CloseSubWnd來封鎖本子窗口，子窗口外別的構件對鼠標操作不呼應1位：能否菜單方式，運用此功能，一旦在子窗口之外按下按鈕，那么子窗口封鎖。2位：能否顯示程度滾動條，運用此功能，可以顯示程度滾動條3位：能否垂直顯示滾動條，運用此功能，可以顯示垂直滾動條4位：能否顯示邊框，選擇此功能，在子窗口周圍顯示細黑線邊框5位：能否自動跟蹤顯示子窗口，選擇此功能，在當前鼠標位置上顯示子窗口。此功能用于鼠標翻開的子窗口，選

8、用此功能那么忽略iLeft,iTop的值，假設此時鼠標位于窗口之外，那么在窗口對中顯示子窗口6位：能否自動調整子窗口的寬度和高度為缺省值，運用此功能那么忽略iWidth和iHeight的值。子窗口的封鎖方法：運用封鎖窗口直接封鎖，那么把整個系統(tǒng)中運用到的此子窗口完全封鎖運用指定窗口的CloseSubWnd封鎖，可以運用OpenSubWnd前往的控件名，也可以直接指定子窗口封鎖，此時只能封鎖此窗口下的子窗口。!SetActiveX()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!CallBackSvr()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!SetDevice(D

9、evName,DevOp,CmdStr)函數意義：按照設備名字對設備進展操作。返 回 值：數值型。前往值：=0：調用正常。0：調用不正常。參 數：DevName，設備名，字符型；DevOp，設備操作碼，數值型；CmdStr，設備命令字符串，只需當DevOp=6時CmdStr才有意義。DevOp取值范圍及相應含義：1：啟動設備開場任務。2：停頓設備的任務使其處于停頓形狀。3：測試設備的任務形狀。4：啟動設備任務一次。5：改動設備的任務周期，CmdStr中包含新的任務周期，單位為ms。6：執(zhí)行指定的設備命令，CmdStr中包含指定命令的格式。實 例：!SetDevice(OmronPLC,1, )

10、，啟動設備構件“OmronPLC開場任務。!SetMousePace(開關型)函數意義：設置鼠標靈敏度。參 數：開關型參數為每次按鍵音訊需求設置的鼠標挪動間隔，普通情況下請輸入正整數，假設輸入0值表示制止該功能實 例：!SetMousePace(1); 默許情況下該功能為封鎖形狀，鼠標靈敏度為0，假設想啟用該功能在啟動戰(zhàn)略中調用!SetMousePace腳本函數指定步長值。 !SetNumPanelSize(Type,Size)函數意義：根據需求和顯示屏的大小調整軟鍵盤的大小。返 回 值：開關型。前往值=0：修正勝利。新設置將在下一次翻開輸入鍵盤時生效。前往值=1：修正失敗，參數錯誤。能夠是沒

11、有匹配的type ，或者size參數超出范圍。參 數：Type，鍵盤類型，數值型；1：代表修正數值輸入鍵盤。2：代表修正字符輸入鍵盤；。3：代表修正用戶登錄對話框。Size，鍵盤大小，數值型；數值范圍：200像素1024像素；實 例：!SetNumPanelSize(1,500)，將數值輸入鍵盤改為500*500大小，該正方形相對于屏幕居中。一切修正將在下一次翻開輸入框時生效，運轉環(huán)境退出后，將自動保管上次輸入框的大小。本卷須知：鍵盤放大減少功能在重新下載工程時沒有刪除配置文件，換工程后設置依然有效，除非重新進展了設置。假設要去掉原來的設置那么需求手工刪除panelSize.ini文件，該文件

12、位于harddiskmcgsbin目錄下。 !SetStgy(StgyName)函數意義：執(zhí)行StgyName指定的運轉戰(zhàn)略。返 回 值：數值型。前往值=0：調用正常，0：調用不正常。參 數：StgyName，戰(zhàn)略名，字符型。實 例：!SetStgy(閥門封鎖)，執(zhí)行一次運轉戰(zhàn)略“閥門封鎖。!SetWindow(WndName,Op)函數意義：按照名字操作用戶窗口，如翻開、封鎖、打印。返 回 值：數值型。前往值：=0：調用正常。0：調用不正常。參 數：WndName， 用戶窗口名， 字符型。Op: 操作用戶窗口的方法，數值型。Op=1：翻開窗口并使其可見。Op=2：翻開窗口并使其不可見。Op=

13、3：封鎖窗口。Op=4：打印窗口。Op=5：刷新窗口。實 例：!SetWindow(工況圖,1)，翻開用戶窗口“工況圖，并使其可見。!SysWindow()函數意義：執(zhí)行該函數后，翻開用戶窗口管理窗口，在管理窗口中可以選擇翻開或封鎖指定的用戶窗口。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：無。實 例：!SysWindow()。!SetStyMode(StgyName)函數意義：經過腳本函數位于系統(tǒng)函數-運轉環(huán)境類實現函數調用方式的戰(zhàn)略調用。前往 值：開關型，前往值恒為0。參 數：StgyName，戰(zhàn)略名，字符型。實 例：!SetStgyMode(閥門封鎖)，執(zhí)行一次運轉戰(zhàn)

14、略“閥門封鎖，“閥門封鎖戰(zhàn)略執(zhí)行終了后，才前往調用者，調用者繼續(xù)執(zhí)行以下程序。!GetCurrentLanguageIndex( ) 函數意義：用于獲取當前運用的言語的索引值。 返 回 值：開關型。前往值為言語項索引值。 索引值按照組態(tài)下拉框依次排序0，1，2 參 數： 無。 實 例：N=!GetCurrentLanguageIndex( ) ，其中N為開關型變量 。 !SetCurrentLanguageIndex ( 開關型 ) 函數意義：經過索引項設定當前言語環(huán)境 返 回 值：開關型。前往值為0表示執(zhí)行勝利，否那么表示失敗。 參 數：開關型。言語索引值。假設索引參數值超出當前選擇言語范圍

15、，那么函數不生效。 實 例：!SetCurrentLanguageIndex(1)，表示設置當前言語為英文選擇言語為CH，EN。 !GetLocalLanguageStr( 開關型 ) 函數意義：獲得指定自定義ID對應的當前言語的內容。 返 回 值：字符型。 參 數：開關型。自定義ID索引值。假設無當前ID對應自定義文本，那么前往空值。 實 例：!GetLocalLanguageStr2，前提是有ID為2的自定義文本內容，假設當前言語為英文，那么前往ID為2的自定義文本記錄的英文內容。 !GetLanguageNameByIndex(開關型) 函數意義：根據言語索引值前往言語稱號，前往值為字符

16、型。 返 回 值：字符型，當前言語的稱號。 參 數：開關型。言語的索引值。假設當前索引值無對應言語，那么前往空值。 實 例：!GetLanguageNameByIndex(1) ，假設當前言語為中文、英文，那么前往值為English。數據對象操作函數 !AnswerAlm(DatName)函數意義：應對數據對象DatName所產生的報警。如對應的數據對象沒有報警產生或曾經應對，那么本函數無效。返 回 值：數值型，=0為操作勝利，0為操作失敗。參 數：DatName，數據對象名。實 例：!AnswerAlm(電機溫度)，應對數據對象“電機溫度所產生的報警。!ChangeDataSave(Datn

17、ame,n)函數意義：改動數據對象Datname存盤的周期。返 回 值：數值型，=0為操作勝利，0為操作失敗。參 數：Datname，數據對象名；n，數值型，以秒表示的存盤間隔時間。實 例：!ChangeDataSave(溫度,5)， 溫度的存盤間隔時間為5秒。!ChangeSaveData(DatName,Num1,Num2)該函數在通用版中可以運用，在嵌入版中不能運用！函數意義：改動數據對象DatName所對應存盤數據的存盤間隔，把Num1小時以前的存盤數據以當前時間為0點的存盤間隔改為Num2秒。本操作只對組對象有效，對單個的數據對象無效。當DataName =空字符，或Num1=0或N

18、um2=0時，本操作無效。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：DatName：數據對象名。Num1：數值型時間量，單位：小時。本函數用Num10的一些數值來表示一些特殊意義的操作：=-1 改動當天對應數據對象一切存盤數據的存盤間隔；=-2 改動昨天對應數據對象一切存盤數據的存盤間隔；=-3 改動本星期對應數據對象一切存盤數據的存盤間隔；=-4 改動上星期對應數據對象一切存盤數據的存盤間隔；=-5 改動本月對應數據對象一切存盤數據的存盤間隔；=-6 改動上個月對應數據對象一切存盤數據的存盤間隔；Num2：數值型時間量，新的存盤間隔，單位：秒。實 例：!ChangeS

19、aveData(電機1,-2,5)，把組對象“電機1對應的存盤數據中昨天的存盤數據的存盤間隔改為5秒鐘。!FlushDataInitValueToDisk()函數意義：把一切數據對象的初始值寫入磁盤。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：無。!CopySaveDat()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!DelSaveDat(DatName,Num)函數意義：刪除組對象DatName對應的存盤數據中最早Num小時內的存盤數據，假設 Num 0, 就刪除以當前時間為基點Num個小時之前的內容,刪除時是按文件刪除的，假設數據缺乏一個存盤文件，是不會

20、被刪除的。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：DatName，組對象名。 Num , 參數名。實 例：!DelSaveDat(電機溫度，12) ，刪除組對象“電機溫度對應的存盤數據中以當前時間為基點倒推12個小時之前的數據。但從當前時間至倒推的12個小時之內的內容會被保管。注 意：該函數只對組對象操作有效。!DelAllSaveDat()函數意義：刪除組對象DataName對應的一切存盤數據。留意，此函數不能用來刪除組對象所對應的報警存盤數據。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：DatName：組對象名；實 例：!DelAllSave

21、Dat電機溫度，刪除組對象“電機溫度對應的一切存盤數據注 意：該函數只對組對象操作有效。!EnableDataSave(name,n)函數意義：翻開/封鎖數據對象的定時存盤功能。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：name，數據對象名；n，數值型，1表示翻開定時存盤，0表示封鎖定時存盤。實 例：!EnableDataSave(溫度,1)， 翻開溫度的定時存盤。!ExportHisDataToCSV(文件名,組對象名,字段名,開場時間,終了時間,最大記錄數,導出方式,導出參數,進度指示數據對象名,取消控制數據對象名)函數意義：1.導出指定組對象存盤數據，導出的條件包

22、括：開場時間-終了時間，最大導出總條數;2.導出字段列表，組對象為MCGS_ALARM那么表示導出報警歷史數據；3.可指定導出文件名和途徑，主要是U盤導出，可以追加方式也可覆蓋方式導出；4.可顯示導出過程進度情況；5.可取消和中止長時間的導出過程；6.導出格式為csv文件，導出的第一行為字段名字。返 回 值：開關型。前往1 指定組對象錯誤，能夠組對象沒有保管歷史數據或者沒有該組對象前往2 指定的時間格式錯誤前往3 指定的無效的數據對象名前往4 無效的導出方式前往5 同時只能支持一個csv導出參 數：文件名：字符型，指定導出的文件絕對途徑名，指定的第一級目錄不能創(chuàng)建，其子目錄假設不存在那么可以創(chuàng)

23、建。這樣防止U盤不存在時創(chuàng)建U盤目錄。留意：第一級目錄不能自動創(chuàng)建用戶必需保證其存在；組對象名：導出的組對象名字。字段名：字符型，用逗號分隔的要導出的字段名，不需求指定時間字段，默許第一二個字段就為記錄時間字段。假設為空字符串那么導出一切字段。開場時間，終了時間：用表示的時間字符串 “YYYY-MM-DD HH：MM：SS；最大記錄數：希望導出的最大記錄數，超越該記錄數就前往，停頓導出；導出方式：“1表示覆蓋現有文件，“2表示追加到文件最后；導出參數：暫時為空，保管以后運用；進度指示數據對象名：開關型數據對象，導出過程中該對象值反映出當前已導出記錄條數，假設導出過程中其他異常終了那么經過該對象

24、前往同函數前往錯誤碼； 進度指示錯誤碼：前往-1文件不能翻開前往-2沒有可導出的數據前往-4文件操作出現錯誤控制數據對象名：指定一個開關型數據對象,該對象控制導出執(zhí)行，啟動導出時會自動設置該變量為0，用戶在導出過程中想取消導出那么可以設置該值為0的任何值，導出函數運轉終了后會自動設置對象值為1； 進度指示錯誤碼：前往0導出勝利前往-1導出途徑不存在前往1指定組對象錯誤，能夠組對象沒有保管歷史數據或者沒有該組對象前往2指定的時間格式錯誤前往3指定的無效的數據對象名前往4無效的導出方式前往5同時只能支持一個csv導出實 例: ret= !ExportHisDataToCSV(usb harddis

25、kyang.csv,group,data1,data4,2007/1/1 0:0:0,2021/1/1 0:0:0,20000,1,進度,控制)!GetAlmValue(DatName,Value,Flag)函數意義：讀取數據對象DatName報警限值，只需在數據對象DatName的“允許進展報警處置屬性選項被選中后，本函數的操作才有意義。對組對象、字符型數據對象、事件型數據對象本函數無效。對數值型數據對象，用Flag來標識讀取何種報警限值。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：DatName：數據對象名。Value：DataName的當前的報警限值，數值型。Fla

26、g：數值型，標志要讀取何種限值，詳細意義如下：=1下下限報警值；=2 下限報警值；=3 上限報警值；=4 上上限報警值；=5 下偏向報警限值；=6 上偏向報警限值；=7 偏向報警基準值；實 例:!GetAlmValue(電機溫度,Value,3)，讀取數據對象“電機溫度的報警上限值，放入數值型數據對象Value中。!GetEventDT()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!GetEventP()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!GetEventT()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!MoveSaveDat()函數闡明：此函

27、數在嵌入版中無效，思索兼容性問題，故保管。!SaveData(DatName)函數意義：把數據對象DataName對應的當前值存入存盤數據庫中。本函數的操作使對應的數據對象的值存盤一次。此數據對象必需具有存盤屬性，且存盤時間需設為0秒。否那么會操作失敗。返 回 值：數值型，=0為操作勝利，0為操作失敗。參 數：DatName，數據對象名。實 例：!SaveData(電機1)，把組對象“電機1的一切成員對應的當前值存盤一次。!SaveDataInit()函數意義：本操作把設置有“退出時自動保管數據對象的當前值作為初始值屬性的數據對象的當前值存入組態(tài)結果數據中作為初始值，防止忽然斷電而無法保管，以

28、便MCGS嵌入版下次啟動時這些數據對象能自動恢復其值。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：無。實 例：!SaveDataInit()。注 意：此函數單獨運用不起作用，需求和函數!Flushdatainitvaluetodisk()一同運用。!SaveDataOnTime(Time,TimeMS,DataName)函數意義：運用指定時間保管數據。本函數通常用于指定時間來保管數據，實現與通常機制不一樣的存盤方法。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：Time，數值型，運用時間函數轉換出的時間量。時間精度到秒。TimeMS，數值型，指定存盤時

29、間的毫秒數。實 例：t =!TimeStr2I(2001年2月21日3時2分3秒)；!SaveDataOnTime (t,0,DataGroup)， 按照指定時間保管數據對象。!SaveSingleDataInit(Name)函數意義：本操作把數據對象的當前值設置為初始值不論該對象能否設置有“退出時自動保管數據對象的當前值作為初始值屬性，防止忽然斷電而無法保管，以便MCGS嵌入版下次啟動時這些數據對象能自動恢復其值。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：Name，數據對象名。實 例：!SaveSingleDataInit(溫度)，把溫度的當前值設置成初始值。!Set

30、AlmValue(DatName,Value,Flag)函數意義：設置數據對象DatName對應的報警限值，只需在數據對象DatName“允許進展報警處置的屬性被選中后，本函數的操作才有意義。對組對象、字符型數據對象、事件型數據對象本函數無效。對數值型數據對象，用Flag來標識改動何種報警限值。返 回 值：數值型，前往值=0：調用正常，0：調用不正常。參 數：DatName：數據對象名。Value：新的報警值，數值型。Flag：數值型，標志要操作何種限值，詳細意義如下：=1下下限報警值；=2下限報警值；=3上限報警值；=4上上限報警值；=5下偏向報警限值；=6上偏向報警限值；=7偏向報警基準值

31、；實 例：!SetAlmValue(電機溫度,200,3)，把數據對象“電機溫度的報警上限值設為200!TransToUSB(組對象名,起始時間,終了時間,導出形狀,進度指示,轉出方式,保管參數)函數意義：將XXX組對象的存盤數據導出到USB HARDDISK目錄下，保管為“XXX.csv文件，模擬環(huán)境那么是保管到與可執(zhí)行文件一樣途徑下。返 回 值：開關型。0：參數沒有錯誤。 1：第一個參數錯誤。請檢查能否組對象稱號，或“MCGS_ALARM 2: 時間參數格式錯誤。 3：形狀變量的類型錯誤。兩個變量都必需是開關量 5：同時只能支持一個csv導出。參 數： 組對象名：字符型，要導出的組對象稱號

32、或“MCGS_ALARM。起始時間：字符型，要導出的歷史數據的開場時間，格式：YYYY-MM-DD HH:MM:SS。終了時間：字符型，要導出的歷史數據的終了時間，格式：YYYY-MM-DD HH:MM:SS。導出形狀：開關型，進度指示數據對象名開關量，輸出導出形狀。 正常導出存盤后輸出當前曾經導出的記錄條數。 當創(chuàng)建導出文件“XXX.csv失敗時輸出1。請檢查下位機能否正常插入了U盤 當前沒有記錄可導出時輸出2。請檢查對應的組對象能否有存盤信息，或者開場時間終了時間能否設置正確 導出過程中出現未知數據類型時輸出3。不應該出現 導出過程中出現文件操作異常時輸出4。請檢查U盤容量能否足夠進度指示

33、：開關量，指定一個數字型或開關型對象,該對象控制導出執(zhí)行，啟動導出時會自動設置該變量為0，用戶在導出過程中想取消導出可設置該變量為0的任何值，導出函數運轉終了后會自動設置對象值為1。 注：6.501.0010之前的版本，此參數為原導出形狀變量2，顯示的是導出數據總條數。轉出方式：開關型，保管，設置為0。保管參數：字符型，保管, 設置為空字符串。實 例：!TransToUSB(MCGS_ALARM , 2021-12-1 00:00:00 , 2021-12-31 00:00:00 , Switch01 , Switch02 , 0 , )。本卷須知：該函數最多只能導出30000條記錄。當滿足導

34、出時間條件的記錄數大于30000時，只導出前30000條記錄。!CopyDateFileToDisk(pathName,dataType,copyState)函數意義: 拷貝當前運轉工程的數據到指定的目錄pathName中。返 回 值:1：在拷貝的過程中,數據對象copyState,由0轉變?yōu)榉?.表示用戶不想繼續(xù)拷貝。0：表示拷貝勝利。-1：當前工程中,當前運轉工程中沒有組對象要存盤。-2：創(chuàng)建目錄pathName失敗。 -3：創(chuàng)佳索引文件MCGS_DATA.ini失敗或者對此文件進展寫操作失敗。-4：參數dataType的值,不正確,目前只支持值為0。-5：磁盤空間缺乏。-6：參數copy

35、State不是數據對象類型。-7：參數copyState是數據對象類型,但不是開關型數據對象。-8：參數copyState在一開場調用此腳本時,就為非0。參數闡明:pathName：字符串型.要拷貝數據到此的途徑名.例如:在模擬環(huán)境可以寫d:test,在運轉環(huán)境可寫harddisktest。dataType：開關型.拷貝數據的類型,0表示歷史數據,1表示報警數據.目前只支持拷貝歷史數據,報警數據還沒有處置。copyState：數據對象型.能否拷貝的標志.當為0表示可以拷貝,為非0表示取消當前的拷貝。實 例：!CopyDateFileToDisk(harddisktest,0,copyState

36、) 把當前工程中歷史數據拷貝到目錄harddisktest中(如copyState為0表示拷貝,為非表示取消)。說 明：普通此腳本要配合組態(tài)環(huán)境中的一個小程序DataTrans.exe來一同操作.把拷貝的數據目錄,經過U盤或其他方式,導到上位機(PC),經過用程序DataTrans.exe來進展數據的轉換。用戶登錄操作函數!ChangePassword()函數意義：彈出密碼修正窗口，供當前登錄的用戶修正密碼。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：無。實 例：!ChangePassword()。!CheckUserGroup(strUserGroup)函數意義：檢查當前

37、登錄的用戶能否屬于strUserGroup用戶組的成員。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：strUserGroup，字符型，用戶組的稱號。實 例：!CheckUserGroup(管理員組)。!Editusers()函數意義：彈出用戶管理窗口，供管理員組的操作者配置用戶。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：無。實 例：!Editusers()。!EnableExitLogon(n)函數意義：翻開/封鎖退出時的權限檢查。返 回 值：數值型。前往值=1：操作勝利；前往值=0：操作失敗。參 數：n，數值型，為1時表示在退出時進展權限檢查，當權限

38、缺乏時，會進展提示。為0那么退出時不進展權限檢查。實 例：!EnableExitLogon(1)， 在退出時進展權限檢查。!EnableExitPrompt(n)函數意義：翻開/封鎖退出時的提示信息。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：n，數值型，為1時表示在退出時彈出提示信息對話框。為0那么退出時不出現信息對話框。實 例：!EnableExitPrompt(1)， 在退出時彈出提示信息對話框。!GetCurrentGroup()函數意義：讀取當前登錄用戶的所在用戶組名。返 回 值：字符型，當前登錄用戶組名，如沒有登錄前往空。參 數：無。實 例：!GetCurren

39、tGroup()。!GetCurrentUser()函數意義：讀取當前登錄用戶的用戶名。返 回 值：字符型，當前登錄用戶的用戶名，如沒有登錄前往空。參 數：無。實 例：!GetCurrentUser()。!LogOff()函數意義：注銷當前用戶。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：無。實 例：!LogOff()。!LogOn()函數意義：彈出登錄對話框。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：無。實 例：!LogOn()。字符串操作函數!Ascii2I(s)函數意義：前往字符串s的首字母的Ascii值。返 回 值：開關型。參 數：s， 字符型

40、。實 例：!Ascii2I(Afd)=65。!Bin2I(s)函數意義：把二進制字符串轉換為數值。返 回 值：開關型。參 數：s， 字符型。實 例：!Bin2I(101)=5。!Format(n,str)函數意義：格式化數值型數據對象。返 回 值：字符型。參 數：n，數值型，要格式化的數值；str，字符型，格式化數值的格式。表示為0.00款式。小數點后的0的個數表示需求格式化出的小數位數。小數點前的0為一個時，表示小數點前根據 實踐數值顯示。當小數點前沒有0時，表示為.xx式樣，當小數點前的0不止一個時，運用0來填充不夠的位數。實 例：!Format(1.236,0.00) = 1.24；!F

41、ormat(1.236,.00)= .24；!Format(1.236,00.00) = 01.24。!Hex2I(s)函數意義：把16進制字符串轉換為數值。返 回 值：開關型。參 數：s， 字符型。實 例：!Hex2I(11) =17。!I2Ascii(s)函數意義：前往指定Ascii值的字符。返 回 值：字符型。參 數：s， 開關型。實 例：!I2Ascii(65) =“A。!I2Bin(s)函數意義：把數值轉換為二進制字符串。返 回 值：字符型。參 數：s，開關型。實 例：!I2Bin(5) =“101!I2Hex(s)函數意義：把數值轉換為16進制字符串。返 回 值：字符型。參 數：s

42、，開關型。實 例：!I2Hex(17) =“11。!I2Oct(s)函數意義：把數值轉換為8進制字符串。返 回 值：字符型。參 數：s，開關型。實 例：!I2Oct(9) =“11。!InStr(n，str1，str2)函數意義：查找一字符串在另一字符串中最先出現的位置。返 回 值：數值型。參 數：n，數值型，開場搜索的位置；str1，字符串，被搜索的字符串；str2，字符串，要搜索的字符串。實 例：!InStr(3,sdlkfjwe,we) = 7。!Lcase(str)函數意義：把字符型數據對象str的一切字符轉換成小寫。返 回 值：字符型。參 數：str， 字符型。實 例：!LCase(

43、sedERT)= sedert。!Left(str,n)函數意義：字符型數據對象str左邊起，取n個字符。返 回 值：字符型。參 數：str：字符型，源字符串；n，數值型，取字符個數。實 例：!Left(ABCDEFG,2) =AB!Len(str)函數意義：求字符型數據對象str的字符串長度字符個數。返 回 值：數值型。參 數：str， 字符型。實 例：!Len(ABCDEFG)= 7。!Ltrim(str)函數意義：把字符型數據對象str中最左邊的空格剔除。返 回 值：字符型。參 數：str， 字符型。實 例：!LTrim( dsfk ) = dsfk !lVal(str)函數意義：將字符

44、串轉化為長數值型數值返 回 值：開關型，轉換出的數值。參 數：str，字符型。待轉換的字符串。實 例：!lVal(12345678)=12345678。!Mid(str,n,k)函數意義：從字符型數據對象str左邊第n個字符起，取k個字符。數字字符時，從零開場算起。返 回 值：字符型。參 數：str， 字符型，源字符串；n， 數值型，起始位置；k， 數值型，取字符數。實 例：!Mid(ABCDEFG，3，2) = DE。!Oct2I(s)函數意義：把8進制字符串轉換為數值。返 回 值：開關型。參 數：s， 字符型。實 例：!Oct2I(11) =9。!Right(str,n)函數意義：從字符型

45、數據對象str右邊起，取n個字符。返 回 值：字符型。參 數：str，字符型，源字符串；n，數值型，取字符個數。實 例：!Right(ABCDEFG,2) =FG。!Rtrim(str)函數意義：把字符型數據對象str中最右邊的空格剔除。返 回 值：字符型。參 數：str， 字符型。實 例：!Rtrim( dsfk ) = dsfk。!Str(x)函數意義：將數值型數據對象x的值轉換成字符串。返 回 值：字符型。參 數：x， 數值型。實 例：!Str(0.712) =0.712。!StrComp(str1,str2)函數意義：比較字符型數據對象str1和str2能否相等，前往值為0時相等，否那

46、么不相等。不區(qū)分大小寫字母。返 回 值：數值型。參 數：str1， 字符型；str2， 字符型。實 例：!StrComp(ABC,abc) = 0。!StrFormat(FormatStr,恣意個數變量)函數意義：格式化字符串，可以格式化恣意多個數值。運用方法為!StrFormat(%d,23)，或!StrFormat(%g-%g-%g,2.3,2.1,2.2)等，類似C言語中的 Printf的語法。返 回 值：字符型。參 數：FormatStr， 字符型，格式化字符串。后面的參數可以恣意多個。實 例：!StrFormat(%g-%g,12,12.34)= 12-12.34。!Trim(str

47、)函數意義：把字符型數據對象str中左右兩端的空格剔除。返 回 值：字符型。參 數：str， 字符型。實 例：!Trim( dsfk ) =dsfk。!Ucase(str)函數意義：把字符型數據對象str的一切字符轉換成大寫。返 回 值：字符型。參 數：str， 字符型。實 例：!UCase(sedERT) =SEDERT。!Val(str)函數意義：把字符型數據對象str的值轉換成數值。返 回 值：數值型。參 數：str， 字符型。實 例：!Val(0.712) = 0.712。定時器操作函數可用的系統(tǒng)定時器范圍為1到127，即系統(tǒng)內嵌127個系統(tǒng)定時器。用戶可以隨意運用其中的恣意一個。定時

48、器前往時間值為數值型，單位為秒,分，時，但是小數位最多可以表示到毫秒。由于采用浮點數表示，隨著數值增大會略有誤差。!TimerClearOutput(定時器號)函數意義: 去除定時器的數據輸出銜接。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號。實 例：!TimerClearOutput(1)，去除1號定時器的數據輸出銜接。!TimerRun(定時器號)函數意義：啟動定時器開場任務。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號。實 例：!TimerRun(1)，啟動1號定時器任務。!TimerStop(定時器號)函數意義：停頓定時器任務。返

49、 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號。實 例：!TimerStop(1)，停頓1號定時器任務。!TimerSkip(定時器號,步長值)函數意義：在計時器當前時間數上加/減指定值。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號；步長值。實 例：!TimerSkip(1,3)，1號定時器當前值+3。!TimerReset(定時器號,數值)函數意義：設置定時器的當前值，由第二個參數設定，第二個參數可以是MCGS嵌入版變量。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。 參 數：定時器號；數值。實 例：!TimerReset(1,1

50、2)，設置1號定時器的值為12。!TimerValue(定時器號,0)函數意義：取定時器的當前值。返 回 值：將定時器的值以數值型的方式輸出數值格式。參 數：定時器號。實 例：Data3=!TimerValue(1,0)，取定時器1的值給Data3。!TimerStr(定時器號,1)函數意義：以字符串的方式前往當前定時器的值。前往 值：字符型變量， 將定時器的值以字符型的方式輸出時間格式。參 數：定時器號。實 例：Time=!TimerStr(1,1)，取定時器的值以“00：00：00方式輸出給Time。!TimerState(定時器號)函數意義：取定時器的任務形狀。返 回 值：數值型變量，0

51、 - 定時器停頓，1 - 定時器運轉。參 數：定時器號。實 例：data1=!TimerState(1)，取定時器1的任務形狀給data1。 !TimerSetLimit(定時器號,上限值,參數3)函數意義：設置定時器的最大值，即設置定時器的上限。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號(1-255)；上限值；第三個參數，1 - 表示運轉到60后停頓；0 - 表示運轉到60后重新循環(huán)運轉。實 例：!TimerSetLimit(1,60,1)，設置1號定時器的上限為60，運轉到60后停頓。!TimerSetOutput(定時器號,變量)函數意義：設置定時器的值輸出

52、銜接的變量。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號；變量，定時器的值輸出銜接的變量。實 例：!TimerSetOutput(1,Data0)，將定時器數據銜接到Data0。!TimerWaitFor(定時器號,數值)函數意義：等待定時器任務到“數值指定的值后，腳本程序才向下執(zhí)行。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：定時器號(1-255)；數值， 等待定時器任務到指定的值。實 例：!TimerWaitFor(1,55)，等定時器任務到55秒后再執(zhí)行其他操作。系統(tǒng)操作函數!AppActive()函數闡明：此函數在嵌入版中無效，思索兼容性

53、問題，故保管。!Beep()函數意義：發(fā)出嗡鳴聲。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：無。實 例：!Beep()。!EnableDDEConnection()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!EnableDDEInput()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!LinePrtOutput()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!PlaySound()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!SendKeys(string)函數意義：將一個或多個按鍵音訊發(fā)送到活動窗口，就好像在鍵盤上進展輸

54、入一樣。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：string，字符串表達式，指定要發(fā)送的按鍵音訊。實 例：!SendKeys(%TAB)，切換窗口。說 明：每個按鍵由一個或多個字符表示。為了指定單一鍵盤字符，必需按字符本身的鍵。例如，為了表示字母 A，可以用 A 作為 string。為了表示多個字 符，就必需在字符后面直接加上另一個字符。例如，要表示 A、B 及 C，可用 ABC 作為 string。對 SendKeys 來說，加號 (+)、插入符 ()、百分比符號 (%)、上劃線 () 及圓括號 ( ) 都具有特殊意義。為了指定上述任何一個字符，要將它放在大括號 ()

55、 當中。例如，要指定正號，可用 + 表示。為了指定大括號字符，請運用 及 。為了在按下按鍵時指定那些不顯示的字符，例如：ENTER 或 TAB 以及那些表示動作而非字符的按鍵，請運用以下代碼：按鍵 代碼 BACKSPACEBACKSPACE, BS, 或 BKSP BREAKBREAK CAPS LOCKCAPSLOCK DEL or DELETEDELETE 或 DEL DOWN ARROWDOWN ENDEND ENTERENTER或 ESCESC HOMEHOME INS or INSERTINSERT 或 INS LEFT ARROWLEFT NUM LOCKNUMLOCK PAGE

56、DOWNPGDN PAGE UPPGUP RIGHT ARROWRIGHT SCROLL LOCKSCROLLLOCK TABTAB UP ARROWUP F1 F1 F2 F2 F3 F3 F4 F4 F5 F5 F6 F6 F7 F7 F8 F8 F9 F9 F10 F10 F11 F11 F12 F12 F13 F13 F14 F14 F15 F15 F16 F16 為了指定那些與 SHIFT、CTRL 及 ALT 等按鍵結合的組合鍵，可在這些按鍵碼的前面放置一個或多個代碼，這些代碼列舉如下：按鍵代碼SHIFT+CTRL ALT %為了闡明在按下其它按鍵時應同時按下 SHIFT、CTRL

57、、及 ALT 的恣意組合鍵，請把那些按鍵的碼放在括號當中。例如，為了闡明按下 E 與 C 的時候同時按下 SHIFT 鍵，請運用 +(EC)。為了闡明在按下 E 的時候同時按下 SHIFT 鍵，但接著按 C 而不按 SHIFT，那么運用+EC。注 意：不能用 SendKeys 將按鍵音訊發(fā)送到這樣一個運用程序，這個運用程序并沒有被設計成在 Microsoft Windows 中運轉。 Sendkeys 也無法將 PRINT SCREEN 按鍵 PRTSC 發(fā)送到任何運用程序。!SetLinePrinter(n)函數意義：翻開/封鎖行式打印輸出。返 回 值：數值型。前往值=0：調用勝利；0:調用

58、失敗。參 數：n,數值型，1，表示翻開行式打印輸出；0，那么封鎖行式打印輸出。實 例：!SetLinePrinter(1)，翻開行式打印輸出。!SetTime(n1,n2,n3,n4,n5,n6)函數意義：設置當前系統(tǒng)時間返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：n1，數值型，設定年數，小于1000和大于9999時不變；n2，數值型，設定月數，大于12和小于1時不變；n3，數值型，設定天數，大于31和小于1時不變；n4，數值型，設定小時數，大于23和小于0時不變；n5，數值型，設定分鐘數，大于59和小于0時不變；n6，數值型，設定秒數，大于59和小于0時不變。實 例：!S

59、etTime(2000,1,1,1,1,1)， 設置當前系統(tǒng)時間為2000年1月1日1時1分1秒。!Shell()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!Sleep(mTime)函數意義：在腳本程序中等待mTime毫秒，然后再執(zhí)行下條語句。只能在戰(zhàn)略中運用，否那么會呵斥系統(tǒng)呼應緩慢。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：mTime，數值型，要等待的毫秒數。實 例：!Sleep(10)。!TerminateApplication()函數闡明：此函數在嵌入版中無效，思索兼容性問題，故保管。!WaitFor (Dat1,Dat2)函數意義：在腳本程序中等待

60、設置的條件滿足，腳本程序再向下執(zhí)行。只能在戰(zhàn)略中運用，否那么呵斥系統(tǒng)呼應緩慢。返 回 值：數值型。前往值=0：調用勝利；0：調用失敗。參 數：Dat1，數值型，條件表達式，如：D=15。Dat2，數值型，等待條件滿足的超時時間，單位：ms。為0那么無限等待。實 例：!WaitForD=15,12000，等變量D的值等于15后，程序再繼續(xù)執(zhí)行，假設在12秒后條件依然沒有滿足，也自動繼續(xù)執(zhí)行。此函數通常用于做實驗時，等待某個條件滿足，然后再接著執(zhí)行實驗流程。他與Sleep函數以及While循環(huán)語句、其他循環(huán)戰(zhàn)略配合，可以實現復雜的流程調度。注 意：!WaitFor只能用于戰(zhàn)略中，而不能直接在窗口控