MCGS昆侖通態(tài)腳本函數(shù)

運(yùn)行環(huán)境操作函數(shù)!ChangeLoopStgy(StgyName,n)函數(shù)意義：改變循環(huán)策略的循環(huán)時(shí)間。返回值：數(shù)值型。返回值=0<>0：調(diào)用不正常。StgyName，策略名；n，數(shù)值型，以毫秒數(shù)表示循環(huán)策略的循環(huán)時(shí)間。!ChangeLoopStgy(,5000)，將報(bào)警策略的循環(huán)時(shí)間改為5秒。!CloseAllWindow(WndName)函數(shù)意義：關(guān)閉所有窗口，如果在字符串 ”WndNae中指定了一個(gè)窗口，則打開(kāi)這個(gè)窗口關(guān)閉其他窗口。如果”WndNae為空串，則關(guān)閉所有窗口。返回值：數(shù)值型。返回值：=0<>0：調(diào)用不正常。WndName，用戶窗口名，字符型。實(shí)例：!CloseAllWindow(" 工況圖")，關(guān)閉除了用戶窗口“工況圖”以外的其他窗口，若“工況圖”窗口沒(méi)有打開(kāi)，則在關(guān)閉其他窗口的同時(shí)打開(kāi)該窗口；!CloseAllWindow(" ")，關(guān)閉所有窗口。!CloseAllSubWnd()返回值：浮點(diǎn)型，=0為操作。實(shí)例：!CloseAllSubWnd() ，關(guān)閉當(dāng)前窗口的所有子窗口。!CloseSubWnd（WndName）函數(shù)意義：關(guān)閉子窗口。返回值：浮點(diǎn)型，為操作失敗。參數(shù)值：WndName：子窗口的名字。!CloseSubWnd(1)，關(guān)閉子窗口“窗口1”。!EnableStgy(StgyName,n)函數(shù)意義：打開(kāi)或關(guān)閉某個(gè)策略，如報(bào)警策略或循環(huán)策略等。返回值：數(shù)值型。返回值=0<>0：調(diào)用不正常。參數(shù)：SstgyNam，策略名；時(shí)表示打開(kāi)此策略，為!EnableStgy(報(bào)警策略,1)，打開(kāi)報(bào)警策略；!EnableStgy(,0)，關(guān)閉報(bào)警策略，使報(bào)警策略無(wú)效。!GetDeviceName(Index)函數(shù)意義：按設(shè)備順序取到設(shè)備的名字。返回值：字符型。調(diào)用成功返回設(shè)備名，調(diào)用失敗時(shí)返回空字符串。Index，數(shù)值型。實(shí)例：!GetDeviceName(0) ，取0號(hào)設(shè)備構(gòu)件的名稱(chēng)。!GetDeviceState(DevName)返回值：數(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ò)。DevName，設(shè)備名，字符型。!GetDeviceState(OmronPLC)OmronPC注意：設(shè)備名稱(chēng)是在設(shè)備構(gòu)件基本屬性頁(yè)中設(shè)置的。!GetLastMouseActionTime()函數(shù)意義：獲取最后一次鼠標(biāo)的動(dòng)作發(fā)生的時(shí)間。返回值：開(kāi)關(guān)型。返回為 time_t類(lèi)型的時(shí)間值，可以在時(shí)間操作腳本函數(shù)中使用。參數(shù)：無(wú)。實(shí)例：在畫(huà)面，系統(tǒng)對(duì)話框上的鼠標(biāo)事件中添加 !GetLastMouseActionTime() ，獲取鼠標(biāo)最后動(dòng)作時(shí)間。!GetStgyName(Index)函數(shù)意義：按運(yùn)行策略的順序獲得各策略塊的名字。返回值：字符型。參Index，數(shù)值型。!GetStgyName(0)，取0號(hào)運(yùn)行策略的名稱(chēng)。!GetWindowName(Index)返回值：字符型。Index，數(shù)值型。0號(hào)用戶窗口的名稱(chēng)。!GetWindowState(WndName)返回值：數(shù)值型。返回0：用戶窗口處于關(guān)閉狀態(tài)。返回1：用戶窗口處于打開(kāi)狀態(tài)。返回2：用戶窗口處于隱藏狀態(tài)。參數(shù)：WndName，用戶窗口名稱(chēng)，字符型。實(shí)例：!GetWindowState(工況圖)，獲得用戶窗口“工況圖”的狀態(tài)。!OpenSubWnd（1,23456）函數(shù)意義：顯示子窗口。返回值：字符型，如成功就返回子窗口表示打開(kāi)的第n個(gè)子窗口。1：要打開(kāi)的子窗口名。：整型，打開(kāi)子窗口相對(duì)于本窗口的X坐標(biāo)。：整型，打開(kāi)子窗口相對(duì)于本窗口的Y坐標(biāo)。4：整型，打開(kāi)子窗口的寬度。0位：是否模式打開(kāi)，使用此功能，必須在此窗口中使用 CloseSubWnd來(lái)關(guān)閉本子窗口，子窗口外別的構(gòu)件對(duì)鼠標(biāo)操作不響應(yīng)口關(guān)閉。2位：是否顯示水平滾動(dòng)條，使用此功能，可以顯示水平滾動(dòng)條3位：是否垂直顯示滾動(dòng)條，使用此功能，可以顯示垂直滾動(dòng)條4位：是否顯示邊框，選擇此功能，在子窗口周?chē)@示細(xì)黑線邊框跟蹤顯示子窗口， 選擇此功能，在當(dāng)前鼠標(biāo)位置上顯示子窗口。此功能用于鼠標(biāo)打開(kāi)的子窗口，選用此功能則忽略 iLeft,iTop的值，如果此時(shí)鼠標(biāo)位于窗口之外，則在窗口對(duì)中顯示子窗口iWidthiHeight的值。子窗口的關(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ú)效，考慮兼容性問(wèn)題，故保留。!CallBackSvr()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!SetDevice(DevName,DevOp,CmdStr)函數(shù)意義：按照設(shè)備名字對(duì)設(shè)備進(jìn)行操作。返回值：數(shù)值型。返回值：=0<>0：調(diào)用不正常。DevName，設(shè)備名，字符型；，設(shè)備操作碼，數(shù)值型；CmdStr，設(shè)備命令字符串，只有當(dāng) DevOp=6時(shí)CmdStr才有意義。DevOp取值范圍及相應(yīng)含義：1：?jiǎn)?dòng)設(shè)備開(kāi)始工作。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)件“OmronPC開(kāi)始工作。!SetMousePace(開(kāi)關(guān)型)函數(shù)意義：設(shè)置鼠標(biāo)靈敏度。參數(shù)：開(kāi)關(guān)型參數(shù)為每次按鍵消息需要設(shè)置的鼠標(biāo)移動(dòng)間隔，一般情況下請(qǐng)輸入正整數(shù)， 果輸入0值表示禁止該功能!SetMousePace(1);默認(rèn)情況下該功能為關(guān)閉狀態(tài)， 啟動(dòng)策略中調(diào)用!SetMousePace腳本函數(shù)指定步長(zhǎng)值。!SetNumPanelSize(Type,Size)返回值：開(kāi)關(guān)型。返回值=0：修改成功。新設(shè)置將在下一次打開(kāi)輸入鍵盤(pán)時(shí)生效。返回值=1：修改失敗，參數(shù)錯(cuò)誤。（可能是沒(méi)有匹配的 type，或者size參數(shù)超出范圍）。參Type，鍵盤(pán)類(lèi)型，數(shù)值型；1：代表修改數(shù)值輸入鍵盤(pán)。2：代表修改字符輸入鍵盤(pán)；。3：代表修改用戶登錄對(duì)話框。Size，鍵盤(pán)大小，數(shù)值型；數(shù)值范圍： ，將數(shù)值輸入鍵盤(pán)改為500*500大小， 該正方形相對(duì)于屏幕居中。所有修改將在下一次打開(kāi)輸入框時(shí)生效， 運(yùn)行環(huán)境退出后，將自動(dòng)保留上次輸入框的大小。注意事項(xiàng)鍵盤(pán)放大縮小功能在重新下載工程時(shí)沒(méi)有刪除配置文件， 換工程后設(shè)置仍然有效，除非重新進(jìn)行了設(shè)置。如果要去掉原來(lái)的設(shè)置則需要手工刪除 panelSize.ini文件，該文件位于\harddisk\mcgsbin目錄下。!SetStgy(StgyName)函數(shù)意義：執(zhí)行StgyName指定的運(yùn)行策略。返回值：數(shù)值型。返回值=0<>0：調(diào)用不正常。StgyName，策略名，字符型。!SetStgy(閥門(mén)關(guān)閉)，執(zhí)行一次運(yùn)行策略“閥門(mén)關(guān)閉”。!SetWindow(WndName,Op)函數(shù)意義：按照名字操作用戶窗口，如打開(kāi)、關(guān)閉、打印。返回值：數(shù)值型。返回值：=0<>0：調(diào)用不正常。參數(shù)：WndName，用戶窗口名， 字符型。Op: 口的方法，數(shù)值型。Op=1：打開(kāi)窗口并使其可見(jiàn)。Op=2：打開(kāi)窗口并使其不可見(jiàn)。Op=3：關(guān)閉窗口。Op=4：打印窗口。!SetWindow(,1)，打開(kāi)用戶窗口“工況圖”，并使其可見(jiàn)。!SysWindow()函數(shù)意義：執(zhí)行該函數(shù)后，打開(kāi)用戶窗口管理窗口，在管理窗口中可以選擇打開(kāi)或關(guān)閉指定的用戶窗口。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：無(wú)。!SysWindow()。!SetStyMode(ttye)函數(shù)意義：通過(guò)腳本函數(shù)（位于系統(tǒng)函數(shù) 調(diào)用。返回值：開(kāi)關(guān)型，返回值恒為0。StgyName，策略名，字符型。!SetStgyMode(閥門(mén)關(guān)閉)，執(zhí)行一次運(yùn)行策略“閥門(mén)關(guān)閉”，“閥門(mén)關(guān)閉”策略執(zhí)行完畢后，才返回調(diào)用者，調(diào)用者繼續(xù)執(zhí)行以下程序。!GetCurrentLanguageIndex( )函數(shù)意義：用于獲取當(dāng)前使用的語(yǔ)言的索引值。返回值：開(kāi)關(guān)型。返回值為語(yǔ)言項(xiàng)索引值。 索引值按照組態(tài)下拉框依次排序 1，2?參數(shù)： 無(wú)。) ，其中N為開(kāi)關(guān)型變量 。!SetCurrentLanguageIndex( )函數(shù)意義：通過(guò)索引項(xiàng)設(shè)定當(dāng)前語(yǔ)言環(huán)境返回值：開(kāi)關(guān)型。返回值為0表示執(zhí)行成功，否則表示失敗。生效。實(shí)例：!SetCurrentLanguageIndex(1) ，表示設(shè)置當(dāng)前語(yǔ)言為英文（選擇語(yǔ)言為 。!GetLocalLanguageStr( )函數(shù)意義：獲得指定自定義ID對(duì)應(yīng)的當(dāng)前語(yǔ)言的內(nèi)容。返回值：字符型。參數(shù)：開(kāi)關(guān)型。自定義ID索引值。如果無(wú)當(dāng)前 ID對(duì)應(yīng)自定義文本，則返回空值。實(shí)例：!GetLocalLanguageStr（2），前提是有ID為2的自定義文本內(nèi)容，如果當(dāng)前語(yǔ)言為英文，則返回 ID為2的自定義文本記錄的英文內(nèi)容。!GetLanguageNameByIndex( )函數(shù)意義：根據(jù)語(yǔ)言索引值返回語(yǔ)言名稱(chēng)，返回值為字符型。返回值：字符型，當(dāng)前語(yǔ)言的名稱(chēng)。參數(shù)：開(kāi)關(guān)型。語(yǔ)言的索引值。如果當(dāng)前索引值無(wú)對(duì)應(yīng)語(yǔ)言，則返回空值。實(shí)例：!GetLanguageNameByIndex(1) ，假如當(dāng)前語(yǔ)言為中文、英文，則返回值為English。數(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ú)效。=0為操作成功，<>0為操作失敗。DatName，數(shù)據(jù)對(duì)象名。!AnswerAlm()，應(yīng)答數(shù)據(jù)對(duì)象!ChangeDataSave(Datname,n)函數(shù)意義：改變數(shù)據(jù)對(duì)象Datname=0為操作成功，<>0為操作失敗。參數(shù)：Datname，數(shù)據(jù)對(duì)象名；n，數(shù)值型，以秒表示的存盤(pán)間隔時(shí)間。實(shí)例：!ChangeDataSave(溫度,5)，溫度的存盤(pán)間隔時(shí)間為 5秒。!ChangeSaveData(DatName ,Num1,Num2)該函數(shù)在通用版中可以使用，在嵌入版中不能使用！函數(shù)意義：改變數(shù)據(jù)對(duì)象DatName所對(duì)應(yīng)存盤(pán)數(shù)據(jù)的存盤(pán)間隔，把Num1小時(shí)以前的存盤(pán)數(shù)據(jù)（以當(dāng)前時(shí)間為0點(diǎn)）的存盤(pán)間隔改為Num2秒。本操作只對(duì)組對(duì)象有效，對(duì)單個(gè)的數(shù)據(jù)對(duì)象無(wú)效。當(dāng)DataName=空字符，時(shí)，本操作無(wú)效。=0：調(diào)用正常，<>0：調(diào)用不正常。DatName：數(shù)據(jù)對(duì)象名。：數(shù)值型時(shí)間量，單位：小時(shí)。本函數(shù)用Num1<0的一些數(shù)值來(lái)表示一些特殊意義的操作：=-1改變當(dāng)天對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤(pán)數(shù)據(jù)的存盤(pán)間隔；=-2改變昨天對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤(pán)數(shù)據(jù)的存盤(pán)間隔；=-3改變本星期對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤(pán)數(shù)據(jù)的存盤(pán)間隔；=-4改變上星期對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤(pán)數(shù)據(jù)的存盤(pán)間隔；=-5改變本月對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤(pán)數(shù)據(jù)的存盤(pán)間隔；=-6改變上個(gè)月對(duì)應(yīng)數(shù)據(jù)對(duì)象所有存盤(pán)數(shù)據(jù)的存盤(pán)間隔；：數(shù)值型時(shí)間量，新的存盤(pán)間隔，單位：秒。實(shí)例：!ChangeSaveData電機(jī))，把組對(duì)象電機(jī)對(duì)應(yīng)的存盤(pán)數(shù)據(jù)中昨天的盤(pán)數(shù)據(jù)的存盤(pán)間隔改為 5秒鐘。!FlushDataInitValueToDisk()函數(shù)意義：把所有數(shù)據(jù)對(duì)象的初始值寫(xiě)入磁盤(pán)。=0：調(diào)用正常，<>0：調(diào)用不正常。參數(shù)：無(wú)。!CopySaveDat()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!DelSaveDat(DatName,Num)函數(shù)意義：刪除組對(duì)象 DatName對(duì)應(yīng)的存盤(pán)數(shù)據(jù)中最早 Num小時(shí)內(nèi)的存盤(pán)數(shù)據(jù)，如果Num<=0,那么就是刪除該組對(duì)象全部的存盤(pán)數(shù)據(jù)。 如果Num>0,就刪除以當(dāng)前時(shí)間為基點(diǎn) Num個(gè)小時(shí)之前的內(nèi)容,刪除時(shí)是按文件刪除的，如果數(shù)據(jù)不足一個(gè)存盤(pán)文件，是不會(huì)被刪除的。=0：調(diào)用正常，<>0：調(diào)用不正常。DatName，組對(duì)象名。Num,參數(shù)名。實(shí)例：!DelSaveDat(電機(jī)溫度，12)，刪除組對(duì)象電機(jī)溫度對(duì)應(yīng)的存盤(pán)數(shù)據(jù)中以當(dāng)前時(shí)間為基點(diǎn)倒推12個(gè)小時(shí)之前的數(shù)據(jù)。但從當(dāng)前時(shí)間至倒推的 12注意：該函數(shù)只對(duì)組對(duì)象操作有效。!DelAllSaveDat()函數(shù)意義：刪除組對(duì)象DataName對(duì)應(yīng)的所有存盤(pán)數(shù)據(jù)。注意，此函數(shù)不能用來(lái)刪除組對(duì)象所對(duì)應(yīng)的報(bào)警存盤(pán)數(shù)據(jù)。=0：調(diào)用正常，<>0：調(diào)用不正常。DatName：組對(duì)象名；!DelAllSaveDat（電機(jī)溫度）注意：該函數(shù)只對(duì)組對(duì)象操作有效。!EnableDataSave(name,n)函數(shù)意義：打開(kāi)/關(guān)閉數(shù)據(jù)對(duì)象的定時(shí)存盤(pán)功能。=0：調(diào)用正常，<>0：調(diào)用不正常。name，數(shù)據(jù)對(duì)象名；n，數(shù)值型，1表示打開(kāi)定時(shí)存盤(pán)，0表示關(guān)閉定時(shí)存盤(pán)。!EnableDataSave(溫度,1)，打開(kāi)溫度的定時(shí)存盤(pán)。!ExportHisDataToCSV( ,組對(duì)象名,,開(kāi)始時(shí)間,結(jié)束時(shí)間,最大記錄數(shù),導(dǎo)出模式,導(dǎo)出參數(shù),進(jìn)度指示數(shù)據(jù)對(duì)象名,取消控制數(shù)據(jù)對(duì)象名)函數(shù)意義：最大導(dǎo)出總條數(shù);蓋方式導(dǎo)出；

導(dǎo)出指定組對(duì)象存盤(pán)數(shù)據(jù)，導(dǎo)出的條件包括：開(kāi)始時(shí)間 -結(jié)束時(shí)間，導(dǎo)出字段列表，組對(duì)象為MCGS_ALARM 則表示導(dǎo)出報(bào)警歷史數(shù)據(jù)；可指定導(dǎo)出文件名和路徑，主要是 U盤(pán)導(dǎo)出，可以追加方式也可覆可顯示導(dǎo)出過(guò)程進(jìn)度情況；可取消和中止長(zhǎng)時(shí)間的導(dǎo)出過(guò)程；導(dǎo)出格式為csv文件，導(dǎo)出的第一行為字段名字。返回值：開(kāi)關(guān)型。1指定組對(duì)象錯(cuò)誤，可能組對(duì)象沒(méi)有保存歷史數(shù)據(jù)或者沒(méi)有該組對(duì)象2指定的時(shí)間格式錯(cuò)誤3指定的無(wú)效的數(shù)據(jù)對(duì)象名4無(wú)效的導(dǎo)出模式返回5同時(shí)只能支持一個(gè) csv導(dǎo)出

文件名：字符型，指定導(dǎo)出的文件絕對(duì)路徑名， 指定的第一級(jí)目錄不能創(chuàng)建，其子目錄如果不存在則可以創(chuàng)建。這樣避免 U盤(pán)不存在時(shí)創(chuàng)建U盤(pán)目錄。注意：第一級(jí)目錄不能自動(dòng)創(chuàng)建用戶必須保證其存在；組對(duì)象名：導(dǎo)出的組對(duì)象名字。

字段名：字符型，用逗號(hào)分隔的要導(dǎo)出的字段名，不需要指定時(shí)間字段，默認(rèn)第一二個(gè)字段就為記錄時(shí)間字段。 符串則導(dǎo)出所有字段。開(kāi)始時(shí)間，結(jié)束時(shí)間：用表示的時(shí)間字符串 “YYYY-MM-DD ：MM：導(dǎo)出模式：“導(dǎo)出參數(shù)：暫時(shí)為空，保留以后使用；進(jìn)度指示數(shù)據(jù)對(duì)象名：開(kāi)關(guān)型數(shù)據(jù)對(duì)象，導(dǎo)出過(guò)程中該對(duì)象值反映出當(dāng)前通過(guò)該對(duì)象返回同函數(shù)返回錯(cuò)誤碼；進(jìn)度指示錯(cuò)誤碼：返回-1 文件不能打開(kāi)返回-2 沒(méi)有可導(dǎo)出的數(shù)據(jù)返回-4 文件操作出現(xiàn)錯(cuò)誤控制數(shù)據(jù)對(duì)象名：指定一個(gè)開(kāi)關(guān)型數(shù)據(jù)對(duì)象 ,該對(duì)象控制導(dǎo)出執(zhí)行，啟動(dòng)導(dǎo)出時(shí)會(huì)自動(dòng)設(shè)置該變量為 消導(dǎo)出則可以設(shè)置該值為 <0的任何值，導(dǎo)出函數(shù)運(yùn)行結(jié)束后會(huì)自動(dòng)設(shè)置對(duì)象值為 1；進(jìn)度指示錯(cuò)誤碼：回0 導(dǎo)出成功返回-1 導(dǎo)出路徑不存在回1 指定組對(duì)象錯(cuò)誤，可能組對(duì)象沒(méi)有保存歷史數(shù)據(jù)或者沒(méi)有該組對(duì)象回2 指定的時(shí)間格式錯(cuò)誤回3 指定的無(wú)效的數(shù)據(jù)對(duì)象名回4 無(wú)效的導(dǎo)出模式同時(shí)只能支持一個(gè) csv導(dǎo)出實(shí) 例: ret= !ExportHisDataToCSV("\usbharddisk\yang.csv","group","data1,data4","2007/1/10:0:0","2009/1/10:0:0",20000,1,"",進(jìn)度,控制)!GetAlmValue(DatName,Value,Flag)函數(shù)意義：讀取數(shù)據(jù)對(duì)象DatName報(bào)警限值，只有在數(shù)據(jù)對(duì)象DatName進(jìn)行報(bào)警處理字符型數(shù)據(jù)對(duì)象、事件型數(shù)據(jù)對(duì)象本函數(shù)無(wú)效。對(duì)數(shù)值型數(shù)據(jù)對(duì)象，F(xiàn)lag來(lái)標(biāo)識(shí)讀取何種報(bào)警限值。=0：調(diào)用正常，<>0：調(diào)用不正常。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)值；:!GetAlmValue(,Value,3)入數(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)題，故保留。!SaveData(DatName)函數(shù)意義：把數(shù)據(jù)對(duì)象DataName對(duì)應(yīng)的當(dāng)前值存入存盤(pán)數(shù)據(jù)庫(kù)中。本函數(shù)的操作使對(duì)應(yīng)的數(shù)據(jù)對(duì)象的值存盤(pán)一次。此數(shù)據(jù)對(duì)象必須具有存盤(pán)屬性，且存盤(pán)時(shí)間需設(shè)為0秒。否則會(huì)操作失敗。=0為操作成功，<>0為操作失敗。DatName，數(shù)據(jù)對(duì)象名。!SaveData(!SaveDataInit()函數(shù)意義本操作把設(shè)置有退出時(shí)自動(dòng)保存數(shù)據(jù)對(duì)象的當(dāng)前值作為初始值 數(shù)據(jù)對(duì)象的當(dāng)前值存入組態(tài)結(jié)果數(shù)據(jù)中作為初始值，防止突然斷電而MCGS嵌入版下次啟動(dòng)時(shí)這些數(shù)據(jù)對(duì)象能自動(dòng)恢復(fù)其值。=0：調(diào)用正常，<>0：調(diào)用不正常。參數(shù)：無(wú)。!SaveDataInit()。注意：此函數(shù)單獨(dú)使用不起作用，需要和函數(shù) !Flushdatainitvaluetodisk()一起使用。!SaveDataOnTime(Time,TimeMS,DataName)函數(shù)意義：使用指定時(shí)間保存數(shù)據(jù)。 本函數(shù)通常用于指定時(shí)間來(lái)保存數(shù)據(jù)， 通常機(jī)制不一樣的存盤(pán)方法。返回值：數(shù)值型，返回值=0：調(diào)用正常，<>0：調(diào)用不正常。參數(shù)：Time，數(shù)值型，使用時(shí)間函數(shù)轉(zhuǎn)換出的時(shí)間量。時(shí)間精度到秒。TimeMS，數(shù)值型，指定存盤(pán)時(shí)間的毫秒數(shù)。實(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)用不正常。Name，數(shù)據(jù)對(duì)象名。!SaveSingleDataInit()，把溫度的當(dāng)前值設(shè)置成初始值。!SetAlmValue(DatName,Value,Flag)e字符型數(shù)據(jù)對(duì)象、事件型數(shù)據(jù)對(duì)象本函數(shù)無(wú)效。對(duì)數(shù)值型數(shù)據(jù)對(duì)象，F(xiàn)lag來(lái)標(biāo)識(shí)改變何種報(bào)警限值。=0：調(diào)用正常，<>0：調(diào)用不正常。DatName：數(shù)據(jù)對(duì)象名。Value：新的報(bào)警值，數(shù)值型。Flag：數(shù)值型，標(biāo)志要操作何種限值，具體意義如下：=1下下限報(bào)警值；=4上上限報(bào)警值；200!TransToUSB(組對(duì)象名,起始時(shí)間,結(jié)束時(shí)間,導(dǎo)出狀態(tài),進(jìn)度指示,,)函數(shù)意義：將XXX 組對(duì)象的存盤(pán)數(shù)據(jù)導(dǎo)出到 "USBHARDDISK" 存為“XXX.csv文件，模擬環(huán)境則是保存到與可執(zhí)行文件相同路徑下。0：參數(shù)沒(méi)有錯(cuò)誤。：第一個(gè)參數(shù)錯(cuò)誤。（請(qǐng)檢查是否組對(duì)象名稱(chēng)，或 “MCGS_ALAM）2:時(shí)間參數(shù)格式錯(cuò)誤。3：狀態(tài)變量的類(lèi)型錯(cuò)誤。（兩個(gè)變量都必須是開(kāi)關(guān)量）5：同時(shí)只能支持一個(gè) csv導(dǎo)出。參數(shù)：組對(duì)象名：字符型，要導(dǎo)出的組對(duì)象名稱(chēng)（或 “MCGS_ALRM 。YYYY-MM-DD HH:MM:SS。YYYY-MM-DD HH:MM:SS。導(dǎo)出狀態(tài)：開(kāi)關(guān)型，進(jìn)度指示數(shù)據(jù)對(duì)象名（開(kāi)關(guān)量） 出狀態(tài)。正常導(dǎo)出存盤(pán)后輸出當(dāng)前已經(jīng)導(dǎo)出的記錄條數(shù)。當(dāng)創(chuàng)建導(dǎo)出文件 “XXX.cs失敗時(shí)輸出－（請(qǐng)檢查下位機(jī)是否正插入了U盤(pán)）當(dāng)前沒(méi)有記錄可導(dǎo)出時(shí)輸出－ 否有存盤(pán)信息，或者開(kāi)始時(shí)間結(jié)束時(shí)間是否設(shè)置正確）導(dǎo)出過(guò)程中出現(xiàn)未知數(shù)據(jù)類(lèi)型時(shí)輸出－ ）導(dǎo)出過(guò)程中出現(xiàn)文件操作異常時(shí)輸出－ 4（請(qǐng)檢查U盤(pán)容量是否足夠）進(jìn)度指示：開(kāi)關(guān)量，指定一個(gè)數(shù)字型或開(kāi)關(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。注之前的版本，此參數(shù)為原導(dǎo)出狀態(tài)變量 條數(shù)。轉(zhuǎn)出模式：開(kāi)關(guān)型，保留，設(shè)置為 保留參數(shù)：字符型，保留 ,設(shè)置為空字符串。實(shí)例：

!TransToUSB(MCGS_ALARM , 2008-12-1 00:00:00 , 2008-12-3100:00:00,Switch01,Switch02,0,"")。該函數(shù)最多只能導(dǎo)出30000條記錄。當(dāng)滿足導(dǎo)出時(shí)間條件的記錄數(shù)大于30000時(shí)，只導(dǎo)出前30000條記錄。!CopyDateFileToDisk(pathName,dataType,copyState)函數(shù)意義:拷貝當(dāng)前運(yùn)行工程的數(shù)據(jù)到指定的目錄 pathName中。返回值:：在拷貝的過(guò)程中數(shù)據(jù)對(duì)象轉(zhuǎn)變?yōu)榉抢m(xù)拷貝。0：表示拷貝成功。-1：當(dāng)前工程中,當(dāng)前運(yùn)行工程中沒(méi)有組對(duì)象要存盤(pán)。-2：創(chuàng)建目錄pathName失敗。:

-3：創(chuàng)佳索引文件 MCGS_DATA.ini 文件進(jìn)行寫(xiě)操作失敗。：參數(shù),,目前只支持值為0。-5：磁盤(pán)空間不足。-6：參數(shù)copyState不是數(shù)據(jù)對(duì)象類(lèi)型。-7：參數(shù)copyState是數(shù)據(jù)對(duì)象類(lèi)型,但不是開(kāi)關(guān)型數(shù)據(jù)對(duì)象。-8：參數(shù)copyState在一開(kāi)始調(diào)用此腳本時(shí) ,就為非0。pathName：字符串型.要拷貝數(shù)據(jù)到此的路徑名 寫(xiě)"d:\test",在運(yùn)行環(huán)境可寫(xiě)"harddisk\test"。dataType：開(kāi)關(guān)型.拷貝數(shù)據(jù)的類(lèi)型 ,0表示歷史數(shù)據(jù),1表示報(bào)警數(shù)據(jù).目前只支持拷貝歷史數(shù)據(jù) ,報(bào)警數(shù)據(jù)還沒(méi)有處理。copyState：數(shù)據(jù)對(duì)象型.是否拷貝的標(biāo)志 .當(dāng)為0表示可以拷貝,為非0表示取消當(dāng)前的拷貝。中歷史數(shù)據(jù)拷貝到目錄"harddisk\test"中(如copyState為0表示拷貝,為非表示取消)。說(shuō)明：一般此腳本要配合組態(tài)環(huán)境中的一個(gè)小程序 DataTrans.exe來(lái)一起操作.把拷貝的數(shù)據(jù)目錄 ,通過(guò)U盤(pán)或其他方式 ,導(dǎo)到上位機(jī)(PC),通過(guò)用程序DataTrans.exe來(lái)進(jìn)行數(shù)據(jù)的轉(zhuǎn)換。用戶登錄操作函數(shù)!ChangePassword()函數(shù)意義：彈出密碼修改窗口，供當(dāng)前登錄的用戶修改密碼。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：無(wú)。!ChangePassword()。!CheckUserGroup(strUserGroup)函數(shù)意義：檢查當(dāng)前登錄的用戶是否屬于 strUserGroup用戶組的成員。返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。strUserGroup，字符型，用戶組的名稱(chēng)。!CheckUserGroup("")。!Editusers()返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：無(wú)。!Editusers()。!EnableExitLogon(n)函數(shù)意義：打開(kāi)關(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)行提示。為 退出時(shí)不進(jìn)行權(quán)限檢查。!EnableExitLogon(1)，在退出時(shí)進(jìn)行權(quán)限檢查。!EnableExitPrompt(n)函數(shù)意義：打開(kāi)關(guān)閉退出時(shí)的提示信息。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：n，數(shù)值型，為1時(shí)表示在退出時(shí)彈出提示信息對(duì)話框。為 框。!EnableExitPrompt(1)，在退出時(shí)彈出提示信息對(duì)話框。!GetCurrentGroup()函數(shù)意義：讀取當(dāng)前登錄用戶的所在用戶組名。返回值：字符型，當(dāng)前登錄用戶組名，如沒(méi)有登錄返回空。參數(shù)：無(wú)。!GetCurrentGroup()。!GetCurrentUser()函數(shù)意義：讀取當(dāng)前登錄用戶的用戶名。返回值：字符型，當(dāng)前登錄用戶的用戶名，如沒(méi)有登錄返回空。參數(shù)：無(wú)。!GetCurrentUser()。!LogOff()函數(shù)意義：注銷(xiāo)當(dāng)前用戶。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：無(wú)。!LogOff()。!LogOn()函數(shù)意義：彈出登錄對(duì)話框。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：無(wú)。!LogOn()。字符串操作函數(shù)!Ascii2I(s)函數(shù)意義：返回字符串 s的首字母的Ascii 返回值：開(kāi)關(guān)型。參數(shù)：s，字符型。實(shí)例：!Ascii2I("Afd")=65 。!Bin2I(s)返回值：開(kāi)關(guān)型。參數(shù)：s，字符型。實(shí)例：!Bin2I("101")=5 。!Format(n,str)返回值：字符型。參數(shù)：n，數(shù)值型，要格式化的數(shù)值；化數(shù)值的格式。表示為0.00樣式。小數(shù)點(diǎn)后的0的個(gè)數(shù)表示需要格式化出的小數(shù)位數(shù)。 點(diǎn)前根據(jù)實(shí)際數(shù)值顯示。當(dāng)小數(shù)點(diǎn)前沒(méi)有 0時(shí)，表示為.xx 式樣，當(dāng)小來(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ù)值。返回值：開(kāi)關(guān)型。參數(shù)：s，字符型。實(shí)例：!Hex2I("11") =17。!I2Ascii(s)函數(shù)意義：返回指定Ascii 返回值：字符型。參數(shù)：s，開(kāi)關(guān)型。實(shí)例：!I2Ascii(65) “。!I2Bin(s)返回值：字符型。參數(shù)：s，開(kāi)關(guān)型。實(shí)例：!I2Bin(5) =“101”!I2Hex(s)16進(jìn)制字符串。返回值：字符型。參數(shù)：s，開(kāi)關(guān)型。實(shí)例：!I2Hex(17) “。!I2Oct(s)8進(jìn)制字符串。返回值：字符型。參數(shù)：s，開(kāi)關(guān)型。!I2Oct(9)=“!InStr(n，str1，str2)返回值：數(shù)值型。n，數(shù)值型，開(kāi)始搜索的位置；實(shí)例：!InStr(3,"sdlkfjwe","we") =7。!Lcase(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象 str的所有字符轉(zhuǎn)換成小寫(xiě)。返回值：字符型。str，字符型。!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ù)值型。str，字符型。實(shí)例：!Len("ABCDEFG")= 7。!Ltrim(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象 str中最左邊的空格剔除。返回值：字符型。str，字符型。實(shí)例：!LTrim(" dsfk")="dsfk"!lVal(str)返回值：開(kāi)關(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í)，從零開(kāi)始算起。返回值：字符型。str，字符型，源字符串；k，數(shù)值型，取字符數(shù)。實(shí)例：!Mid("ABCDEFG" ，3，2)="DE"。!Oct2I(s)函數(shù)意義：把8進(jìn)制字符串轉(zhuǎn)換為數(shù)值。返回值：開(kāi)關(guān)型。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中最右邊的空格剔除。返回值：字符型。str，字符型。實(shí)例：!Rtrim(" dsfk")="dsfk"。!Str(x)函數(shù)意義：將數(shù)值型數(shù)據(jù)對(duì)象 x的值轉(zhuǎn)換成字符串。返回值：字符型。x，數(shù)值型。!Str(0.712)="0.712"。!StrComp(str1,str2)函數(shù)意義：比較字符型數(shù)據(jù)對(duì)象 str1和str2是否相等，返回值為0時(shí)相等，否則不相等。不區(qū)分大小寫(xiě)字母。返回值：數(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) 等，類(lèi)似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中左右兩端的空格剔除。返回值：字符型。str，字符型。實(shí)例：!Trim(" dsfk")="dsfk"。!Ucase(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象 str的所有字符轉(zhuǎn)換成大寫(xiě)。返回值：字符型。str，字符型。!UCase("sedERT")="SEDERT"。!Val(str)函數(shù)意義：把字符型數(shù)據(jù)對(duì)象 str的值轉(zhuǎn)換成數(shù)值。返回值：數(shù)值型。str，字符型。實(shí)例：!Val("0.712") =0.712。定時(shí)器操作函數(shù)可用的系統(tǒng)定時(shí)器范圍為到任意一個(gè)。定時(shí)器返回時(shí)間值為數(shù)值型，單位為秒分，時(shí)，但是小數(shù)位最多可以表示到毫秒。因?yàn)椴捎酶↑c(diǎn)數(shù)表示，隨著數(shù)值增大會(huì)略有誤差。!TimerClearOutput( 定時(shí)器號(hào))函數(shù)意義: 清除定時(shí)器的數(shù)據(jù)輸出連接。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)。1號(hào)定時(shí)器的數(shù)據(jù)輸出連接。!TimerRun( 定時(shí)器號(hào))函數(shù)意義：?jiǎn)?dòng)定時(shí)器開(kāi)始工作。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)。!TimerRun(1)1號(hào)定時(shí)器工作。!TimerStop(定時(shí)器號(hào))函數(shù)意義：停止定時(shí)器工作。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)。!TimerStop(1)1號(hào)定時(shí)器工作。!TimerSkip( 定時(shí)器號(hào),)函數(shù)意義：在計(jì)時(shí)器當(dāng)前時(shí)間數(shù)上加減指定值。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)；步長(zhǎng)值。!TimerSkip(1,3)，1+3。!TimerReset(定時(shí)器號(hào),數(shù)值)函數(shù)意義設(shè)置定時(shí)器的當(dāng)前值，由第二個(gè)參數(shù)設(shè)定，第二個(gè)參數(shù)可以是 MCG嵌入版變量返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)；數(shù)值。!TimerReset(1,12)112。!TimerValue( ,0)函數(shù)意義：取定時(shí)器的當(dāng)前值。返回值：將定時(shí)器的值以數(shù)值型的方式輸出（數(shù)值格式） 參數(shù)：定時(shí)器號(hào)。Data3=!TimerValue(1,0)1的值給Data3。!TimerStr( ,1)函數(shù)意義：以字符串的形式返回當(dāng)前定時(shí)器的值。返回值：字符型變量， 將定時(shí)器的值以字符型的方式輸出（時(shí)間格式） 參數(shù)：定時(shí)器號(hào)。，取定時(shí)器的值以“00：00：00”形式輸出給 Time。!TimerState( )函數(shù)意義：取定時(shí)器的工作狀態(tài)。返回值：數(shù)值型變量，0 - 定時(shí)器停止，1- 。參數(shù)：定時(shí)器號(hào)。時(shí)器1的工作狀態(tài)給 !TimerSetLimit( 定時(shí)器號(hào)3)函數(shù)意義：設(shè)置定時(shí)器的最大值，即設(shè)置定時(shí)器的上限。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)(1-255)；上限值；第三個(gè)參數(shù)，1 - 表示運(yùn)行到60后停止；0- 到60后重新循環(huán)運(yùn)行。實(shí)例：!TimerSetLimit(1,60,1) !TimerSetOutput( 定時(shí)器號(hào),變量)函數(shù)意義：設(shè)置定時(shí)器的值輸出連接的變量。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)；變量，定時(shí)器的值輸出連接的變量。實(shí)例：!TimerSetOutput(1,Data0)，將定時(shí)器數(shù)據(jù)連接到 。!TimerWaitFor( 定時(shí)器號(hào),數(shù)值)返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：定時(shí)器號(hào)(1-255)；數(shù)值， 等待定時(shí)器工作到指定的值。，等定時(shí)器工作到55秒后再執(zhí)行其他操作。系統(tǒng)操作函數(shù)!AppActive()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!Beep()函數(shù)意義：發(fā)出嗡鳴聲。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。參數(shù)：無(wú)。!Beep()。!EnableDDEConnection()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!EnableDDEInput()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!LinePrtOutput()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!PlaySound()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!SendKeys(string)函數(shù)意義將一個(gè)或多個(gè)按鍵消息發(fā)送到活動(dòng)窗口， 鍵盤(pán)上進(jìn)行輸入一樣。返回值：數(shù)值型。返回值=0：調(diào)用成功；<>0：調(diào)用失敗。參數(shù)：string，字符串表達(dá)式，指定要發(fā)送的按鍵消息。實(shí)例：!SendKeys("%{TAB}") ，切換窗口。說(shuō)明：每個(gè)按鍵由一個(gè)或多個(gè)字符表示。為了指定單一鍵盤(pán)字符，必須按字符本身的鍵。 如，為了表示字母 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)使用下列代碼：按鍵按鍵BACKSPACE代碼{BACKSPACE},{BKSP}{BREAK}{CAPSLOCK}{BS},或BREAKCAPSLOCKDEL orDELETEDOWNARROWENDENTERESCHOMEINSorINSERTLEFTARROWNUMLOCKPAGEDOWNPAGEUPRIGHTARROWSCROLLLOCKTABF1F2F3F4F5F6F7F8F9F10F11F12{DELETE}{DOWN}{END}{ENTER}{ESC}{HOME}{INSERT}{LEFT}或{DEL}或~或{INS}{NUMLOCK}{PGDN}{PGUP}{RIGHT}{SCROLLLOCK}{TAB}{UP}{F1}{F2}{F3}{F4}{F5}{F6}{F7}{F8}{F9}{F10}{F11}{F12}F13F13F14F15F16{F13}{F14}{F15}{F16}為了指定那些與 SHIFT、CTRL及ALT等按鍵結(jié)合的組合鍵，可在這些按鍵碼的前面放置一個(gè)或多個(gè)代碼，這些代碼列舉如下：按鍵代碼SHIFT+CTRL ALT %為了說(shuō)明在按下其它按鍵時(shí)應(yīng)同時(shí)按下 SHIFT、CTRL、及ALT 的任意組合鍵，請(qǐng)把那些按鍵的碼放在括號(hào)當(dāng)中。 例如，為了說(shuō)明按下 與C的時(shí)候同時(shí)按下 SHIFT 鍵，請(qǐng)使用"+(EC)"。為了說(shuō)明在按下E的時(shí)候同時(shí)按下 SHIFT 鍵，但接著按 C而不按 SHIFT，則使用"+EC"。注意：不能用 SendKeys 將按鍵消息發(fā)送到這樣一個(gè)應(yīng)用程序，這個(gè)應(yīng)用程序并沒(méi)有被設(shè)計(jì)成在 MicrosoftWindows 中運(yùn)行。Sendkeys也無(wú)法將PRINTSCREEN 按鍵{PRTSC} 發(fā)送到任何應(yīng)用程序。!SetLinePrinter(n)函數(shù)意義：打開(kāi)關(guān)閉行式打印輸出。返回值：數(shù)值型。返回值=0<>0:調(diào)用失敗。n1，表示打開(kāi)行式打印輸出；0，則關(guān)閉行式打印輸出。!SetLinePrinter(1)，打開(kāi)行式打印輸出。!SetTime(n1,n2,n3,n4,n5,n6)函數(shù)意義：設(shè)置當(dāng)前系統(tǒng)時(shí)間返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。，數(shù)值型，設(shè)定年數(shù)，小于n2，數(shù)值型，設(shè)定月數(shù)，大于 12和小于1時(shí)不變；n3，數(shù)值型，設(shè)定天數(shù)，大于 31和小于1時(shí)不變；n4，數(shù)值型，設(shè)定小時(shí)數(shù)，大于 n5，數(shù)值型，設(shè)定分鐘數(shù)，大于 n6，數(shù)值型，設(shè)定秒數(shù)，大于 59和小于0時(shí)不變。!SetTime(2000,1,1,1,1,1)，設(shè)置當(dāng)前系統(tǒng)時(shí)間為2000年1月1日1時(shí)1分1秒。!Shell()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!Sleep(mTime)函數(shù)意義：在腳本程序中等待 mTime毫秒，然后再執(zhí)行下條語(yǔ)句。只能在策略中使用，否則會(huì)造成系統(tǒng)響應(yīng)緩慢。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。mTime，數(shù)值型，要等待的毫秒數(shù)。!Sleep(10)。!TerminateApplication()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。!WaitFor(Dat1,Dat2)否則造成系統(tǒng)響應(yīng)緩慢。返回值：數(shù)值型。返回值=0<>0：調(diào)用失敗。，數(shù)值型，條件表達(dá)式，如：D=15。!WaitFor（0D秒后條件仍然沒(méi)有滿足，也自動(dòng)繼續(xù)執(zhí)行。此函數(shù)通常用于做實(shí)驗(yàn)時(shí)，等待某個(gè)條件滿足，然后再接著執(zhí)行實(shí)驗(yàn)流程。他與Sleep函數(shù)以及While循環(huán)語(yǔ)句、其他循環(huán)策略配合，能夠?qū)崿F(xiàn)復(fù)雜的流程調(diào)度。!WaitFor只能用于策略中，而不能直接在窗口控件的腳本程序中使用。!WinHelp()函數(shù)說(shuō)明：此函數(shù)在嵌入版中無(wú)效，考慮兼容性問(wèn)題，故保留。數(shù)學(xué)函數(shù)!Atn(x)函數(shù)意義：反正切函數(shù)。返回值：數(shù)值型，用弧度表示。x，數(shù)值型。!Atn(1)=0.785398。!Cos(x)返回值：數(shù)值型。x，數(shù)值型，用弧度表示。!Cos(3.14159)=-1.0。!Sin(x)返回值：數(shù)值型。x，數(shù)值型，用弧度表示。!Sin(3.14159)=0.0。!Tan(x)返回值：數(shù)值型。x，數(shù)值型，用弧度表示。!Tan(3.14159)=0.0。!Exp(x)返回值：數(shù)值型。參x，數(shù)值型。!Exp(2.3020585093)=10.0。!Log(x)返回值：數(shù)值型。參x，數(shù)值型。!Log(10)=2.302。!Sqr(x)返回值：數(shù)值型。x，數(shù)值型。實(shí)例!Sqr(4.0)=2.0。!Abs(x)返回值：數(shù)值型。x，數(shù)值型。實(shí)例!Abs(-3.14159)=3.14159。!Sgn(x)返回值：數(shù)值型。參x，數(shù)值型。!Sgn(-10)=-1!Sgn(10)=1!Sgn(0)=0。!BitAnd(x,y)返回值：開(kāi)關(guān)型。參數(shù)：x，開(kāi)關(guān)型，y，開(kāi)關(guān)型。實(shí)例：!BitAnd(3,4) =0。!BitOr(x,y)返回值：開(kāi)關(guān)型。參數(shù)：x，開(kāi)關(guān)型。y,開(kāi)關(guān)型。實(shí)例：!BitOr(3,4) =7。!BitXor(x,y)返回值：開(kāi)關(guān)型。參數(shù)：x，開(kāi)關(guān)型。y,開(kāi)關(guān)型。實(shí)例：!BitXor(3,4) =7。!BitClear(x,y)函數(shù)意義：清除指定位，位置從0開(kāi)始計(jì)算。返回值：開(kāi)關(guān)型。x，開(kāi)關(guān)型。y,開(kāi)關(guān)型。實(shí)例：!BitClear(3,1) =1，把第2位清空。!BitSet(x,y)函數(shù)意義：設(shè)置指定位，位置從0開(kāi)始計(jì)算。返回值：開(kāi)關(guān)型。x，開(kāi)關(guān)型。y,開(kāi)關(guān)型。實(shí)例：!BitSet (3,2)=7。!BitNot(x)返回值：開(kāi)關(guān)型。參x，開(kāi)關(guān)型。實(shí)例：!BitNot(0) =0xffffffff 。!BitTest(x,y)函數(shù)意義：檢測(cè)指定位是否為一，位置從 返回值：開(kāi)關(guān)型。x，開(kāi)關(guān)型。y開(kāi)關(guān)型。!BitTest(3,2)=0。!BitLShift(x,y)函數(shù)意義：左移返回值：開(kāi)關(guān)型。參數(shù)：x，開(kāi)關(guān)型。y,開(kāi)關(guān)型。實(shí)例：!BitLShift(3,1) =6。!BitRShift(x)函數(shù)意義：右移。返回值：開(kāi)關(guān)型。參數(shù)：x，開(kāi)關(guān)型。y,開(kāi)關(guān)型。實(shí)例：!BitRShift(3,1) =1。!Rand(x,y)函數(shù)意義：生成隨機(jī)數(shù)，隨機(jī)數(shù)的范圍在 x和y之間。返回值：數(shù)值型。參數(shù)：x，數(shù)值型。y, 實(shí)例：!Rand(3,4)=3.1。文件操作函數(shù)注意：文件操作函數(shù)中所涉及到文件的路徑均為絕對(duì)路徑!FileAppend(strTarget,strSource)容添加到文件 為一個(gè)文件。返回值：開(kāi)關(guān)型。strTarget，字符型，目標(biāo)文件，需要寫(xiě)絕對(duì)路徑；實(shí)例：!FileAppend("d:\a.txt","d:\b.txt") 。合并到文件a.txt 若a.txt 一個(gè)文件。!FileCopy(strSource,strTarget)函數(shù)意義：將源文件 strSource復(fù)制到目標(biāo)文件 件覆蓋。返回值：開(kāi)關(guān)型；返回0，操作不成功；strSource，字符型，源文件；字符型，目標(biāo)文件。實(shí)例：!FileCopy("d:\a.txt", ”d:\b.txt")盤(pán)下文件a.txt復(fù)制到b.txt。!FileDelete(strFilename)strFilename指定的文件刪除。返回值：開(kāi)關(guān)型；返回0，操作不成功；str1，字符型，將被刪除的文件。實(shí)例：!FileDelete("d:\a.txt") 。實(shí)例說(shuō)明：刪除將D盤(pán)下文件a.txt。!FileFindFirst(strFilename,objName,objSize,objAttrib)函數(shù)意義：查找第一個(gè)名字為 strFilename的文件或目錄。返回值：開(kāi)關(guān)型；返回-1，操作不成功。返回其它值：操作成功，返回值為一個(gè)句柄，該值為以后的查找提供根據(jù)。參數(shù)：strFilename，字符型，要查找的文件的文件名文件名中可以包含文件通配符：*和；成功后，保存查找結(jié)果的名稱(chēng)。，數(shù)值型對(duì)象名，函數(shù)調(diào)用成功后，保存查找結(jié)果的大??；objAttrib，數(shù)值型對(duì)象名，函數(shù)調(diào)用成功后，保存查找結(jié)果的屬性：若objAttrib =0，則查找結(jié)果為一個(gè)文件；若objAttrib 1，則查找結(jié)果為一個(gè)目錄。實(shí)例：!FileFindFirst("d:\a*.txt",Name,Size,Attrib) 。實(shí)例說(shuō)明：查找D盤(pán)下第一個(gè)名字為： a*.txt的文件或目錄，將查找結(jié)果的屬性存入 Attrib數(shù)值變量中，大小存入 Size數(shù)值變量中，名字存入 Name數(shù)值變量中。!FileFindNext(FindHandle,objAttrib,objSize,objName)函數(shù)意義：根據(jù)FindHandle提供的句柄，繼續(xù)查找下一個(gè)文件或目錄。返回值：開(kāi)關(guān)型；返回0：查找不成功；參數(shù)：FindHandle，開(kāi)關(guān)型，由函數(shù) !FileFindFirst 返回。objAttrib，數(shù)值型對(duì)象名，函數(shù)調(diào)用成功后，保存查找結(jié)果的屬性：若objAttrib =0，則查找結(jié)果為一個(gè)文件；若objAttrib =1，則查找結(jié)果為一個(gè)目錄。，數(shù)值型對(duì)象名，函數(shù)調(diào)用成功后，保存查找結(jié)果的大?。粚?shí)例：!FileFindNext(aa,Attrib,Size,Name) 。實(shí)例說(shuō)明：根據(jù)句柄 aa，繼續(xù)查找下一個(gè)文件或目錄，其中， 由函數(shù)!FileFindFirst 回值提供。!FileFindFirst()!FileFindNext()在同一個(gè)腳本塊中編寫(xiě)才有效。!FileIniReadValue(strIniFilename,strSection,strItem,objResult)函數(shù)意義：從配置文件（.ini 取一個(gè)值。返回值：開(kāi)關(guān)型。strIniFilename，字符型，配置文件的文件名；strSection，字符型，要讀取數(shù)據(jù)所在的節(jié)的名稱(chēng)；strItem，字符型，要讀取數(shù)據(jù)的項(xiàng)名；，用于保存讀到的數(shù)據(jù)；實(shí)例：!FileIniReadValue("d:\a.ini","system","memory",result) 。實(shí)例說(shuō)明：從配置文件a.ini中的system節(jié)中讀取memory項(xiàng)的值，并將該值放入 result數(shù)據(jù)對(duì)象中。!FileIniWriteValue(strIniFilename,strSection,strItem,objResult)函數(shù)意義：向配置文件（.ini 入一個(gè)值。返回值：開(kāi)關(guān)型。strIniFilename，字符型，配置文件的文件名；strSection，字符型，要寫(xiě)入數(shù)據(jù)所在的節(jié)的名稱(chēng)；strItem，字符型，要讀寫(xiě)入據(jù)的項(xiàng)名；，用于保存寫(xiě)入的數(shù)據(jù)；實(shí)例：!FileIniWriteValue("d:\a.ini","system","memory",result) 。實(shí)例說(shuō)明：將數(shù)據(jù)對(duì)象 result的值寫(xiě)入到配置文件 a.ini中的system節(jié)中memory項(xiàng)中。!FileIniWriteNoFlush(strIniFilename,strSection,strItem,objResult)函 數(shù) 意義 ： !FileIniWriteNoFlush(strIniFilename,strSection,strItem,objResult) 函 和!FileIniWriteValue 接口和功能基本一致，只是寫(xiě)完后不刷新磁盤(pán)；返回值：開(kāi)關(guān)型。strIniFilename，字符型，配置文件的文件名；strSection，字符型，要寫(xiě)入數(shù)據(jù)所在的節(jié)的名稱(chēng)；strItem，字符型，要讀寫(xiě)入據(jù)的項(xiàng)名；，用于保存寫(xiě)入的數(shù)據(jù)；實(shí)例：!FileIniNoFlush("d:\a.ini","system","memory",result) 。實(shí)例說(shuō)明：將數(shù)據(jù)對(duì)象result的值寫(xiě)入到配置文件 a.ini中的system節(jié)中memory項(xiàng)中。此時(shí)值被寫(xiě)入內(nèi)存，磁盤(pán)未被刷新，磁盤(pán)文件不保存。!FileIniFlush(strIniFilename)函數(shù)意義：!FileIniWriteFlush(strIniFilename) 函數(shù)將內(nèi)存中的 ini 文件更新到磁盤(pán)上，與!FileIniWriteFlush(strIniFilename ，strSection，strItem，objResult) 函數(shù)配合使用返回值：開(kāi)關(guān)型。成功返回01。strIniFilename，字符型，配置文件的文件名；實(shí)例：!FileIniFlush("d:\a.ini") 。實(shí)例說(shuō)明將內(nèi)存中數(shù)據(jù)對(duì)象 result 的值更新到磁盤(pán)配置文件 中的system節(jié)中memory項(xiàng)中，并顯示磁盤(pán)文件。!FileMove(strSource,strTarget)函數(shù)意義：將文件移動(dòng)并改名為strTarget。返回值：開(kāi)關(guān)型；返回0：操作失?。籹trSource，字符型，源文件；字符型，目標(biāo)文件。實(shí)例：!Filemove("d:\a.txt","d:\b.txt") 。：將D盤(pán)下文件a.txt移至同一目錄下，并改名為 注意：如果目標(biāo)文件已存在，直接返回 0，操作失敗。!FileReadFields(strFilename,lPosition, 任意個(gè)數(shù)變量)函數(shù)意義：從strFilename指定的文件中讀出 （逗號(hào)分隔變量）記錄返回值：開(kāi)關(guān)型。strFilename，字符型，文件名；lPosition，數(shù)值型，數(shù)據(jù)開(kāi)始位置；實(shí)例：!FileReadFields("d:\a.csv",200,var1,var2,var3,var4) a.csv2004var1,var2,var3,var4中。!FileReadStr(strFilename,lPosition,lLength,objResult)strFilename指定文件（需為.dat文件）中的lPosition，位置開(kāi)始，讀取lLength個(gè)字節(jié)，或一整行，并將結(jié)果保存到 objResult數(shù)據(jù)對(duì)象中。返回值：開(kāi)關(guān)型。strFilename，字符型，文件名；lPosition，開(kāi)關(guān)型，數(shù)據(jù)開(kāi)始位置；，字符型，用于存放結(jié)果的數(shù)據(jù)對(duì)象。!FileReadStr("d:\a.dat",100,20,abc)。結(jié)果存入變量abc中。!FileSplit(strSourceFile,strTargetFile,FileSize)返回值：開(kāi)關(guān)型。strSourceFile，字符型，準(zhǔn)備切開(kāi)的文件名；strTargetFile，字符型，切開(kāi)后的文件名；FileSize，數(shù)值型，切開(kāi)的文件的最大大小，單位是 實(shí)例：!FileSplit("d:\1.txt","Spl",1.0) 。實(shí)例說(shuō)明此時(shí)函數(shù)將把文件 為大小是1MB的文件，并存放在組態(tài)軟件 work下，名稱(chēng)分別為spl000.spl,spl001.spl,spl002.spl等等。!FileWriteFields(strFilename,lPosition, 任意個(gè)數(shù)變量)函數(shù)意義：向strFilename指定的文件中寫(xiě)入 （逗號(hào)分隔變量）記錄返回值：開(kāi)關(guān)型。strFilename，字符型，文件名；lPosition，開(kāi)關(guān)型，數(shù)據(jù)開(kāi)始位置；=0，表示在文件開(kāi)頭；實(shí)例：!FileWriteFields ("d:\a.csv",200,var1,var2,var3,var4)。實(shí)例說(shuō)明：向D盤(pán)文件a.csv的文件結(jié)尾，寫(xiě)入4個(gè)數(shù)據(jù)，分別為變量： var1,var2,var3,var4的值。添加，并不覆蓋原來(lái)的內(nèi)容。!FileWriteStr(strFilename,lPosition,str,Rn)函數(shù)意義：向指定文件 strFilename中的IPosition位置開(kāi)始，寫(xiě)入一個(gè)字符串，或一整行。返回值：開(kāi)關(guān)型。strFilename，字符型，文件名；lPosition，開(kāi)關(guān)型，數(shù)據(jù)開(kāi)始位置；=0，表示在文件開(kāi)頭；str，字符型，要寫(xiě)入的字符串；Rn，開(kāi)關(guān)型，是否換行；0，表示不換行；1，表示換行。實(shí)例：!FileWriteStr ("d:\a.txt",a,"abcdefg",input) 。實(shí)例說(shuō)明：在D盤(pán)下a.txt文件的開(kāi)頭（當(dāng) a為0時(shí)）或結(jié)尾（當(dāng) a為1時(shí)）寫(xiě)入一個(gè)字符串"abcdefg"，如果input為1時(shí)，在此字符串后面添加回車(chē)換行，否則不添加。礎(chǔ)上添加，并不覆蓋原來(lái)的內(nèi)容。!FileReadStrLimit(str,int,int,int,str)返回值：數(shù)值型。返回值＝0：打開(kāi)文件成功，讀回?cái)?shù)據(jù)成功；＝1：打開(kāi)文件成功，沒(méi)有讀到數(shù)據(jù)（Eof）；＝-1：文件不存在；＝-2：文件存在無(wú)法打開(kāi)；＝-3：組態(tài)錯(cuò)誤；＝-4：未定義的文件打開(kāi)錯(cuò)誤。str，字符串，需要操作的文件名稱(chēng)，包含絕對(duì)路徑和文件名，如果不包含路徑，則表示在當(dāng)前工程路徑下；如果不包含擴(kuò)展名，則擴(kuò)展名為 則表示路徑為當(dāng)前路徑，文件名為當(dāng)前工程名稱(chēng)＋ File，擴(kuò)展名為 Dat；int，開(kāi)關(guān)型，讀數(shù)據(jù)的起始位置，該數(shù)據(jù)的單位是字節(jié)，從 程序內(nèi)部應(yīng)該有防錯(cuò)處理；，開(kāi)關(guān)型，讀數(shù)據(jù)的長(zhǎng)度，此長(zhǎng)度的數(shù)據(jù)可能包含了若干填充符（Ascii 的，數(shù)值型，格式化方式，如果讀回的數(shù)據(jù)中包含填充符，寫(xiě)入 變量中時(shí)是否保留這些填充符，0 不保留，1保留；str，字符型，存放讀回來(lái)的數(shù)據(jù)的 MCG字符型變量。實(shí)例：!FileReadStrLimit("D:\a.txt",1,6,1,a) 讀出格式化后的文件。實(shí)例說(shuō)明：將a.txt文件從第１字節(jié)開(kāi)始，讀取數(shù)據(jù)，按６字節(jié)長(zhǎng)度格式化，讀回的數(shù)據(jù)中若包含填充符，寫(xiě)入 MCGS變量中時(shí)保留這些填充符。!FileWriteStrLimit(str,int,int,int,str,int,int)返回值：數(shù)值型。返回值＝0：打開(kāi)文件成功，寫(xiě)入數(shù)據(jù)成功；＝1：打開(kāi)文件成功，無(wú)法寫(xiě)入（硬盤(pán)空間不夠等） ；＝-1：文件不存在且無(wú)法創(chuàng)建；＝-2：文件存在，無(wú)法打開(kāi)；＝-3：組態(tài)錯(cuò)誤；＝-4：未定義的文件打開(kāi)錯(cuò)誤。str，字符串，需要操作的文件名稱(chēng)，包含絕對(duì)路徑和文件命，如果不包含路徑，則表示在當(dāng)前工程路徑下；如果不包含擴(kuò)展名，則擴(kuò)展名為 則表示路徑為當(dāng)前路徑，文件命為當(dāng)前工程名稱(chēng)＋ File，擴(kuò)展名為 Dat；，開(kāi)關(guān)型，寫(xiě)數(shù)據(jù)的起始位置，該數(shù)據(jù)的單位是字節(jié)；任意的正數(shù)，表示從該字節(jié)的位置開(kāi)始寫(xiě)數(shù)據(jù)， 插入方式從該字節(jié)之后插入， 就直接覆蓋該示用文件頭開(kāi)始寫(xiě)記錄；-1，表示從文件尾開(kāi)始寫(xiě)記錄，無(wú)論插入或覆蓋方式，最后的結(jié)果都是插入數(shù)據(jù)，即不會(huì)修改原有的任何數(shù)據(jù)；int，開(kāi)關(guān)型，數(shù)據(jù)寫(xiě)入文件后的長(zhǎng)度，此長(zhǎng)度的數(shù)據(jù)可能包含了若干填充符（Ascii 的，格式化方式，如果被寫(xiě)的數(shù)據(jù)長(zhǎng)度大于參數(shù) 2指定的長(zhǎng)度，則在剪裁該數(shù)據(jù)的左邊還是右邊， 尾）；如果反之，被寫(xiě)的數(shù)據(jù)長(zhǎng)度小于參數(shù)2指定的長(zhǎng)度，則固定在在數(shù)據(jù)的右邊（后邊）添加填充符（Ascii str，字符型，存放被寫(xiě)數(shù)據(jù)的 MCG字符型變量；，數(shù)值型，寫(xiě)記錄的方式， 插入，1覆蓋；錄， 1表示本條記錄未寫(xiě)完；實(shí)例：!FileWriteStrLimit("D:\a.txt",1,6,1,a,0,0) 寫(xiě)出格式化后的文件。a.txt文件從第１字節(jié)開(kāi)始，寫(xiě)數(shù)據(jù)，按６字節(jié)長(zhǎng)度，右邊（去尾）格式化，被寫(xiě)數(shù)據(jù)的結(jié)束記錄。時(shí)間運(yùn)算函數(shù)!TimeStr2I(strTime)函數(shù)意義：將表示時(shí)間的字符串（ YYYY/MM/DD HH:MM:SS）轉(zhuǎn)換為時(shí)間值。返回值：開(kāi)關(guān)型，轉(zhuǎn)換后的時(shí)間值。參數(shù)：strTime，字符型，以字符串型表示的時(shí)間（ YYYY/MM/DD HH:MM:SS。實(shí)例：!TimeStr2I("2001/1/1 3:15:28")。實(shí)例說(shuō)明：將表示時(shí)間的字符串“2001/1/13:15:28!TimeI2Str(iTime,strFormat)返回值：字符型，轉(zhuǎn)換后的時(shí)間字符串。參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值（注意，這里只能用 !TimeStr2I(strTime)轉(zhuǎn)換出的時(shí)間值，否則將不能正確轉(zhuǎn)換。strFormat，字符型，轉(zhuǎn)換后的時(shí)間字符串的格式。實(shí)例：!TimeI2Str(Time,"%A, %B%d,%Y")。實(shí)例說(shuō)明：將時(shí)間值轉(zhuǎn)換為字符串型，其表示格式為：星期，月 日，年。!TimeI2Str的格式化標(biāo)準(zhǔn)為：%a星期的簡(jiǎn)寫(xiě)。如： Fri是Friday的簡(jiǎn)寫(xiě)表示星期五%A星期的全稱(chēng)。如： Sunday表示星期日%b月份的簡(jiǎn)寫(xiě)。如： Jan是January的簡(jiǎn)寫(xiě)表示一月%B月份的全稱(chēng)。如： June表示六月%c適合于本地習(xí)慣的時(shí)間日期表示。如：05/07/01 年5月7日9時(shí)47分12秒%d月份中日期的十進(jìn)制表示。如： 07表示7日%H時(shí)制的小時(shí)表示。如：%I12時(shí)制的小時(shí)表示。%j一年中天數(shù)的十進(jìn)制表示。如： %m月份的十進(jìn)制表示。如：06表示6月%M分鐘的十進(jìn)制表示。如：28表示28分%p%S秒鐘的十進(jìn)制表示。%U一年中周數(shù)的十進(jìn)制表示，星期日為第一天。如： 2001-06-07是第22周%w星期的十進(jìn)制表示；01，表示星期一；依此類(lèi)推。%W一年中周數(shù)的十進(jìn)制表示，星期一為第一天。如： 2001-06-07是第23周%x適合當(dāng)?shù)氐娜掌诒硎尽Ｈ纾?6/07/01%X適合當(dāng)?shù)氐臅r(shí)間表示。如：9時(shí)47分1209:47:12%y不顯示世紀(jì)的年的十進(jìn)制表示。如：01表示2001年%Y顯示世紀(jì)的年的十進(jìn)制表示。如：2001表示2001年%z或者%Z時(shí)區(qū)名稱(chēng)的簡(jiǎn)寫(xiě)，如果時(shí)區(qū)不可知?jiǎng)t沒(méi)有字符。如：中國(guó)標(biāo)準(zhǔn)時(shí)間%%百分號(hào)表示注：目前，在此版本中有些顯示參數(shù)還沒(méi)有實(shí)現(xiàn)其功能，具體的有 %p %U%w%W%x%%%%!TimeGetYear(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的年份。返回值：開(kāi)關(guān)型，時(shí)間值 iTime中的年份。參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值。!TimeGetYear(iTime)。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的年份。!TimeGetMonth(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的月份。返回值：開(kāi)關(guān)型，時(shí)間值 參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值。實(shí)例：!TimeGetMonth(iTime) 。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的月份。!TimeGetSecond(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的秒數(shù)。返回值：開(kāi)關(guān)型，時(shí)間值 參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值。!TimeGetSecond(iTime)。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的秒數(shù)。!TimeGetSpan(iTime1,iTime2)函數(shù)意義：計(jì)算兩個(gè)時(shí)間iTime1iTime2之差。返回值：開(kāi)關(guān)型，兩時(shí)間之差。iTime1，開(kāi)關(guān)型，時(shí)間值；!TimeGetSpan(iTime1,iTime2)實(shí)例說(shuō)明：計(jì)算兩個(gè)時(shí)間iTime1iTime2之差。!TimeGetDayOfWeek(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的星期。返回值：開(kāi)關(guān)型，時(shí)間值iTime中的秒數(shù)（1為星期日,2表示星期一，??）。iTime，開(kāi)關(guān)型，時(shí)間值。實(shí)例：!TimeGetDayOfWeek(iTime) 。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的星期。!TimeGetHour(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的小時(shí)。返回值：開(kāi)關(guān)型，時(shí)間值 參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值。!TimeGetHour(iTime)。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的小時(shí)。!TimeGetMinute(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的分鐘。返回值：開(kāi)關(guān)型，時(shí)間值 參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值。實(shí)例：!TimeGetMinute(iTime) 。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的分鐘。!TimeGetDay(iTime)函數(shù)意義：獲取時(shí)間值 iTime中的日期。返回值：開(kāi)關(guān)型，時(shí)間值 參數(shù)：iTime，開(kāi)關(guān)型，時(shí)間值。!TimeGetDay(iTime)。實(shí)例說(shuō)明：獲取時(shí)間值 iTime中的日期。!TimeGetCurrentTime()函數(shù)意義：獲取當(dāng)前時(shí)間值。返回值：開(kāi)關(guān)型，當(dāng)前的時(shí)間值。參數(shù)：無(wú)。!TimeGetCurrentTime()。實(shí)例說(shuō)明：獲取當(dāng)前時(shí)間值。注意：1、保存時(shí)間值，應(yīng)該使用數(shù)值型數(shù)，使用浮點(diǎn)會(huì)損失精度，典型的問(wèn)題是時(shí)間添加。問(wèn)題是當(dāng)前時(shí)間不刷新，其實(shí)已經(jīng)刷新了，但用浮點(diǎn)數(shù)表達(dá)不出來(lái)。!TimeSpanGetDays(iTimeSpan)函數(shù)意義：獲取時(shí)間差中的天數(shù)；時(shí)間差由TimeGetSpan函數(shù)計(jì)算得來(lái)）返回值：開(kāi)關(guān)型，時(shí)間差中的天數(shù)（1~31）參數(shù)：iTimeSpan，開(kāi)關(guān)型，時(shí)間差。實(shí)!TimeSpanGetDays(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的天數(shù)。!TimeSpanGetHours(iTimeSpan)差由TimeGetSpan函數(shù)計(jì)算得來(lái)）。返回值：開(kāi)關(guān)型，時(shí)間差中的小時(shí)數(shù)（ 0~23）。iTimeSpan，開(kāi)關(guān)型，時(shí)間差。!TimeSpanGetHours(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的小時(shí)數(shù)。!TimeSpanGetMinutes(iTimeSpan)差由TimeGetSpan函數(shù)計(jì)算得來(lái)）。返回值：開(kāi)關(guān)型，時(shí)間差中的分鐘數(shù)（ 0~59）。iTimeSpan，開(kāi)關(guān)型，時(shí)間差。!TimeSpanGetMinutes(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的分鐘數(shù)。!TimeSpanGetSeconds(iTimeSpan)函數(shù)意義：獲取時(shí)間差中的秒數(shù)；（時(shí)間差由TimeGetSpan函數(shù)計(jì)算得來(lái)）返回值：開(kāi)關(guān)型，時(shí)間差中的秒數(shù)（0~59）iTimeSpan，開(kāi)關(guān)型，時(shí)間差。實(shí)例：!TimeSpanGetSeconds(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的秒數(shù)。!TimeSpanGetTotalHours(iTimeSpan)函數(shù)意義：獲取時(shí)間差中的小時(shí)總數(shù)；（時(shí)間差由TimeGetSpan函數(shù)計(jì)算得來(lái)）返回值：開(kāi)關(guān)型，時(shí)間差中的小時(shí)總數(shù)。iTimeSpan，開(kāi)關(guān)型，時(shí)間差。!TimeSpanGetTotalHours(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的小時(shí)總數(shù)。!TimeSpanGetTotalMinutes(iTimeSpan)函數(shù)意義：獲取時(shí)間差中的分鐘總數(shù)；（時(shí)間差由TimeGetSpan函數(shù)計(jì)算得來(lái)）返回值：開(kāi)關(guān)型，時(shí)間差中的分鐘總數(shù)。iTimeSpan，開(kāi)關(guān)型，時(shí)間差。實(shí)例：!TimeSpanGetTotalMinutes(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的分鐘總數(shù)。!TimeSpanGetTotalSeconds(iTimeSpan)函數(shù)意義：獲取時(shí)間差中的秒總數(shù)；時(shí)間差由TimeGetSpan函數(shù)計(jì)算得來(lái)）返回值：開(kāi)關(guān)型，時(shí)間差中的秒總數(shù)。iTimeSpan，開(kāi)關(guān)型，時(shí)間差。實(shí)例：!TimeSpanGetTotalSeconds(TimeSpan)。實(shí)例說(shuō)明：獲取時(shí)間差 TimeSpan中的秒總數(shù)。!TimeAdd(iTime,iTimeSpan)函數(shù)意義：向時(shí)間iTime中加入由iTimeSpan指定的秒數(shù)。返回值：開(kāi)關(guān)型，相加后的時(shí)間值。iTime，開(kāi)關(guān)型，初始時(shí)間值。iTimeSpan，開(kāi)關(guān)型，要加的秒數(shù)。!TimeAdd(Time,500)。實(shí)例說(shuō)明：向時(shí)間嵌入式系統(tǒng)函數(shù)!Outp(1,2)函數(shù)意義：向端口輸出一個(gè)字節(jié)。返回值：開(kāi)關(guān)型。返回值=0<>0：調(diào)用不正常。1，開(kāi)關(guān)型，端口號(hào)；參數(shù)2，開(kāi)關(guān)型，輸出的字節(jié)。!Outp(320,255)。!OutpW(1,2)函數(shù)意義：向端口輸出兩個(gè)字節(jié)。返回值：開(kāi)關(guān)型。返回值=0<>0：調(diào)用不正常。1，開(kāi)關(guān)型，端口號(hào)；參數(shù)2，開(kāi)關(guān)型，輸出的字節(jié)。!OutpW(320,256)。!OutpD(1,2)函數(shù)意義：向端口輸出四個(gè)字節(jié)。返回值：開(kāi)關(guān)型。返回值=0<>0：調(diào)用不正常。1，開(kāi)關(guān)型，端口號(hào)；參數(shù)2，開(kāi)關(guān)型，輸出的字節(jié)。!OutpD(320,65537)。!Inp(1)返回值：開(kāi)關(guān)型。輸入的字節(jié)。1，開(kāi)關(guān)型，端口號(hào)。!Inp(320)。320輸入的一個(gè)字節(jié)。1)返回值：開(kāi)關(guān)型。輸入的字節(jié)。1，開(kāi)關(guān)型，端口號(hào)。!InpW(320)。1)返回值：開(kāi)關(guān)型。輸入的字節(jié)。1，開(kāi)關(guān)型，端口號(hào)。!InpD(320)。320輸入的四個(gè)字節(jié)。!WriteM