【文章內容簡介】 athName,dataType,copyState)函數意義: 拷貝當前運行工程的數據到指定的目錄pathName中。返 回 值:1：在拷貝的過程中,數據對象copyState,。0：表示拷貝成功。1：當前工程中,當前運行工程中沒有組對象要存盤。2：創(chuàng)建目錄pathName失敗。 3：。4：參數dataType的值,不正確,目前只支持值為0。5：磁盤空間不足。6：參數copyState不是數據對象類型。7：參數copyState是數據對象類型,但不是開關型數據對象。8：參數copyState在一開始調用此腳本時,就為非0。參數說明:pathName：:在模擬環(huán)境可以寫d:\test,在運行環(huán)境可寫harddisk\test。dataType：,0表示歷史數據,報警數據還沒有處理。copyState：,為非0表示取消當前的拷貝?！?例：!CopyDateFileToDisk(harddisk\test,0,copyState) 把當前工程中歷史數據拷貝到目錄harddisk\test中(如copyState為0表示拷貝,為非表示取消)。說 明：,通過U盤或其他方式,導到上位機(PC),。用戶登錄操作函數!ChangePassword()函數意義：彈出密碼修改窗口，供當前登錄的用戶修改密碼。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：無。實 例：!ChangePassword()。!CheckUserGroup(strUserGroup)函數意義：檢查當前登錄的用戶是否屬于strUserGroup用戶組的成員。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：strUserGroup，字符型，用戶組的名稱。實 例：!CheckUserGroup(管理員組)。!Editusers()函數意義：彈出用戶管理窗口，供管理員組的操作者配置用戶。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：無。實 例：!Editusers()。!EnableExitLogon(n)函數意義：打開/關閉退出時的權限檢查。返 回 值：數值型。返回值=1：操作成功；返回值=0：操作失敗。參 數：n，數值型，為1時表示在退出時進行權限檢查，當權限不足時，會進行提示。為0則退出時不進行權限檢查。實 例：!EnableExitLogon(1)， 在退出時進行權限檢查。!EnableExitPrompt(n)函數意義：打開/關閉退出時的提示信息。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：n，數值型，為1時表示在退出時彈出提示信息對話框。為0則退出時不出現信息對話框。實 例：!EnableExitPrompt(1)， 在退出時彈出提示信息對話框。!GetCurrentGroup()函數意義：讀取當前登錄用戶的所在用戶組名。返 回 值：字符型，當前登錄用戶組名，如沒有登錄返回空。參 數：無。實 例：!GetCurrentGroup()。!GetCurrentUser()函數意義：讀取當前登錄用戶的用戶名。返 回 值：字符型，當前登錄用戶的用戶名，如沒有登錄返回空。參 數：無。實 例：!GetCurrentUser()。!LogOff()函數意義：注銷當前用戶。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：無。實 例：!LogOff()。!LogOn()函數意義：彈出登錄對話框。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：無。實 例：!LogOn()。字符串操作函數!Ascii2I(s)函數意義：返回字符串s的首字母的Ascii值。返 回 值：開關型。參 數：s， 字符型。實 例：!Ascii2I(Afd)=65。!Bin2I(s)函數意義：把二進制字符串轉換為數值。返 回 值：開關型。參 數：s， 字符型。實 例：!Bin2I(101)=5。!Format(n,str)函數意義：格式化數值型數據對象。返 回 值：字符型。參 數：n，數值型，要格式化的數值；str，字符型，格式化數值的格式。小數點后的0的個數表示需要格式化出的小數位數。小數點前的0為一個時，表示小數點前根據 實際數值顯示。當小數點前沒有0時，當小數點前的0不止一個時，使用0來填充不夠的位數。實 例：!Format(,) = ；!Format(,.00)= .24；!Format(,) = 。!Hex2I(s)函數意義：把16進制字符串轉換為數值。返 回 值：開關型。參 數：s， 字符型。實 例：!Hex2I(11) =17。!I2Ascii(s)函數意義：返回指定Ascii值的字符。返 回 值：字符型。參 數：s， 開關型。實 例：!I2Ascii(65) =“A”。!I2Bin(s)函數意義：把數值轉換為二進制字符串。返 回 值：字符型。參 數：s，開關型。實 例：!I2Bin(5) =“101”!I2Hex(s)函數意義：把數值轉換為16進制字符串。返 回 值：字符型。參 數：s，開關型。實 例：!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(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)函數意義：將字符串轉化為長數值型數值返 回 值：開關型，轉換出的數值。參 數：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)函數意義：從字符型數據對象str右邊起，取n個字符。返 回 值：字符型。參 數：str，字符型，源字符串；n，數值型，取字符個數。實 例：!Right(ABCDEFG,2) =FG。!Rtrim(str)函數意義：把字符型數據對象str中最右邊的空格剔除。返 回 值：字符型。參 數：str， 字符型。實 例：!Rtrim( dsfk ) = dsfk。!Str(x)函數意義：將數值型數據對象x的值轉換成字符串。返 回 值：字符型。參 數：x， 數值型。實 例：!Str() =。!StrComp(str1,str2)函數意義：比較字符型數據對象str1和str2是否相等，返回值為0時相等，否則不相等。不區(qū)分大小寫字母。返 回 值：數值型。參 數：str1， 字符型；str2， 字符型。實 例：!StrComp(ABC,abc) = 0。!StrFormat(FormatStr,任意個數變量)函數意義：格式化字符串，可以格式化任意多個數值。使用方法為!StrFormat(%d,23)，或!StrFormat(%g%g%g,)等，類似C語言中的 Printf的語法。返 回 值：字符型。參 數：FormatStr， 字符型，格式化字符串。后面的參數可以任意多個。實 例：!StrFormat(%g%g,12,)= 。!Trim(str)函數意義：把字符型數據對象str中左右兩端的空格剔除。返 回 值：字符型。參 數：str， 字符型。實 例：!Trim( dsfk ) =dsfk。!Ucase(str)函數意義：把字符型數據對象str的所有字符轉換成大寫。返 回 值：字符型。參 數：str， 字符型。實 例：!UCase(sedERT) =SEDERT。!Val(str)函數意義：把字符型數據對象str的值轉換成數值。返 回 值：數值型。參 數：str， 字符型。實 例：!Val() = 。定時器操作函數可用的系統(tǒng)定時器范圍為1到127，即系統(tǒng)內嵌127個系統(tǒng)定時器。用戶可以隨意使用其中的任意一個。定時器返回時間值為數值型，單位為秒,分，時，但是小數位最多可以表示到毫秒。因為采用浮點數表示，隨著數值增大會略有誤差。!TimerClearOutput(定時器號)函數意義: 清除定時器的數據輸出連接。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：定時器號。實 例：!TimerClearOutput(1)，清除1號定時器的數據輸出連接。!TimerRun(定時器號)函數意義：啟動定時器開始工作。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：定時器號。實 例：!TimerRun(1)，啟動1號定時器工作。!TimerStop(定時器號)函數意義：停止定時器工作。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：定時器號。實 例：!TimerStop(1)，停止1號定時器工作。!TimerSkip(定時器號,步長值)函數意義：在計時器當前時間數上加/減指定值。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：定時器號；步長值。實 例：!TimerSkip(1,3)，1號定時器當前值+3。!TimerReset(定時器號,數值)函數意義：設置定時器的當前值，由第二個參數設定，第二個參數可以是MCGS嵌入版變量。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。 參 數：定時器號；數值。實 例：!TimerReset(1,12)，設置1號定時器的值為12。!TimerValue(定時器號,0)函數意義：取定時器的當前值。返 回 值：將定時器的值以數值型的方式輸出（數值格式）。參 數：定時器號。實 例：Data3=!TimerValue(1,0)，取定時器1的值給Data3。!TimerStr(定時器號,1)函數意義：以字符串的形式返回當前定時器的值。返回 值：字符型變量， 將定時器的值以字符型的方式輸出（時間格式）。參 數：定時器號。實 例：Time=!TimerStr(1,1)，取定時器的值以“00：00：00”形式輸出給Time。!TimerState(定時器號)函數意義：取定時器的工作狀態(tài)。返 回 值：數值型變量，0 定時器停止，1 定時器運行。參 數：定時器號。實 例：data1=!TimerState(1)，取定時器1的工作狀態(tài)給data1。 !TimerSetLimit(定時器號,上限值,參數3)函數意義：設置定時器的最大值，即設置定時器的上限。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：定時器號(1255)；上限值；第三個參數，1 表示運行到60后停止；0 表示運行到60后重新循環(huán)運行。實 例：!TimerSetLimit(1,60,1)，設置1號定時器的上限為60，運行到60后停止。!TimerSetOutput(定時器號,變量)函數意義：設置定時器的值輸出連接的變量。返 回 值：數值型。返回值=0：調用成功；0：調用失敗。參 數：定時器號；變量，定時器的值輸出連接的變量。實 例：!TimerSetOutput(1,Data0)，將定時器數據連接到Data0。!TimerWaitFor(定時器號,數值)函數意義：等待定時器工作到“數值”指定的值后，腳本程序才向下執(zhí)行