組態(tài)王常用命令語(yǔ)言函數(shù)速查手冊(cè)

10組態(tài)王命令語(yǔ)言函數(shù)手冊(cè)“組態(tài)王”支持使用內(nèi)建的簡(jiǎn)單函數(shù)，其中包括字符串函數(shù)、數(shù)學(xué)函數(shù)、系統(tǒng)函數(shù)、控件函數(shù)、報(bào)表函數(shù)及其他函數(shù)，下面依次介紹各個(gè)函數(shù)〔函數(shù)名不區(qū)分大小寫(xiě)，按字母排序：Abs此函數(shù)用于計(jì)算變量值確實(shí)定值，使用格式如下：Abs(變量名或數(shù)值);返回值：整值或?qū)嵭椭?；例如：Abs(14);返回值為14Abs(-7.5);返回值為7.5Abs(距離);返回內(nèi)存模擬變量“距離”確實(shí)定值。Ack對(duì)變量進(jìn)展報(bào)警確認(rèn)，或?qū)?bào)警組進(jìn)展報(bào)警確認(rèn)。假設(shè)函數(shù)參數(shù)為變量名稱(chēng)，則只對(duì)該變量進(jìn)展報(bào)警確認(rèn)；假設(shè)函數(shù)參數(shù)為報(bào)警組名稱(chēng)，則確認(rèn)全部屬于該報(bào)警組及其子報(bào)警組的變量。該函數(shù)的參數(shù)只能是變量名或報(bào)警組名，不行以為字符串變量。此函數(shù)常用于按鈕命令語(yǔ)言，當(dāng)發(fā)生報(bào)警時(shí)，用此函數(shù)進(jìn)展報(bào)警確認(rèn)，它將產(chǎn)生確認(rèn)報(bào)警大事。調(diào)用格式：Ack(報(bào)警組名)；或Ack(變量名)；例如：Ack(全廠)；或Ack(反響罐液位)；ActivateApp 用程序此函數(shù)用于激活正在運(yùn)行的窗口應(yīng)用程序，使之變?yōu)楫?dāng)前窗口。獲得輸入焦點(diǎn)。該函數(shù)也可協(xié)作函數(shù)SendKeys的使用。調(diào)用形式：ActivateApp(“ExeName”)；參數(shù)：ExeName應(yīng)用程序的執(zhí)行文件名例如：激活MicrosoftWord的正確調(diào)用為：ActivateApp(“Word.exe“)；ArcCos arc[ɑk]adj.圓弧的；反三角函數(shù)的此函數(shù)用于計(jì)算變量值的反余弦值,變量值的取值范圍在[-1，1]值無(wú)效。調(diào)用格式：ArcCos(變量名或數(shù)值);返回值：整值或?qū)嵭椭?；例如：ArcCos(1);此函數(shù)返回值為0ArcCos(temp);此函數(shù)返回變量“temp”的反余弦值。[”?v()r?d?]n.平均；平均數(shù)；adj.vt.算出…的平均數(shù)；將…平均安排；使…平衡此函數(shù)為對(duì)指定的組態(tài)王報(bào)表表格的多個(gè)單元格求平均值，或求多個(gè)變量的平均值。語(yǔ)法格式使用如下：Average〔’a1’,’a2’〕;或Average(”a1:a10”);a1、a2……為組態(tài)王單元格所在的行號(hào)列標(biāo)，或整型或?qū)嵭妥兞?。其中參?shù)個(gè)數(shù)為1-32個(gè)。當(dāng)對(duì)報(bào)表的指定單元格區(qū)域內(nèi)的單元格進(jìn)展求平均值運(yùn)算時(shí)，結(jié)果顯示在當(dāng)前單元格Average〔’a1’,‘a(chǎn)2‘〕;例如：任意單元格選擇求平均值:=Average〔‘a(chǎn)1’,‘b2’,‘r10’〕;連續(xù)的單元格求平均值:=Average(‘b1:b10’AverageValue=Average(lVar1,fVar1);BackUpHistData history[h?st]hist-歷史此函數(shù)為組態(tài)王網(wǎng)絡(luò)中從IO效勞器上下載歷史數(shù)據(jù)記錄到歷史記錄效勞器。用戶(hù)在歷史記錄效勞器上調(diào)用該函數(shù)。函數(shù)的使用需要與組態(tài)王網(wǎng)絡(luò)配置相協(xié)作，具體內(nèi)容參見(jiàn)《組態(tài)王6.53使用手冊(cè)》中“歷史庫(kù)”一章。語(yǔ)法使用格式：BackupStationData(StrchMchinename,LongftEndtime);參數(shù)：chMchinename字符串型為進(jìn)展備份存儲(chǔ)的IO效勞器名ftEndtime整型為備份截止時(shí)間例如：//備份“IO采集站”的歷史數(shù)據(jù)，截至?xí)r間為當(dāng)前：endTime=HTConvertTime($年,$月,$日,$時(shí),$分,0);BackUpHistData(“IO采集站“,endTime);Bit此函數(shù)用以取得一個(gè)整型或?qū)嵭妥兞磕骋晃坏闹?0或1)。用法：OnOff=Bit(Var,bitNo);//OnOff:離散變量參數(shù)：Var:整型或?qū)嵭妥兞縝itNo116VabitN0為0；假設(shè)變量Var的第bitNo位為1，返回值OnOff為1。例如：開(kāi)關(guān)=Bit(DDE1,6);從變量DDE1的第6位得到變量“開(kāi)關(guān)”狀態(tài)。BitSet此函數(shù)將一個(gè)整型或?qū)嵭妥兞康娜我晃恢脼橹付ㄖ?0或1)。語(yǔ)法格式：BitSet(Var,bitNo,OnOff);Var:整型或?qū)嵭妥兞縝itNo:位的序號(hào)，取值1至16OnOff:位的設(shè)定值留意：對(duì)于IO變量來(lái)說(shuō)，BitSet函數(shù)只是用于可讀可寫(xiě)的變量。例如：BitSet(DDE1,6,0);將變量DDE1的第6位置為0。ChangePassword password[”?sd]n.密碼；口令此函數(shù)顯示“更改口令”對(duì)話框，允許登錄工程人員更改他們的口令。使用格式：ChangePassword;例如：為畫(huà)面上某一按鈕設(shè)置命令語(yǔ)言連接：ChangePassword();運(yùn)行時(shí)單擊此按鈕，彈出對(duì)話框：提示工程人員輸入當(dāng)前的口令和口令以及驗(yàn)證口令。完全正確后，工程人員的口令設(shè)置為值。ClosePicture此函數(shù)用于將已調(diào)入內(nèi)存的畫(huà)面關(guān)閉，并從內(nèi)存中刪除。語(yǔ)法格式如下：ClosePicture(“畫(huà)面名“);例如：ClosePicture(“反響車(chē)間“);將關(guān)閉畫(huà)面“反響車(chē)間”。ConfigODBC此函數(shù)用于配置odbc的數(shù)據(jù)源，語(yǔ)法格式如下：ConfigODBC(nDatatbasetype,szAttributes);參數(shù)：nDatatbasetypeAccess，SQLserver該參數(shù)為0時(shí)表示數(shù)據(jù)庫(kù)類(lèi)型為Access，參數(shù)為1時(shí)表示數(shù)據(jù)庫(kù)類(lèi)型為SQLserver；szAttributes：配置字符串:例1：配置Access數(shù)據(jù)庫(kù)，DSN名稱(chēng)為demo2，數(shù)據(jù)庫(kù)文件為E:\ProgramFiles\Kingview\Example\Kingdemo1\數(shù)據(jù)庫(kù).mdb。ConfigODBC(0,“DSN=demo2\0Description=E:\ProgramFiles\Kingview\Example\Kingdemo1\數(shù)據(jù)庫(kù).mdb\0PWD=1234\0UID=shihf“);例2：配置SQL數(shù)據(jù)庫(kù)：ConfigODBC(1,“DSN=MyDSN\0Description=SQLConfigDSNSample\0SERVER=MySQL\0ADDRESS=MyServer\0NETWORK=dbmssocn\0DATABASE=pubs\0“);Date此函數(shù)為依據(jù)給出的年、月、日整型數(shù)，返回日期字符串，默認(rèn)格式為：年：月：日。語(yǔ)法使用格式如下：Date〔LONGnYear,LONGnMonth,LONGnDay〕;例如：年、月、日變量分別為：“$年”、“$月”、“$日”，用日期來(lái)顯示由以上三個(gè)整數(shù)打算的“日期”=Date〔年,月,日〕;DisplayMCI此函數(shù)供給了一個(gè)對(duì)多媒體設(shè)備的通用接口，具有強(qiáng)大的功能。語(yǔ)法使用格式：DisplayMCI(“MCICommand“,option);下面舉例說(shuō)明此函數(shù)的使用方法。例如：DisplayMCI(“PLAYCD”,3);用于播放CD唱片中的第3支歌曲。DisplayMCI(“STOPCD”,””);用于停頓播放CD。DisplayMCI(“PLAYMIDI”,”c:\midi.mid”);用于播放MIDI格式的背景音樂(lè)”c:\midi.mid”。DisplayMCI(“PAUSEMIDI”,”c:\midi.mid”);暫停播放MIDI格式的背景音樂(lè)”c:\midi.mid”。DisplayMCI(“RESUMMIDI”,”c:\midi.mid”);連續(xù)播放MIDI格式的背景音樂(lè)”c:\midi.mid”。DisplayMCI(“CLOSEMIDI”,”c:\midi.mid”);停頓播放MIDI格式的背景音樂(lè)”c:\midi.mid”。DisplayMCI(“EJECTCD”);將光驅(qū)中的CD盤(pán)片彈出。Dtext此函數(shù)用于按離散變量的值動(dòng)態(tài)地轉(zhuǎn)變字符串變量。語(yǔ)法格式如下：Str=Dtext(Discrete_Tag,OnMsg,OffMsg參描述數(shù)Discrete_Tag 離散變量名。OnMsg 字符串變量名OffMsg 字符串變量名當(dāng)Discrete_Tag＝1時(shí)，Str的值為OnMsg當(dāng)Discrete_Tag＝0時(shí)，Str的值為OffMsg例如：Str=Dtext(電源開(kāi)關(guān)，“電源翻開(kāi)“,“電源關(guān)閉“);當(dāng)電源開(kāi)關(guān)＝1時(shí)，Str的值為“電源翻開(kāi)當(dāng)電源開(kāi)關(guān)＝0時(shí)，Str的值為“電源關(guān)閉“?！癊nableAllAlarm全局報(bào)警使能函數(shù)。調(diào)用形式：EnableAllAlarm(is_enable);參數(shù)描述：is_enable整數(shù)變量或數(shù)值0--制止全部報(bào)警非0--使能全部報(bào)警返回值：整數(shù)型，反映當(dāng)前全局報(bào)警使能的狀態(tài)：假設(shè)為非0：使能；為0：制止EnableNavigate此函數(shù)用于顯示/關(guān)閉導(dǎo)航圖。調(diào)用形式：EnableNavigate(is_enable);參數(shù)：is_enable，整型。0:is_enable為0時(shí)，關(guān)閉導(dǎo)航圖1:is_enable為1時(shí)，顯示導(dǎo)航圖。使用EnableNavigate函數(shù)關(guān)閉導(dǎo)航圖后，除非使用該函數(shù)來(lái)顯示導(dǎo)航圖，否則無(wú)法顯示導(dǎo)航圖。例如：EnableNavigate(0);//關(guān)閉導(dǎo)航圖EnableSaveTagValueToIniValueWhenValueChange對(duì)于設(shè)置了“保存數(shù)值”和“保存參數(shù)”的變量，使用該函數(shù)后，當(dāng)變量的值和參數(shù)發(fā)生變化時(shí)，系統(tǒng)會(huì)自動(dòng)將變量的值和參數(shù)保存到文件tagname.db中，無(wú)論組態(tài)王運(yùn)行系統(tǒng)是否正常退出，再次運(yùn)行后，將保存的變量值和變量參數(shù)作為變量的初始值和初始參數(shù)?！氨４鏀?shù)值”和“保存參數(shù)”的具體含義請(qǐng)參見(jiàn)《組態(tài)王手冊(cè)》第七章變量定義和調(diào)用形式：EnableSaveTagValueToIniValueWhenValueChange(is_enable);參數(shù)：is_enable：整型變量或數(shù)值1：后，將保存的變量值和變量參數(shù)作為變量的初始值和初始參數(shù)。0：與組態(tài)王“保存數(shù)值”和“保存參數(shù)”實(shí)現(xiàn)的功能一樣。例如：組態(tài)王開(kāi)發(fā)系統(tǒng)數(shù)據(jù)詞典中定義變量，設(shè)置“保存數(shù)值”。執(zhí)行函數(shù)：EnableSaveTagValueToIniValueWhenValueChange(1);該變量的值發(fā)生變化時(shí)，系統(tǒng)保存該變量的值。組態(tài)王運(yùn)行系統(tǒng)退出，再次運(yùn)行后，將保存的變量值作為變量的初始值。Exit此函數(shù)使組態(tài)王運(yùn)行環(huán)境退出。調(diào)用形式：Exit(Option);參數(shù)：Option:整型變量或數(shù)值0-退出當(dāng)前程序；1-關(guān)機(jī)；2-重啟動(dòng)windows；Exp此函數(shù)返回指數(shù)函數(shù)ex的計(jì)算結(jié)果使用格式如下：Exp(數(shù)值或變量名);Exp(1);返回e1的計(jì)算值2.718Exp(temp);計(jì)算e常量的temp次冪并返回計(jì)算結(jié)果。GetAlarmNumInGroup此函數(shù)用來(lái)對(duì)某一個(gè)報(bào)警組當(dāng)前的報(bào)警變量數(shù)量進(jìn)展統(tǒng)計(jì)語(yǔ)法格式：longGetAlarmNumInGroup(“MachineName“,“GroupName“);參數(shù)說(shuō)明：MachineName：報(bào)警組所在的站點(diǎn)名稱(chēng)(對(duì)于單機(jī)網(wǎng)絡(luò)，使用時(shí)用空字符串代替)GroupName：要獵取報(bào)警變量個(gè)數(shù)的報(bào)警組名返回值：整型，返回值表示報(bào)警變量數(shù)“本機(jī)為報(bào)警效勞器”鉤上，才能正確獵取到遠(yuǎn)程節(jié)點(diǎn)的報(bào)警變量個(gè)數(shù)。GetBackupProgress此函數(shù)用于在組態(tài)王進(jìn)展網(wǎng)絡(luò)歷史數(shù)據(jù)備份合并時(shí)獲得進(jìn)度百分比。使用時(shí)需要通過(guò)命令語(yǔ)言調(diào)用來(lái)獲得進(jìn)度值。語(yǔ)法使用格式：GetBackupProgress(strszStationName);參數(shù)：szStationName遠(yuǎn)程站點(diǎn)名稱(chēng)。返回值：整型，為0~100間的進(jìn)度值。例如：備份進(jìn)度=GetBackupProgress(“IO采集站”);GetCursorPosX此函數(shù)返回當(dāng)前鼠標(biāo)的X坐標(biāo)。調(diào)用格式：result=GetCursorPosX;返回值為整型。GetCursorPosY此函數(shù)返回當(dāng)前鼠標(biāo)的Y坐標(biāo)。調(diào)用格式：result=GetCursorPosY;返回值為整型。GetDatelocal此函數(shù)將以秒為單位的長(zhǎng)整型數(shù)轉(zhuǎn)換為相應(yīng)的日期數(shù)值，分別以年、月、日的日期數(shù)UTC(格林尼治)時(shí)間1970年1月1日00:00:00輸出的日期為本地日期。語(yǔ)法使用格式GetDatelocal(DateTime,Year,Month,Day);參數(shù)描述DateTime：需要進(jìn)展日期轉(zhuǎn)換的數(shù)，整型，為輸入?yún)?shù)Year：年，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)Month：月，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)Day：日，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參HTConvertTime函數(shù)將自UTC(格林尼治)時(shí)間1970年1月1日00:00:00到北京時(shí)間2006年9月26日9:22:4轉(zhuǎn)換為以秒為單位的長(zhǎng)整數(shù)數(shù)值為1159233724，使用GetDatelocal函數(shù)可以從這個(gè)數(shù)值中分別出所表示的北京日期——年、月、日。GetDatelocal(1159233724,年,月,日);“年”的值為2006，“月”的值為9，“日”的值為26。數(shù)可以從這個(gè)數(shù)值中分別出所表示的日期——年、月、日。函數(shù)GetDate(1060301289,年,月,日);執(zhí)行后，得到的“年”的值為2003，“月”的值為8，“日”的值為8。獲得其中時(shí)間的函數(shù)為GetTime。GetGroupName此函數(shù)為通過(guò)報(bào)警組ID號(hào)獲得報(bào)警組名稱(chēng)。在組態(tài)王中，每個(gè)報(bào)警組除了名稱(chēng)外，還有ID號(hào)。組態(tài)王的變量域“.Group”顯示的是變量所屬報(bào)警組的ID號(hào)，假設(shè)要獲得相應(yīng)的報(bào)警組名稱(chēng)，就需要使用該函數(shù)。語(yǔ)法使用格式:sGroupName=GetGroupName(StationName,GroupID);參數(shù)描述StationName：報(bào)警組所在的站點(diǎn)名稱(chēng)〔該項(xiàng)臨時(shí)無(wú)效，使用時(shí)用空字符串代替〕GroupID：要獵取名稱(chēng)的報(bào)警組的ID號(hào)返回值為字符串型。例如：GroupName=GetGroupName(“”,\\本站點(diǎn)\原料罐液位.Group);GetHistMaxData此函數(shù)用來(lái)獵取某段時(shí)間中歷史數(shù)據(jù)的最大值語(yǔ)法使用格式：RealResult=GetHistMaxData(TagName,StartTime,EndTime);參數(shù)描述：TagName：所要查詢(xún)的變量的名稱(chēng)，類(lèi)型為字符串型，即帶引號(hào)。StartTime：數(shù)據(jù)查詢(xún)的開(kāi)頭時(shí)間，該時(shí)間是通過(guò)組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長(zhǎng)整型數(shù)，所以用戶(hù)在使用本函數(shù)之前，應(yīng)先將查詢(xún)起始時(shí)間轉(zhuǎn)換為長(zhǎng)整型數(shù)值。EndTime:數(shù)據(jù)查詢(xún)的完畢時(shí)間，類(lèi)型同StartTime。返回值：返回一個(gè)實(shí)數(shù)值。GetHistMinData此函數(shù)用來(lái)獵取某段時(shí)間中歷史數(shù)據(jù)的最小值語(yǔ)法使用格式：RealResult=GetHistMinData(TagName,StartTime,EndTime);參數(shù)描述：TagName：所要查詢(xún)的變量的名稱(chēng)，類(lèi)型為字符串型，即帶引號(hào)。StartTimeHTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長(zhǎng)整型數(shù)，所以用戶(hù)在使用本函數(shù)之前，應(yīng)先將查詢(xún)起始時(shí)間轉(zhuǎn)換為長(zhǎng)整型數(shù)值。EndTime:數(shù)據(jù)查詢(xún)的完畢時(shí)間，類(lèi)型同StartTime。返回值：返回一個(gè)實(shí)數(shù)值。GetHistAveData此函數(shù)用來(lái)獵取某段時(shí)間中歷史數(shù)據(jù)的平均值語(yǔ)法使用格式：RealResult=GetHistAveData(TagName,StartTime,EndTime);參數(shù)描述：TagName：所要查詢(xún)的變量的名稱(chēng)，類(lèi)型為字符串型，即帶引號(hào)。StartTime：數(shù)據(jù)查詢(xún)的開(kāi)頭時(shí)間，該時(shí)間是通過(guò)組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長(zhǎng)整型數(shù)，所以用戶(hù)在使用本函數(shù)之前，應(yīng)先將查詢(xún)起始時(shí)間轉(zhuǎn)換為長(zhǎng)整型數(shù)值。EndTimeStartTime。返回值：返回一個(gè)實(shí)數(shù)值。GetHistMaxTime此函數(shù)用來(lái)獵取某段時(shí)間中歷史數(shù)據(jù)的最大值對(duì)應(yīng)的時(shí)間語(yǔ)法使用格式：RealResult=GetHistMaxTime(TagName,StartTime,EndTime);參數(shù)描述：TagName：所要查詢(xún)的變量的名稱(chēng)，類(lèi)型為字符串型，即帶引號(hào)。StartTimeHTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00值。EndTime:數(shù)據(jù)查詢(xún)的完畢時(shí)間，類(lèi)型同StartTime。返回值：返回一個(gè)字符串，格式為2008/10/1011:11:11。GetHistMinTime此函數(shù)用來(lái)獵取某段時(shí)間中歷史數(shù)據(jù)的最小值對(duì)應(yīng)的時(shí)間語(yǔ)法使用格式：RealResult=GetHistMinTime(TagName,StartTime,EndTime);參數(shù)描述：TagName：所要查詢(xún)的變量的名稱(chēng)，類(lèi)型為字符串型，即帶引號(hào)。StartTime：數(shù)據(jù)查詢(xún)的開(kāi)頭時(shí)間，該時(shí)間是通過(guò)組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00數(shù)之前，應(yīng)先將查詢(xún)起始時(shí)間轉(zhuǎn)換為長(zhǎng)整型數(shù)值。EndTime:數(shù)據(jù)查詢(xún)的完畢時(shí)間，類(lèi)型同StartTime。返回值：返回一個(gè)字符串，格式為2008/10/1011:11:11。GetKey此函數(shù)為獲得組態(tài)王當(dāng)前使用的加密鎖的序列號(hào)。語(yǔ)法使用格式KeyID=GetKey;該函數(shù)沒(méi)有任何參數(shù)。返回值為字符串型。GetProjectPath此函數(shù)用于獵取當(dāng)前工程的路徑。語(yǔ)法使用格式:GetProjectPath;VarName：VarName=GetProjectPath;GetRealDBForBool此函數(shù)用于獵取變量的當(dāng)前實(shí)時(shí)離散值。語(yǔ)法使用格式:GetRealDBForBool(“VarName“);參數(shù)描述VarName：變量名稱(chēng)，字符串格式說(shuō)明：變量只能是離散量。返回值為離散型。例如：bb=GetRealDBForBool(“原料油出料閥“);GetRealDBForFloat此函數(shù)用于獵取變量的當(dāng)前實(shí)時(shí)模擬值。語(yǔ)法使用格式:GetRealDBForFloat(“VarName“);參數(shù)描述VarName：變量名稱(chēng)，字符串格式說(shuō)明：變量只能是實(shí)型變量。例如：ff=GetRealDBForFloat(“原料油液位“);GetRealDBForInt此函數(shù)用于獵取變量的當(dāng)前實(shí)時(shí)整型值。語(yǔ)法使用格式:GetRealDBForInt(“VarName“);參數(shù)描述VarName：變量名稱(chēng)，字符串格式說(shuō)明：變量只能是整型變量。例如：ii=GetRealDBForInt(“水果“);GetRealDBForString此函數(shù)用于獵取變量的當(dāng)前實(shí)時(shí)字符串型值。語(yǔ)法使用格式:GetRealDBForString(“VarName“);參數(shù)描述VarName：變量名稱(chēng)，字符串格式說(shuō)明：變量只能是字符串型變量。例如：ss=GetRealDBForString(“記錄日期“);GetStationStatus此函數(shù)用于在組態(tài)王進(jìn)展網(wǎng)絡(luò)歷史數(shù)據(jù)備份合并時(shí)獲得備份的狀態(tài)。使用時(shí)需要通過(guò)命令語(yǔ)言調(diào)用來(lái)獲得狀態(tài)值。語(yǔ)法使用格式：BOOLGetStationStatus(strszStationName);參數(shù)：szStationName遠(yuǎn)程站點(diǎn)名稱(chēng)。返回值：離散型，>0正在備份數(shù)據(jù)=0空閑。例如：備份狀態(tài)=GetStationStatus(“IO采集站”);GetTime此函數(shù)將以秒為單位的長(zhǎng)整型數(shù)轉(zhuǎn)換為相應(yīng)的時(shí)間數(shù)值，分別以時(shí)、分、秒等的時(shí)間UTC(格林尼治)時(shí)間1970年1月1日00:00:00成輸出的時(shí)間也為UTC(格林尼治)時(shí)間。語(yǔ)法使用格式:GetTime(DateTime,Hour,Minute,Second);參數(shù)描述DateTime：需要進(jìn)展時(shí)間轉(zhuǎn)換的數(shù)，整型，為輸入?yún)?shù)Hour：時(shí)，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)Minute：分，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)Second：秒，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)例如：自UTC(格林尼治)時(shí)間1970年1月1日00:00:00到2003年8月8日0:8:9的秒的數(shù)值為106030128GetTime秒。函數(shù)GetTime106030128,時(shí)分秒);時(shí)0分”8”的值為9。獲得其中日期的函數(shù)為GetDate。GetTimelocal此函數(shù)將以秒為單位的長(zhǎng)整型數(shù)轉(zhuǎn)換為相應(yīng)的時(shí)間數(shù)值，分別以本地的時(shí)、分、秒的UTC(格林尼治)時(shí)間1970年1月1日00:00:00換完成輸出的時(shí)間為本地時(shí)間。語(yǔ)法使用格式:GetTimelocal(DateTime,Hour,Minute,Second);參數(shù)描述DateTime：需要進(jìn)展時(shí)間轉(zhuǎn)換的數(shù)，整型，為輸入?yún)?shù)Hour：時(shí)，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)Minute：分，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)Second：秒，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù)例如：使用HTConvertTime函數(shù)將自UTC(格林尼治)時(shí)間1970年1月1日00:00:00到北京時(shí)間2006年9月26日9:22:4轉(zhuǎn)換為以秒為單位的長(zhǎng)整數(shù)數(shù)值為1159233724，使用GetTimelocal函數(shù)可以從這個(gè)數(shù)值中分別出所表示的北京時(shí)間——時(shí)、分、秒。GetTimelocal(1159233724,時(shí),分,秒);執(zhí)行后，得到的“時(shí)”的值為9，“分”的值為22，“秒”的值為4。HidePicture此函數(shù)用于隱蔽正在顯示的畫(huà)面，但并不將其從內(nèi)存中刪除。調(diào)用格式：HidePicture(“畫(huà)面名“)；參數(shù)：畫(huà)面名稱(chēng)字符串型例如：HidePicture(“反響車(chē)間“)；HTConvertTime此函數(shù)將指定的時(shí)間格式〔年，月，日，時(shí)，分，秒〕轉(zhuǎn)換為以秒為單位的長(zhǎng)整型數(shù)，轉(zhuǎn)換的時(shí)間基準(zhǔn)是UTC(格林尼治)1970年1月1日00:00:00換的時(shí)間基準(zhǔn)為1970年1月1日8:00:00。語(yǔ)法使用格式:HTConvertTime(Year,Month,Day,Hour,Minute,Second);參數(shù)描述Year：年，整型，此值必需介于1970和2019之間Month：月，整型，此值必需介于1和12之間Day：日，整型，此值必需介于1和31之間Hour：小時(shí)，整型，此值必需介于0和23之間Minute：分鐘，整型，此值必需介于0和59之間Second：秒，整型，此值必需介于0和59之間返回值：整型1970年1月1日00:00:00即UCT的最大范圍，如2×109，否則可能會(huì)由于返回?cái)?shù)據(jù)超出范圍導(dǎo)致轉(zhuǎn)換的時(shí)間不正確。例如：語(yǔ)句HTConvertTime(1970,1,1,9,0,0)執(zhí)行后返回長(zhǎng)整型數(shù)為3600;HTGetPenRealValue此函數(shù)用于獵取指定歷史趨勢(shì)曲線中的趨勢(shì)筆所對(duì)應(yīng)的實(shí)際值。調(diào)用格式：HTGetPenRealValue(HistroyName,PenNum,ContentString);參數(shù)說(shuō)明HistroyName指在“歷史趨勢(shì)曲線”對(duì)話框中定義的歷史趨勢(shì)曲線名稱(chēng)PenNum與歷史趨勢(shì)曲線中的一個(gè)變量相對(duì)應(yīng)的趨勢(shì)筆的索引號(hào)ContentString“start”表示獵取與歷史趨勢(shì)曲線的域ValueStart相對(duì)應(yīng)的實(shí)際值，ValueStart是用工程百分比來(lái)表示變量的下限值，start則表示將下限值的工程百分比轉(zhuǎn)換為實(shí)際值。“end”表示獵取與歷史趨勢(shì)曲線的域ValueEnd相對(duì)應(yīng)的實(shí)際值，ValueEnd是用工程百分比來(lái)表示變量的上限值，end則表示將上限值的工程百分比轉(zhuǎn)換為實(shí)際值。例如:設(shè)有一溫度歷史曲線，其最大上限值為500，最小下限值為0，假設(shè)用ValueStart和ValueEnd輸出顯示，則顯示的數(shù)據(jù)是溫度值的工程百分比，如ValueEnd的輸出為50，表示百分比是50%，假設(shè)使用函數(shù)語(yǔ)句HTGetPenRealValue(histroy,1,“end”)；則函數(shù)返回工程百分比50%對(duì)應(yīng)的實(shí)際值500*50%=250，其中history為歷史趨勢(shì)曲線名，1表示對(duì)應(yīng)溫度的趨勢(shì)筆。HTScrollRight此函數(shù)將趨勢(shì)曲線的起始時(shí)間右移給定的百分比值。百分比是相對(duì)于趨勢(shì)曲線的時(shí)間軸長(zhǎng)度。移動(dòng)后時(shí)間軸的長(zhǎng)度保持不變。調(diào)用格式：HTScrollRight(HistoryName,Percent);HistoryName歷史趨勢(shì)變量，代表趨勢(shì)名。Percent實(shí)數(shù)，代表圖表要滾動(dòng)的百分比(0.0到100.0)。例如：將趨勢(shì)曲線Trend1的間軸范圍向右滾動(dòng)20%。調(diào)用函數(shù):HTScrollRight(Trend1,20.0);假設(shè)當(dāng)前顯示起始于下午12:00:00，而且顯示寬度為60秒，則的趨勢(shì)將起始于下午12:00:12(在函數(shù)執(zhí)行后)。InfoAppDir info?nf?dir[,di?”ɑr]名目〔directory；方向〔direction；用法〔direction；指示〔direct〕此函數(shù)返回當(dāng)前組態(tài)王的工程路徑。調(diào)用格式：MessageResult=InfoAppDir;當(dāng)前組態(tài)王工程路徑返回給MessageResult.例如：DemoPath=InfoAppDir;將返回“C:\ProgramFiles\Kingview\Example\Kingdemo3“。InfoAppTitle title[”ta?t()l]n.冠軍；標(biāo)題；頭銜；權(quán)利；字幕此函數(shù)返回應(yīng)用程序的標(biāo)題或者一個(gè)當(dāng)前正在運(yùn)行的指定程序的Windows任務(wù)列表名。調(diào)用格式：MessageResult=InfoAppTitle(ProgramEXEName);返回值：字符型值；ProgramEXEName應(yīng)用程序的執(zhí)行文件名。例如：InfoAppTitle;(“calc.exe“);//將返回“Calculator“InfoAppTitle;(“excel.exe“);//將返回“MicrosoftExcel“InfoDisk此函數(shù)返回指定的本地(或網(wǎng)絡(luò))磁盤(pán)驅(qū)動(dòng)器信息。調(diào)用格式：IntegerResult=InfoDisk(Drive,InfoType,Trigger);參數(shù)描述Drive代表驅(qū)動(dòng)器號(hào)的字符串或字符串變量。假設(shè)供給的字符串變量包含多于一個(gè)的字符，則只使用此變量的首字符。InfoType代表信息類(lèi)型的整數(shù)，可為以下兩個(gè)值之一：1返回磁盤(pán)驅(qū)動(dòng)器的總空間數(shù)(以字節(jié)計(jì))。2返回磁盤(pán)驅(qū)動(dòng)器上可用的空閑空間數(shù)(以字節(jié)計(jì))。Trigger每當(dāng)TriggerInfoDiskTrigger可為任何變量名(不受系統(tǒng)變量的限制)。由驅(qū)動(dòng)器號(hào)指定的磁盤(pán)驅(qū)動(dòng)器的有關(guān)信息返回給IntegerResult。例如：下面的語(yǔ)句每分鐘執(zhí)行一次并返回當(dāng)前的值：InfoDisk(“C“,1,$分);//將返回C盤(pán)總空間數(shù)InfoDisk(“C“,2,$分);//將返回C盤(pán)空閑空間數(shù)InfoFile此函數(shù)返回指定文件或子名目的有關(guān)信息。調(diào)用格式：IntegerResult=InfoFile(Filename,InfoType,Trigger);Filename代表要處理的文件名的字符串。InfoType代表要獵取的信息的類(lèi)型的整數(shù)，可為以下值之一：查找文件是否存在。假設(shè)文件名是一個(gè)實(shí)際文件，返回1。假設(shè)找不到文件則返回0。文件大小〔字節(jié)數(shù)〕。文件日期/時(shí)間〔自1970年1月1日起的相對(duì)秒數(shù)〕與文件名描述相匹配的文件數(shù)。僅當(dāng)使用通配符查找并找到多個(gè)匹配的文件時(shí)，返回值大于1TriggerTrigger的值轉(zhuǎn)變時(shí)，將執(zhí)行InfoFile函數(shù)。由文件名指定的文件的有關(guān)信息返回給IntegerResult徑，可包含通配符(*，?)。例如：下面的語(yǔ)句每分鐘執(zhí)行一次并返回以下值：InfoFile(“c:\kingview\touchvew.exe“,1,$分);將返回1，{文件找到}InfoFile(“c:\kingview\touchvew.exe“,2,$分);將返回634960，{文件大小}InfoFile(“c:\kingview\touchvew.exe“,3,$分);將返回736701852，{自70年1月1日起的秒數(shù)}InfoFile(“c:\kingview\*.exe“,4,$分);將返回4，{找到4個(gè)可執(zhí)行文件}。InfoResource此函數(shù)返回各種系統(tǒng)資源值。調(diào)用格式：IntegerResult=InfoResource(ResourceType,Trigger);參數(shù)描述ResourceType代表要監(jiān)視的資源類(lèi)型的整數(shù)，可為以下值之一：1返回GDI資源可用空閑空間的百分比。返回USER資源可用空閑空間的百分比。返回當(dāng)前內(nèi)存中空閑空間字節(jié)數(shù)。返回當(dāng)前正在運(yùn)行的任務(wù)數(shù)。Trigger每當(dāng)Trigger值轉(zhuǎn)變時(shí)，執(zhí)行InfoResource函數(shù)。Trigger可為任一變量名(不受系統(tǒng)變量限制)。由整數(shù)ResourceType指定的特定系統(tǒng)資源信息存放在IntegerResult例如：下面的語(yǔ)句每分鐘執(zhí)行一次并返回當(dāng)前值：InfoResource(1,$分);//將返回空閑百分比InfoResource(2,$分);//將返回空閑百分比InfoResource(3,$分);將返回內(nèi)存中空閑空間字節(jié)數(shù)InfoResource(4,$分);將返回任務(wù)數(shù)留意:在WINNT下返回GDI和USER的資源可用空閑空間的百分比是一樣的，與WINNT系統(tǒng)有關(guān)。Int此函數(shù)返回小于等于指定數(shù)值的最大整數(shù)。調(diào)用格式：IntegerResult=Int(Number);Number任一數(shù)字或者組態(tài)王的實(shí)型或整型變量名。例如：Int(4.7);將返回4；Int(-4.7);將返回-5listLoadList此函數(shù)用于將CSV文件Filename中的列表項(xiàng)調(diào)入指定的列表框控件ControlName中，并替換列表框中的原有列表項(xiàng)。列表框中只顯示列表項(xiàng)的成員名稱(chēng)〔字符串信息〕，而不顯示相關(guān)的數(shù)據(jù)值。語(yǔ)法格式使用如下：listLoadList(“ControlName“,“Filename“);參數(shù)說(shuō)明：ControlName：工程人員定義的列表框控件名稱(chēng)，可以為中文名或英文名。Filename：csv文件，用寫(xiě)字板程序進(jìn)展編輯，用以存放列表框中要顯示的列表項(xiàng)。例如：istLoadList(“組合框信息“,“c:\組態(tài)王\list.csv“);此語(yǔ)句將指定的文件list.csv調(diào)入名為組合框信息的列表框中并顯示出來(lái)。注：假設(shè)沒(méi)有給出csv文件。listSaveList此函數(shù)用于將列表框控件ControlName中的列表項(xiàng)信息存入CSV文件Filename中。假設(shè)該文件不存在，則直接創(chuàng)立。語(yǔ)法格式使用如下：listSaveList(“ControlName“,“Filename“);參數(shù)說(shuō)明：ControlNameFilename：CSV文件，按肯定格式用以存放列表框中的列表項(xiàng)。例如：listSaveList(“組合框信息“,“c:\組態(tài)王\list.csv“);此語(yǔ)句將組合框信息列表框中的列表項(xiàng)存入到文件c:\組態(tài)王\list.csv中。注：假設(shè)沒(méi)有給出CSV文件所在的完整路徑，則該函數(shù)在組態(tài)王所在的路徑下創(chuàng)立該文件。LogEloeLogE變量值);例如：LogE(100);返回loge100計(jì)算值4.605LogE(1);返回loge1計(jì)算值0LogN此函數(shù)返回以n為底的x的對(duì)數(shù)。以1為底的對(duì)數(shù)沒(méi)有定義。調(diào)用格式：Result=LogN(Number,Base);參數(shù)描述Number任一數(shù)字或者組態(tài)王的實(shí)型或整型變量名。例如：LogN(8,3);將返回1.89279...LogN(3,7);將返回0.564...LogOff此函數(shù)用于在TOUCHVEW中退出登錄。調(diào)用格式：LogOff();參數(shù)無(wú)LogOn此函數(shù)用于在TouchVew中登錄。調(diào)用格式：LogOn();參數(shù)無(wú)例如：為畫(huà)面上某個(gè)按鈕建立命令語(yǔ)言連接：LogOn();畫(huà)面程序運(yùn)行時(shí)單擊此按鈕，彈出“登錄”對(duì)話框：工程人員在此對(duì)話框中輸入用戶(hù)名和口令，以獲得操作權(quán)限。

Base

做底的整數(shù)。Max此函數(shù)用于求得給定的數(shù)中最大的一個(gè)數(shù)。其參數(shù)個(gè)數(shù)為1-16個(gè)。Max(Val1,Val2);例如：MaxValue=Max(Max(var1,var2),var3);此函數(shù)返回值MaxValue為var1、var2、var3中最大的數(shù)。Min此函數(shù)用于求得給定的數(shù)中最小的一個(gè)數(shù)。其參數(shù)個(gè)數(shù)為1-16個(gè)。例如：MinValue=Min(Min(var1,var2),var3);此函數(shù)返回值MinValue為var1var2、var3中最小的數(shù)。ModifyTagField此函數(shù)用于修轉(zhuǎn)變量的屬性值語(yǔ)法格式使用如下：ModifyTagField(“VarName“,Value,Quality,Year,Month,Date,Hour,Minute,Second,millSecond);參數(shù)說(shuō)明：VarName：變量名稱(chēng)。 Value：變量值。Quality：變量的質(zhì)量戳。Year：變量時(shí)間戳的年。Month：變量時(shí)間戳的月。Date：變量時(shí)間戳的日。Hour：變量時(shí)間戳的時(shí)。 Minute：變量時(shí)間戳的分Second：變量時(shí)間戳的秒。millSecond：變量時(shí)間戳的毫秒。例如：ModifyTagField(“R1“,999.9,192,2005,10,1,9,0,0,0);Down用于報(bào)警窗口信息的向前翻頁(yè)顯示。調(diào)用形式：Down(AlmWin,Lines);參數(shù)：AlmWin：報(bào)警窗口名Lines：翻頁(yè)行數(shù)Down(全廠歷史報(bào)警記錄窗口,7);該調(diào)用將“全廠歷史報(bào)警記錄窗口”的報(bào)警記錄向下翻7行〔假設(shè)有足夠報(bào)警記錄的話〕。Up用于報(bào)警窗口信息的向后翻頁(yè)顯示。調(diào)用格式：Up(AlmWin,Lines);參數(shù)：AlmWin：報(bào)警窗口名Lines：翻頁(yè)行數(shù)Up(全廠歷史報(bào)警記錄窗口,7);該調(diào)用將“全廠歷史報(bào)警記錄窗口”的報(bào)警記錄向上翻7行〔假設(shè)有足夠報(bào)警記錄的話〕.PI此函數(shù)返回圓周率的值。調(diào)用格式：RealResult=PI;例如：PI();將返回3.1415926...PowerCheckUser此函數(shù)當(dāng)用戶(hù)期望進(jìn)展一項(xiàng)操作時(shí)〔如分閘或合閘〕，為防止誤操作，需要進(jìn)展雙重認(rèn)證。即在身份認(rèn)證對(duì)話框中，既要輸入操作者的名稱(chēng)和密碼，又要輸入監(jiān)控者的姓名和密碼，兩者驗(yàn)證無(wú)誤時(shí)方可操作。調(diào)用該函數(shù)后，彈出身份驗(yàn)證對(duì)話框。如以下圖所示。其中使用的用戶(hù)信息是通過(guò)組態(tài)王中的用戶(hù)配置得到的。調(diào)用格式：Result=PowerCheckUser(stringOperatorName,stringMonitorName);參數(shù)描述OperatorName返回的操作者姓名MonitorName返回的掌握者姓名Result1：驗(yàn)證成功，0：驗(yàn)證失敗例如：Result=PowerCheckUser(OperatorName,MonitorName);PreviewWindow該函數(shù)具有組態(tài)王畫(huà)面的打印預(yù)覽功能。調(diào)用格式：PreviewWindow(“Window“,xScale,yScale,option,xStart,yStart);參數(shù)說(shuō)明：Window：要打印預(yù)覽的組態(tài)王窗口名，即組態(tài)王畫(huà)面名稱(chēng)。字符串類(lèi)型。xScale0時(shí)，option參數(shù)起作用。yScale0時(shí)，option參數(shù)起作用。option：僅當(dāng)xScale和yScale為0時(shí)有效。整型，取值0或1。假設(shè)組態(tài)王畫(huà)面上不包含位圖，OCX控件，報(bào)表，報(bào)警窗，那么，option為0時(shí),保持畫(huà)面的縱橫比不變，以適合打印頁(yè)面的最大比例打印〔畫(huà)面不失真〕；option為1時(shí)，按頁(yè)面的大小對(duì)畫(huà)面進(jìn)展縮放〔畫(huà)面有可能失真〕。假設(shè)組態(tài)王畫(huà)面上包含位圖，OCXoption為1時(shí),保持畫(huà)面的縱橫比不變，以適合打印頁(yè)面的最大比例打印〔畫(huà)面不失真〕；option為0時(shí)，按頁(yè)面的大小對(duì)畫(huà)面進(jìn)展縮放〔畫(huà)面有可能失真〕。當(dāng)畫(huà)面上包含位圖，OCX控件，報(bào)表，報(bào)警窗時(shí)，建議將option參數(shù)設(shè)為1。xStart：要打印窗口的橫OCX表，報(bào)警窗，中的任何一個(gè)時(shí)，xStart參數(shù)值無(wú)意義。yStart：要打印窗口的縱向空白占頁(yè)面高度的百分比。整型或?qū)嵭?。假設(shè)組態(tài)王畫(huà)面上包含位圖，OCX控件，報(bào)表，報(bào)警窗，中的任何一個(gè)時(shí)，yStart參數(shù)值無(wú)意義。留意：12、只能預(yù)覽當(dāng)前顯示的畫(huà)面。3、請(qǐng)?jiān)诮M態(tài)王運(yùn)行系統(tǒng)啟動(dòng)，顯示運(yùn)行畫(huà)面之后，再進(jìn)展打印預(yù)覽。4〔畫(huà)面的顯示尺寸和實(shí)際尺寸在開(kāi)發(fā)系統(tǒng)的畫(huà)面屬性中設(shè)置預(yù)覽到的是局部畫(huà)面。5、建議將畫(huà)面的顯示尺寸設(shè)在計(jì)算機(jī)顯示屏的像素點(diǎn)以下。例如：預(yù)覽報(bào)表打印窗口，可以使用下面的按鈕命令語(yǔ)言：PreviewWindow(“報(bào)表“,0,0,1,0,0);其中“報(bào)表”為包含報(bào)表的組態(tài)王畫(huà)面名。ReBuildDDE此函數(shù)用于重建立DDE連接。調(diào)用形式：ReBuildDDE;此函數(shù)無(wú)參數(shù)。ReBuildUnConnectDDE此函數(shù)用于重建立未成功的DDE連接。調(diào)用形式：ReBuildUnConnectDDE;此函數(shù)無(wú)參數(shù)。ReportLoad此函數(shù)為報(bào)表專(zhuān)用函數(shù)。將指定路徑下的報(bào)表讀到當(dāng)前報(bào)表中來(lái)語(yǔ)法格式使用如下：ReportLoad(ReportName,FileName)返回值：返回存儲(chǔ)是否成功標(biāo)志0-成功-3-失敗〔留意定義返回值變量的范圍〕參數(shù)說(shuō)明：ReportName：報(bào)表名稱(chēng)FileName：報(bào)表存儲(chǔ)路徑和文件名稱(chēng)例如：將文件名為“數(shù)據(jù)報(bào)表1”，路徑為“C:\MyDocuments”的報(bào)表讀取到當(dāng)前報(bào)表中，返回值賦給變量“讀文件”：讀文件=ReportLoad(“實(shí)時(shí)數(shù)據(jù)報(bào)表”,”C:\MyDocuments\報(bào)表.RTL”)；ReportSetup此函數(shù)為在運(yùn)行狀態(tài)下對(duì)報(bào)表進(jìn)展頁(yè)面設(shè)置函數(shù)語(yǔ)法格式使用如下：ReprotSetup(StringszRptName);參數(shù)說(shuō)明：szRptName：要進(jìn)展頁(yè)面設(shè)置報(bào)表的名稱(chēng)例如：設(shè)置“實(shí)時(shí)數(shù)據(jù)報(bào)表”頁(yè)面屬性：ReportSetup(“實(shí)時(shí)數(shù)據(jù)庫(kù)表”);ReportSaveAs此函數(shù)為報(bào)表專(zhuān)用函數(shù)。將指定報(bào)表依據(jù)所給的文件名存儲(chǔ)到指定名目下，ReportSaveAs支持將報(bào)表文件保存為rtl、xlscsv文件的后綴名。ReportSaveAs(ReportName,FileName);返回值：整型返回存儲(chǔ)是0-成功參數(shù)說(shuō)明:ReportName：報(bào)表名稱(chēng)FileName：存儲(chǔ)路徑和文件名稱(chēng)例如1：將報(bào)表“實(shí)時(shí)數(shù)據(jù)報(bào)表”存儲(chǔ)為文件名為“數(shù)據(jù)報(bào)表1.RTL”，路徑為“C:\MyDocuments”，返回值賦給變量“存文件”：存文件=ReportSaveAs(“實(shí)時(shí)數(shù)據(jù)報(bào)表”,“C:\MyDocuments\數(shù)據(jù)報(bào)表1.RTL”);例如2：將報(bào)表“實(shí)時(shí)數(shù)據(jù)報(bào)表”存儲(chǔ)為EXCEL格式的文件，文件名為“數(shù)據(jù)報(bào)表1.xls”，路徑為“C:\MyDocuments”，返回值賦給變量“存文件”：存文件=ReportSaveAs(“實(shí)時(shí)數(shù)據(jù)報(bào)表C:\MyDocuments\數(shù)據(jù)報(bào)表1.xls”);SampleVar該函數(shù)是為要進(jìn)展間歇采集的IO變量供給的解決方法。在使用前，需要將進(jìn)展間歇采集的IO變量的采集頻率定義為0毫秒〔否則該函數(shù)沒(méi)有用處〕，在需要進(jìn)展采集時(shí)，執(zhí)行該函數(shù)，將變量預(yù)備寫(xiě)入組態(tài)王數(shù)據(jù)采集隊(duì)列，然后執(zhí)行SampleVarEnd函數(shù)，進(jìn)展一次數(shù)據(jù)采集。調(diào)用格式：SampleVar(TagName);參數(shù)：TagName字符串型要進(jìn)展間歇采集的變量名稱(chēng)例如：環(huán)境監(jiān)測(cè)中的“水質(zhì)含氧量”為在需要時(shí)才進(jìn)展采集的變量，其它時(shí)間不需要采0，在命令語(yǔ)言腳步中使用該函數(shù)：SampleVar(“水質(zhì)含氧量”);當(dāng)該函數(shù)執(zhí)行時(shí)，將“水質(zhì)含氧量”變量的采集信息預(yù)備寫(xiě)入組態(tài)王的數(shù)據(jù)采集隊(duì)列。當(dāng)需要正式采集時(shí)執(zhí)行SampleVarEnd函數(shù)，進(jìn)展一次數(shù)據(jù)采集。SampleVarEnd執(zhí)行SampleVar函數(shù)后，執(zhí)行該函數(shù)，將需要進(jìn)展采集的變量信息寫(xiě)入組態(tài)王數(shù)據(jù)采集隊(duì)列。調(diào)用格式：SampleVarEnd;沒(méi)有參數(shù)。SendKeys此函數(shù)與StartAppActivateApp“組態(tài)王”具備了遠(yuǎn)程掌握其它應(yīng)用程序的力量，這是“組態(tài)王”Excel，然后又可以命令該應(yīng)用程序執(zhí)行一組功能，如產(chǎn)生報(bào)表，趨向圖或記錄數(shù)據(jù)。所需的過(guò)程可以用某一應(yīng)用程序〔比方Excel〕的“宏”語(yǔ)言來(lái)寫(xiě)。這就是說(shuō)，只要按一次鍵調(diào)用該宏命令就能啟動(dòng)很簡(jiǎn)單的過(guò)程。這種用其他功能很強(qiáng)的應(yīng)用程序作為附屬程序的力量大大增加了“組態(tài)王”的功能。該函數(shù)用于將擊鍵信息發(fā)送至當(dāng)前獲得輸入焦點(diǎn)的應(yīng)用程序。對(duì)于此應(yīng)用程序來(lái)說(shuō)，鍵似乎已由鍵盤(pán)輸入。在調(diào)用此函數(shù)時(shí)，必需使承受鍵信息的應(yīng)用程序獲得輸入焦點(diǎn)。因此需要先調(diào)用ActivateApp。例如：ActivateApp(“Excel.exe“);SendKeys(“^(X)“);將ControlX鍵信息發(fā)送至Excel。對(duì)于Excel來(lái)說(shuō)，這可能為報(bào)告生成宏命令的命令碼。其調(diào)用形式為：SendKeys(keyT);參數(shù)keyTMicrosoft的Excel的函數(shù)SendKeys中參數(shù)keyT一樣，可參照下面的表：鍵碼 意義{BACKSPACE}or{BS} ackspace{BREAK} BreakCaps{CAPSLOCK} CapsLock{CLEAR} Clear{DELETE}or{DEL} DeleteorDel{DOWN} Downdirectionkey{END} End{ENTER}or~ Enter{ESCAPE}or{ESC} Esc(Escape){HOME} Home{INSERT} Insert{LEFT} Leftdirectionkey{NUMLOCK} NumLock{PGDN} DownupPrintScreenRightdirectionkey{SCROLLLOCK} ScrollLockTabUpdirectionkey{F1}through{F12} FunctionkeysF1throughF12可以用大寫(xiě)或小寫(xiě)的字符定義一個(gè)鍵命令，還可以同時(shí)與下面的鍵協(xié)作使用：鍵碼 意義+ Shift^ Ctrl% Alt例如：為了發(fā)送一鍵序列來(lái)拷貝已選定的區(qū)，調(diào)用函數(shù)SendKeys(“^{insert}“);為了表示在另一鍵按下時(shí)按下SHIFT，CONTROL或ALT，可以將其它鍵放入括號(hào)內(nèi)。如：SendKeys(“%(TFR)~“);這表示先發(fā)出擊鍵信號(hào)：Alt-t、Alt-f和Alt-r,然后是EnterAltAltAlt鍵好象同時(shí)也被按下。SendKeys(“secret~“);表示先發(fā)出字符串secret，然后按回車(chē)鍵。由于字符+^和%給字符加花括號(hào)，如：SendKeys(“A{+}B“)，表示發(fā)出字符串A+B。SetAlarmWinDis此函數(shù)用來(lái)設(shè)置實(shí)時(shí)報(bào)警窗口信息顯示方式。語(yǔ)法格式：voidSetAlarmWinDis(longnSet);參數(shù)說(shuō)明：nSet=1:恢復(fù)并且確認(rèn)后，報(bào)警信息才消逝非1:恢復(fù)后報(bào)警信息消逝默認(rèn)還是報(bào)警恢復(fù)即報(bào)警消逝；報(bào)警恢復(fù)+報(bào)警確認(rèn)：既顯示報(bào)警大事又顯示報(bào)警恢復(fù)大事,當(dāng)報(bào)警信息被確認(rèn)后，報(bào)警信息會(huì)自動(dòng)消逝。SetPrintAlarm該函數(shù)用來(lái)執(zhí)行實(shí)時(shí)打印功能。語(yǔ)法格式：BOOLSetPrintAlarm(BOOLbitset);參數(shù)描述：bitset：bool類(lèi)型，為1時(shí)則停頓報(bào)警打印，為0開(kāi)頭報(bào)警打印返回值：bool類(lèi)型，能反映設(shè)置后的打印狀態(tài)，為1時(shí)則停頓報(bào)警打印，為0開(kāi)頭報(bào)警打印注：此函數(shù)只有當(dāng)配置了報(bào)警配置中的報(bào)警打印后才能起作用。SetRealDBForBool此函數(shù)用于生成離散型變量的操作大事。除按鈕命令語(yǔ)言外，在組態(tài)王命令語(yǔ)言中修轉(zhuǎn)變量的值可以生成操作大事。調(diào)用形式：SetRealDBForBool(“VarName“,Value);參數(shù)：VarName：變量名稱(chēng)，離散型格式Value：為變量值例如：在畫(huà)面“顯示時(shí)”命令語(yǔ)言中輸入:SetRealDBForBool(“\\本站點(diǎn)\閥門(mén)“,1)設(shè)置實(shí)型變量“\\本站點(diǎn)\閥門(mén)”的值為1。畫(huà)面顯示時(shí)，生成實(shí)型變量\\本站點(diǎn)\閥門(mén)的操作大事。SetRealDBForFloat此函數(shù)用于生成實(shí)型變量的操作大事。除按鈕命令語(yǔ)言外，在組態(tài)王命令語(yǔ)言中修轉(zhuǎn)變量的值可以生成操作大事。調(diào)用形式：SetRealDBForFloat(“VarName“,Value)：VarName為變量名，Value為變量值“顯示時(shí)”SetRealDBForFloat(“\\本站點(diǎn)\液位“,1.5)設(shè)置實(shí)型變量“\\本站點(diǎn)\液位”的值為1.5。畫(huà)面顯示時(shí)，生成實(shí)型變量\\本站點(diǎn)\液位的操作大事。SetRealDBForInt此函數(shù)用于生成整型變量的操作大事。除按鈕命令語(yǔ)言外，在組態(tài)王命令語(yǔ)言中修轉(zhuǎn)變量的值可以生成操作大事。調(diào)用形式：SetRealDBForInt(“VarName“,Value);VarName為變量名，Value為變量值“顯示時(shí)”SetRealDBForInt(“\\本站點(diǎn)\行“,10);設(shè)置整型變量“\\本站點(diǎn)\行”的值為10。畫(huà)面顯示時(shí)，生成整型變量“\\本站點(diǎn)\行”的操作大事。SetRealDBForString此函數(shù)用于設(shè)置變量的當(dāng)前實(shí)時(shí)字符串型值。調(diào)用形式：SetRealDBForString(“VarName“,”Value”);參數(shù)：VarName：變量名稱(chēng)Value：要設(shè)置的字符串說(shuō)明：變量只能是字符串型變量例如：建按鈕，彈起大事命令語(yǔ)言連接彈起時(shí)：SetRealDBForString(“\\本站點(diǎn)\v“,“abc“);設(shè)置字符串變量“\\本站點(diǎn)\v”的值為abc。SetTrendPara“組態(tài)王”運(yùn)行中彈出對(duì)話框以轉(zhuǎn)變歷史趨勢(shì)曲線的參數(shù)，如起始時(shí)間、數(shù)據(jù)長(zhǎng)度、縱軸的起點(diǎn)、縱軸的終點(diǎn)等。調(diào)用形式：SetTrendPara(Trend_Tag);參數(shù)：Trend_Tag:歷史曲線名稱(chēng)。例如：SetTrendPara(歷史趨勢(shì)曲線);//“歷史趨勢(shì)曲線“為歷史趨勢(shì)曲線名稱(chēng)。Sgn此函數(shù)判別一個(gè)數(shù)值的符號(hào)(正、零或負(fù))。調(diào)用格式：IntegerResult=Sgn(Number);Number任一數(shù)值或組態(tài)王實(shí)型或整型變量名。假設(shè)數(shù)值為正，則返回值為1。數(shù)值為負(fù)的則返回值為-1，數(shù)值為0則返回0。例如：Sgn(425);//將返回1；Sgn(0);//將返回0；Sgn(-37.3);//將返回-1ShowNavigateWindow此函數(shù)用于實(shí)現(xiàn)導(dǎo)航窗口的顯示與隱蔽。調(diào)用格式：ShowNavigateWindow(nCmdShow);nCmdShonCmdShow=顯示導(dǎo)航窗口。例如：顯示導(dǎo)航窗口：ShowNavigateWindow(1);ShowPicture此函數(shù)用于顯示畫(huà)面。調(diào)用格式：ShowPicture(“PictureName“);例如：ShowPicture(“反響車(chē)間“)；Sin此函數(shù)用于計(jì)算變量值的正弦值調(diào)用格式：Sin(變量值);例如：Sin(90);此函數(shù)返回值為1；Sin(0);此函數(shù)返回值為0Sqrt此函數(shù)用于計(jì)算變量值的平方根調(diào)用格式：Sqrt(Number);變量值的類(lèi)型可為整型、模擬量、離散量，變量值為正數(shù)時(shí)，函數(shù)返回值有效，變量值為負(fù)數(shù)時(shí)，函數(shù)返回值無(wú)效，StartApp此函數(shù)用于啟動(dòng)另一窗口應(yīng)用程序。為確保能啟動(dòng)應(yīng)用程序，請(qǐng)?jiān)趹?yīng)用程序名前使用全路徑。路徑使用DOS名稱(chēng)，即在DOS下顯示的路徑名。調(diào)用格式：StartApp(“命令行參數(shù)“)；或StartApp(“應(yīng)用程序名“)；例如：StartApp(“c:\programfiles\microsoftoffice\office\excelreport.xls”);啟動(dòng)Excel，并自動(dòng)翻開(kāi)電子數(shù)據(jù)表“Report.XLS“。假設(shè)不想自動(dòng)翻開(kāi),則只需：StartApp(“c:\programfiles\microsoftoffice\office\excel“〕；StopApp此函數(shù)與StartApp相對(duì)應(yīng)，用來(lái)關(guān)閉第三方軟件。調(diào)用格式：VoidStopApp(stringcmd,stringtype);參數(shù)描述：cmd：要關(guān)閉的第三方軟件信息.type:cmd的信息類(lèi)型.返回值：無(wú)Type值1234cmd含義Type值1234cmd含義captionclass執(zhí)行文件exeFile進(jìn)程IDPID應(yīng)用舉例〔以簡(jiǎn)體中文操作系統(tǒng)下關(guān)閉組態(tài)王信息窗口為例〕StopApp(“信息窗口“,1);StopApp(“kingmess“,2);StopApp(“KingMess.exe“,3);StopApp(“5068“,4);//ID可通過(guò)任務(wù)治理器進(jìn)程PID列獲得StrChar此函數(shù)返回某一指定ASCII碼所對(duì)應(yīng)的字符。調(diào)用格式：MessageResult=StrChar(ASCII);ASCIIASCII碼或“組態(tài)王”字符串變量。ASCII變量對(duì)應(yīng)的字符將返回給MessageResult。此函數(shù)的一個(gè)用處是可以不用鍵盤(pán)給字符串變量添加字符。例如：ControlString=MessageTag+StrChar(13)+StrChar(10);將一個(gè)[CR]和[LF]加到MessageTag的末尾，并且傳遞給了ControlStringASCII碼在32-126范圍之外的字符對(duì)于創(chuàng)立外設(shè)(例如：打印機(jī)或調(diào)制解調(diào)器)的掌握代碼是格外有用的。StrFromInt此函數(shù)將一整數(shù)值轉(zhuǎn)換為另一進(jìn)制下的字符串表示。調(diào)用格式：MessageResult=StrFromInt(Integer,Base);參數(shù)描述IntegerBase用來(lái)轉(zhuǎn)換的進(jìn)制。Integer被轉(zhuǎn)換成指定的進(jìn)制結(jié)果將存在MessageResult中。例如：StrFromInt(26,2);//返回“11010“；StrFromInt(26,8);//返回“32“；StrFromInt(26,16);//返回“1A“。StrFromReal此函數(shù)將一實(shí)數(shù)值轉(zhuǎn)換成字符串形式，該字符串以浮點(diǎn)數(shù)計(jì)數(shù)制表示或以指數(shù)計(jì)數(shù)制表示。調(diào)用格式：MessageResult=StrFromReal(Real,Precision,Type);參數(shù)描述Real依據(jù)指定Precision和Type進(jìn)展轉(zhuǎn)換，其結(jié)果保存在MessageResult中。Precision指定要顯示多少個(gè)小數(shù)位。Type確定顯示方式，可為以下字符之一：“f“按浮點(diǎn)數(shù)顯示“e“按小寫(xiě)“e”的指數(shù)制顯示?！癊“按大寫(xiě)“E”的指數(shù)制顯示。例如：StrFromReal(263.355,2,“f“);//返回“263.36“；StrFromReal(263.355,2,“e“);//返回“2.63e2“；StrFromReal(263.55,3,“E“);//返回“2.636E2“StrFromTime此函數(shù)將一個(gè)時(shí)間值(1969年12月31日16:00起，以秒為單位)轉(zhuǎn)換成字符串。調(diào)用格式：MessageResult=StrFromTime(SecsSince1_1_70,StringType);SecsSince1_1_70轉(zhuǎn)換為指定的StringType類(lèi)型，結(jié)果保存在MessageResult中。tringType以Windows掌握面板一樣的格式顯示日期。以Windows掌握面板一樣的格式顯示時(shí)間。同時(shí)顯示日期和時(shí)間例如：StrFromTime(86400,1);//返回“1/2/70“StrFromTime(86400,2);//返回“12:00:00AM“StrFromTime(86400,3);//返回“1/2/7012:00:00AM“。StrLeft此函數(shù)返回指定字符串變量的開(kāi)頭(或最左的)假設(shè)干個(gè)字符。調(diào)用格式：MessageResult=StrLeft(Text,Chars);參數(shù)描述Text實(shí)際文本字符串或字符串變量名。Chars要返回的字符個(gè)數(shù)。假設(shè)Chars置為0，則返回全部字符串。例如：StrLeft(“TheControlPumpisOn“,3);//返回“The“StrLeft(“Pump01isOn“,3);//返回“Pump“StrLeft(“Pump01isOn“,96);//返回“Pump01isOn“StrLeft(“TheControlPumpisOn“,0);//返回“TheControlPumpisOn“。StrLen此函數(shù)返回指定字符串變量的長(zhǎng)度。調(diào)用格式：IntegerResult=StrLen(Text);參數(shù)描述Text實(shí)際文本字符串或字符串變量名。文本的長(zhǎng)度(字符數(shù))返回給IntegerTag。全部字符串變量中的字符，包括那些在屏幕上不以能顯示的字符都將被計(jì)算。例如：StrLen(“Twelvepercent“);//返回14StrLen(“12%“);//返回3StrLen(“Theend.[CR]“);//返回10，[CR]是回車(chē)符-ASCII13。StrRight此函數(shù)返回指定字符串變量的最末端(或最右)假設(shè)干個(gè)字符。調(diào)用格式：MessageResult=StrRight(Text,Chars);參數(shù)描述Text要查找的文本。字符串或組態(tài)王字符串變量。Chars返回字符的個(gè)數(shù)。字符串或組態(tài)王整型變量。假設(shè)Chars置為0，則將返回全部字符串。例如：StrRight(“ThePumpisOn“,2);//返回“On“StrRight(“ThePumpisOn“,5);//返回“isOn“StrRight(“ThePumpisOn“,87);//返回“ThePumpisOn“StrRight(“ThePumpisOn“,0);//返回“ThePumpisOn“。StrType此函數(shù)檢測(cè)字符串變量的首字符以確定其是否為某一類(lèi)型。調(diào)用格式：DiscreteResult=StrType(Text,TestType);參數(shù)描述Text函數(shù)將處理的字符串或字符串變量。TestType字符類(lèi)型，確定為以下類(lèi)型之一：1字母數(shù)字符(”A”-”Z”,”a-z”和”0-9”)2數(shù)字符(”0”-9”)3字母(”A-Z”和”a-z”)4大寫(xiě)字母(”A”-”Z”)5小寫(xiě)字母(”a”-”z”)6標(biāo)點(diǎn)字符(0x21-0x2F)7ASCII字符(0x00-0x7F)8十六進(jìn)制字符(”A”-”F”或”a”-”f”或”0”-”9”)可打印字符(0x20-0x7E)掌握字符(0x00-0x1F或0x7F)11空白符(0x09-0x0Dor0x20)假設(shè)Text中首字符是由TestType指定的類(lèi)型，則StrType函數(shù)將返回給DiscreteResult一個(gè)正值。正如在其它函數(shù)中，單個(gè)字符被檢測(cè)或影響一樣，假設(shè)StrType函數(shù)的字符串變量含有一個(gè)以上字符時(shí)，只有變量的首字符將被檢測(cè)。例如：StrType(“ACB123“,1);//返回1StrType(“ABC123“,5);//返回0。StructVarRefAd