精心整理組態(tài)王常用命令語言函數(shù)速查手冊

1、組態(tài)王命令語言函數(shù)手冊“組態(tài)王”支持使用內(nèi)建的復(fù)雜函數(shù)，其中包括字符串函數(shù)、數(shù)學(xué)函數(shù)、系統(tǒng)函數(shù)、控件函數(shù)、報表函數(shù)及其他函數(shù)，下面依次介紹各個函數(shù)（函數(shù)名不區(qū)分大小寫，按字母排序）：Abs 此函數(shù)用于計算變量值的絕對值，使用格式如下： Abs(變量名或數(shù)值); 返回值：整值或?qū)嵭椭担?例如： Abs(14); 返回值為14 Abs(-7.5); 返回值為7.5 Abs(距離); 返回內(nèi)存模擬變量“距離”的絕對值。Ack 對變量進行報警確認(rèn)，或?qū)缶M進行報警確認(rèn)。如果函數(shù)參數(shù)為變量名稱，則只對該變量進行報警確認(rèn)；如果函數(shù)參數(shù)為報警組名稱，則確認(rèn)所有屬于該報警組及其子報警組的變量。該函數(shù)的參數(shù)只

2、能是變量名或報警組名，不可以為字符串變量。此函數(shù)常用于按鈕命令語言，當(dāng)發(fā)生報警時，用此函數(shù)進行報警確認(rèn)，它將產(chǎn)生確認(rèn)報警事件。調(diào)用格式： Ack(報警組名)； 或 Ack(變量名)； 例如： Ack(全廠)； 或 Ack(反應(yīng)罐液位)； ActivateApp activate'æktvet vt. 刺激；使活動；使活潑；使產(chǎn)生放射性app æpn.應(yīng)用程序 此函數(shù)用于激活正在運行的窗口應(yīng)用程序，使之變?yōu)楫?dāng)前窗口。獲得輸入焦點。該函數(shù)也可配合函數(shù)SendKeys的使用。調(diào)用形式： ActivateApp(“ExeName”)； 參數(shù)：ExeName 應(yīng)用程序的執(zhí)行文

3、件名例如：激活Microsoft Word的正確調(diào)用為： ActivateApp("Word.exe")；ArcCos arck adj. 圓弧的；反三角函數(shù)的此函數(shù)用于計算變量值的反余弦值, 變量值的取值范圍在-1，1之間，否則函數(shù)返回值無效。調(diào)用格式： ArcCos(變量名或數(shù)值); 返回值：整值或?qū)嵭椭担?例如： ArcCos(1); 此函數(shù)返回值為0 ArcCos(temp); 此函數(shù)返回變量“temp”的反余弦值。Average 'æv()rd n. 平均；平均數(shù)；adj. 平均的vt. 算出的平均數(shù)；將平均分配；使平衡此函數(shù)為對指定的組態(tài)王報表

4、表格的多個單元格求平均值，或求多個變量的平均值。語法格式使用如下： Average（a1,a2）; 或Average('a1:a10'); a1、a2為組態(tài)王單元格所在的行號列標(biāo)，或整型或?qū)嵭妥兞?。其中參?shù)個數(shù)為1-32個。 當(dāng)對報表的指定單元格區(qū)域內(nèi)的單元格進行求平均值運算時，結(jié)果顯示在當(dāng)前單元格內(nèi)，語法格式使用如下： Average（a1,a2）;例如： 任意單元格選擇求平均值: =Average（a1,b2,r10）; 連續(xù)的單元格求平均值: =Average(b1:b10); 或求變量的平均值： AverageValue= Average(lVar1,fVar1);Ba

5、ckUpHistData historyhst hist - 歷史此函數(shù)為組態(tài)王網(wǎng)絡(luò)中從IO服務(wù)器上下載歷史數(shù)據(jù)記錄到歷史記錄服務(wù)器。用戶在歷史記錄服務(wù)器上調(diào)用該函數(shù)。函數(shù)的使用需要與組態(tài)王網(wǎng)絡(luò)配置相配合，具體內(nèi)容參見組態(tài)王6.53使用手冊中“歷史庫”一章。 語法使用格式： BackupStationData (Str chMchinename, Long ftEndtime); 參數(shù)：chMchinename 字符串型 為進行備份存儲的IO服務(wù)器名 ftEndtime 整型 為備份截止時間例如： /備份“IO采集站”的歷史數(shù)據(jù)，截至?xí)r間為當(dāng)前： endTime=HTConvertTime($

6、年,$月,$日,$時,$分,0); BackUpHistData("IO采集站", endTime); Bit 此函數(shù)用以取得一個整型或?qū)嵭妥兞磕骋晃坏闹?0或1)。用法： OnOff=Bit( Var , bitNo); /OnOff:離散變量 參數(shù)：Var:整型或?qū)嵭妥兞縝itNo:位的序號，取值1至16 返回值：離散型。若變量Var的第bitNo位為0，返回值OnOff為0； 若變量Var的第bitNo位為1，返回值OnOff為1。 例如： 開關(guān)=Bit(DDE1,6); 從變量DDE1的第6位得到變量“開關(guān)”狀態(tài)。 BitSet此函數(shù)將一個整型或?qū)嵭妥兞康娜我晃恢脼?/p>

7、指定值(0或1)。語法格式： BitSet( Var, bitNo, OnOff); 參數(shù)：Var:整型或?qū)嵭妥兞?bitNo:位的序號，取值1至16 OnOff:位的設(shè)定值 注意：對于IO變量來說，BitSet函數(shù)只是用于可讀可寫的變量。 例如： BitSet(DDE1,6,0); 將變量DDE1的第6位置為0。ChangePassword password 'pswd n. 密碼；口令此函數(shù)顯示“更改口令”對話框，允許登錄工程人員更改他們的口令。使用格式： ChangePassword(); 例如： 為畫面上某一按鈕設(shè)置命令語言連接：ChangePassword( ); 運行時單擊

8、此按鈕，彈出對話框：提示工程人員輸入當(dāng)前的口令和新口令以及驗證新口令。完全正確后，工程人員的口令設(shè)置為新值。ClosePicture 此函數(shù)用于將已調(diào)入內(nèi)存的畫面關(guān)閉，并從內(nèi)存中刪除。語法格式如下： ClosePicture("畫面名"); 例如： ClosePicture("反應(yīng)車間"); 將關(guān)閉畫面“反應(yīng)車間”。ConfigODBC 此函數(shù)用于配置odbc的數(shù)據(jù)源，語法格式如下： ConfigODBC(nDatatbasetype,szAttributes); 參數(shù)： nDatatbasetype：數(shù)據(jù)庫類型，目前支持 Access，SQL serv

9、er 該參數(shù)為0時表示數(shù)據(jù)庫類型為Access，參數(shù)為1時表示數(shù)據(jù)庫類 型為SQL server ；szAttributes：配置字符串: 例1： 配置 Access數(shù)據(jù)庫，DSN名稱為demo2，數(shù)據(jù)庫文件為E:ProgramFilesKingviewExampleKingdemo1數(shù)據(jù)庫.mdb。ConfigODBC(0,"DSN=demo20Description=E:Program FilesKingviewExampleKingdemo1數(shù)據(jù)庫.mdb0PWD=12340UID=shihf"); 例2： 配置SQL數(shù)據(jù)庫： ConfigODBC(1, "

10、DSN=MyDSN0 Description =SQLConfigDSNSample0SERVER=MySQL0ADDRESS=MyServer0NETWORK=dbmssocn0DATABASE=pubs0");Date 此函數(shù)為根據(jù)給出的年、月、日整型數(shù)，返回日期字符串，默認(rèn)格式為：年：月：日。語法使用格式如下： Date（LONG nYear, LONG nMonth, LONG nDay）; 例如：年、月、日變量分別為：“$年”、“$月”、“$日”，用日期來顯示由以上三個整數(shù)決定的“日期”字符串，則在命令語言中輸入： 日期=Date（年,月,日）;DisplayMCI 此函數(shù)

11、提供了一個對多媒體設(shè)備的通用接口，具有強大的功能。語法使用格式： DisplayMCI( "MCICommand", option ); 下面舉例說明此函數(shù)的使用方法。 例如： DisplayMCI(“PLAYCD”,3); 用于播放CD唱片中的第3支歌曲。 DisplayMCI(“STOPCD”,”); 用于停止播放CD。 DisplayMCI(“PLAYMIDI”,”c:midi.mid”); 用于播放MIDI格式的背景音樂”c:midi.mid”。 DisplayMCI(“PAUSEMIDI”,” c:midi.mid”); 暫停播放MIDI格式的背景音樂”c:mid

12、i.mid”。 DisplayMCI(“RESUMMIDI”,” c:midi.mid”); 繼續(xù)播放MIDI格式的背景音樂”c:midi.mid”。 DisplayMCI(“CLOSEMIDI”,” c:midi.mid”); 停止播放MIDI格式的背景音樂”c:midi.mid”。 DisplayMCI(“EJECTCD”); 將光驅(qū)中的CD盤片彈出。Dtext 此函數(shù)用于按離散變量的值動態(tài)地改變字符串變量。語法格式如下： Str = Dtext(Discrete_Tag, OnMsg, OffMsg)； 參數(shù) 描述 Discrete_Tag 離散變量名。 OnMsg 字符串變量名 Off

13、Msg 字符串變量名 當(dāng)Discrete_Tag1時，Str的值為OnMsg 當(dāng)Discrete_Tag0時，Str的值為OffMsg 例如： Str = Dtext(電源開關(guān)，"電源打開","電源關(guān)閉"); 當(dāng)電源開關(guān)1時，Str的值為"電源打開當(dāng)電源開關(guān)0時，Str的值為"電源關(guān)閉"。 "EnableAllAlarm 全局報警使能函數(shù)。 調(diào)用形式： EnableAllAlarm(is_enable); 參數(shù)描述： is_enable 整數(shù)變量或數(shù)值 0-禁止所有報警 非0-使能所有報警 返回值：整數(shù)型，反映當(dāng)前

14、全局報警使能的狀態(tài)：若為非0：使能；為0：禁止 EnableNavigate 此函數(shù)用于顯示/關(guān)閉導(dǎo)航圖。調(diào)用形式： EnableNavigate(is_enable); 參數(shù)：is_enable，整型。 0: is_enable為0時，關(guān)閉導(dǎo)航圖1:is_enable為1時，顯示導(dǎo)航圖。使用EnableNavigate函數(shù)關(guān)閉導(dǎo)航圖后，除非使用該函數(shù)來顯示導(dǎo)航圖，否則無法顯示導(dǎo)航圖。例如： EnableNavigate(0); /關(guān)閉導(dǎo)航圖EnableSaveTagValueToIniValueWhenValueChange 對于設(shè)置了“保存數(shù)值”和“保存參數(shù)”的變量，使用該函數(shù)后，當(dāng)變量的

15、值和參數(shù)發(fā)生變化時，系統(tǒng)會自動將變量的值和參數(shù)保存到文件tagname.db中，無論組態(tài)王運行系統(tǒng)是否正常退出，再次運行后，將保存的變量值和變量參數(shù)作為變量的初始值和初始參數(shù)。“保存數(shù)值”和“保存參數(shù)”的具體含義請參見組態(tài)王手冊第七章 變量定義和管理 部分。 調(diào)用形式： EnableSaveTagValueToIniValueWhenValueChange(is_enable); 參數(shù)： is_enable：整型變量或數(shù)值1：當(dāng)變量的值和參數(shù)發(fā)生變化時，保存變量數(shù)值和參數(shù)。組態(tài)王運行系統(tǒng)退出，再次運行后，將保存的變量值和變量參數(shù)作為變量的初始值和初始參數(shù)。 0：與組態(tài)王“保存數(shù)值”和“保存參數(shù)

16、”實現(xiàn)的功能相同。 例如： 組態(tài)王開發(fā)系統(tǒng)數(shù)據(jù)詞典中定義變量，設(shè)置“保存數(shù)值”。執(zhí)行函數(shù)： EnableSaveTagValueToIniValueWhenValueChange(1); 該變量的值發(fā)生變化時，系統(tǒng)保存該變量的值。組態(tài)王運行系統(tǒng)退出，再次運行后，將保存的變量值作為變量的初始值。Exit 此函數(shù)使組態(tài)王運行環(huán)境退出。調(diào)用形式： Exit(Option); 參數(shù)： Option: 整型變量或數(shù)值 0-退出當(dāng)前程序； 1-關(guān)機； 2-重新啟動windows；Exp 此函數(shù)返回指數(shù)函數(shù)ex的計算結(jié)果使用格式如下： Exp(數(shù)值或變量名); 例如： Exp(1); 返回e1的計算值2.7

17、18 Exp(temp); 計算e常量的temp次冪并返回計算結(jié)果。GetAlarmNumInGroup 此函數(shù)用來對某一個報警組當(dāng)前的報警變量數(shù)量進行統(tǒng)計 語法格式： long GetAlarmNumInGroup("MachineName", "GroupName"); 參數(shù)說明： MachineName：報警組所在的站點名稱(對于單機網(wǎng)絡(luò)，使用時用空字符串代替) GroupName：要獲取報警變量個數(shù)的報警組名 返回值：整型，返回值表示報警變量數(shù)量 特別說明：對于網(wǎng)絡(luò)節(jié)點，需要把“本機為報警服務(wù)器”鉤上，才能正確獲取到遠(yuǎn)程節(jié)點的報警變量個數(shù)。Get

18、BackupProgress 此函數(shù)用于在組態(tài)王進行網(wǎng)絡(luò)歷史數(shù)據(jù)備份合并時獲得進度百分比。使用時需要通過命令語言調(diào)用來獲得進度值。語法使用格式： GetBackupProgress( str szStationName); 參數(shù)：szStationName 遠(yuǎn)程站點名稱。 返回值：整型，為0100間的進度值。 例如： 備份進度= 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)用格式： resul

19、t=GetCursorPosY(); 返回值為整型。GetDatelocal 此函數(shù)將以秒為單位的長整型數(shù)轉(zhuǎn)換為相應(yīng)的日期數(shù)值，分別以年、月、日的日期數(shù)值輸出。該長整型秒數(shù)的基準(zhǔn)為UTC(格林尼治)時間1970年1月1日00:00:00。轉(zhuǎn)換完成輸出的日期為本地日期。語法使用格式 GetDatelocal(DateTime,Year,Month,Day); 參數(shù) 描述 DateTime： 需要進行日期轉(zhuǎn)換的數(shù)，整型，為輸入?yún)?shù) Year： 年，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) Month： 月，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) Day： 日，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參例如： 使用HTCon

20、vertTime函數(shù)將自UTC(格林尼治)時間1970年1月1日00:00:00到北京時間2006年9月26日9:22:4轉(zhuǎn)換為以秒為單位的長整數(shù)數(shù)值為1159233724，使用GetDatelocal函數(shù)可以從這個數(shù)值中分離出所表示的北京日期年、月、日。 GetDatelocal (1159233724,年,月,日); 執(zhí)行后，得到的“年”的值為2006，“月” 的值為9，“日” 的值為26。數(shù)可以從這個數(shù)值中分離出所表示的日期年、月、日。 函數(shù) GetDate(1060301289,年,月,日); 執(zhí)行后，得到的“年”的值為2003，“月” 的值為8，“日” 的值為8。 獲得其中時間的函數(shù)

21、為GetTime()。GetGroupName此函數(shù)為通過報警組ID號獲得報警組名稱。在組態(tài)王中，每個報警組除了名稱外，還有ID號。組態(tài)王的變量域“.Group”顯示的是變量所屬報警組的ID號，如果要獲得相應(yīng)的報警組名稱，就需要使用該函數(shù)。語法使用格式 :sGroupName= GetGroupName(StationName,GroupID); 參數(shù) 描述 StationName： 報警組所在的站點名稱（該項暫時無效，使用時用空字符串代替） GroupID： 要獲取名稱的報警組的ID號返回值為字符串型。 例如： GroupName=GetGroupName(“”, 本站點原料罐液位.Grou

22、p);GetHistMaxData 此函數(shù)用來獲取某段時間中歷史數(shù)據(jù)的最大值 語法使用格式： RealResult=GetHistMaxData(TagName,StartTime,EndTime); 參數(shù)描述： TagName：所要查詢的變量的名稱，類型為字符串型，即帶引號。 StartTime：數(shù)據(jù)查詢的開始時間，該時間是通過組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長整型數(shù)，所以用戶在使用本函數(shù)之前，應(yīng)先將查詢起始時間轉(zhuǎn)換為長整型數(shù)值。 EndTime:數(shù)據(jù)查詢的結(jié)束時間，類型同StartTime。 返回值：返回一個實數(shù)值。 GetHist

23、MinData 此函數(shù)用來獲取某段時間中歷史數(shù)據(jù)的最小值 語法使用格式： RealResult=GetHistMinData(TagName,StartTime,EndTime); 參數(shù)描述： TagName：所要查詢的變量的名稱，類型為字符串型，即帶引號。 StartTime：數(shù)據(jù)查詢的開始時間，該時間是通過組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長整型數(shù)，所以用戶在使用本函數(shù)之前，應(yīng)先將查詢起始時間轉(zhuǎn)換為長整型數(shù)值。 EndTime:數(shù)據(jù)查詢的結(jié)束時間，類型同StartTime。 返回值：返回一個實數(shù)值。 GetHistAveData 此函

24、數(shù)用來獲取某段時間中歷史數(shù)據(jù)的平均值 語法使用格式： RealResult=GetHistAveData(TagName,StartTime,EndTime); 參數(shù)描述： TagName：所要查詢的變量的名稱，類型為字符串型，即帶引號。 StartTime：數(shù)據(jù)查詢的開始時間，該時間是通過組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長整型數(shù)，所以用戶在使用本函數(shù)之前，應(yīng)先將查詢起始時間轉(zhuǎn)換為長整型數(shù)值。 EndTime:數(shù)據(jù)查詢的結(jié)束時間，類型同StartTime。 返回值：返回一個實數(shù)值。 GetHistMaxTime 此函數(shù)用來獲取某段時間中

25、歷史數(shù)據(jù)的最大值對應(yīng)的時間 語法使用格式： RealResult=GetHistMaxTime(TagName,StartTime,EndTime); 參數(shù)描述： TagName：所要查詢的變量的名稱，類型為字符串型，即帶引號。 StartTime：數(shù)據(jù)查詢的開始時間，該時間是通過組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長整型數(shù)，所以用戶在使用本函數(shù)之前，應(yīng)先將查詢起始時間轉(zhuǎn)換為長整型數(shù)值。 EndTime: 數(shù)據(jù)查詢的結(jié)束時 間，類型同StartTime。 返回值： 返回一個字符串，格式為2008/10/10 11:11:11。GetHist

26、MinTime 此函數(shù)用來獲取某段時間中歷史數(shù)據(jù)的最小值對應(yīng)的時間 語法使用格式： RealResult=GetHistMinTime(TagName,StartTime,EndTime); 參數(shù)描述： TagName：所要查詢的變量的名稱，類型為字符串型，即帶引號。 StartTime：數(shù)據(jù)查詢的開始時間，該時間是通過組態(tài)王HTConvertTime函數(shù)轉(zhuǎn)化的以1969年12月31日16：00：00為基準(zhǔn)的長整型數(shù)，所以用戶在使用本函數(shù)之前，應(yīng)先將查詢起始時間轉(zhuǎn)換為長整型數(shù)值。 EndTime:數(shù)據(jù)查詢的結(jié)束時間，類型同StartTime。 返回值：返回一個字符串，格式為2008/10/10

27、 11:11:11。 GetKey 此函數(shù)為獲得組態(tài)王當(dāng)前使用的加密鎖的序列號。語法使用格式 KeyID=GetKey(); 該函數(shù)沒有任何參數(shù)。返回值為字符串型。GetProjectPath 此函數(shù)用于獲取當(dāng)前工程的路徑。語法使用格式 :GetProjectPath(); 例如：在組態(tài)王數(shù)據(jù)詞典中定義內(nèi)存字符串變量VarName：VarName=GetProjectPath(); GetRealDBForBool 此函數(shù)用于獲取變量的當(dāng)前實時離散值。語法使用格式 :GetRealDBForBool( "VarName"); 參數(shù) 描述 VarName：變量名稱，字符串格式

28、說明：變量只能是離散量。 返回值為離散型。 例如： bb= GetRealDBForBool( "原料油出料閥"); GetRealDBForFloat 此函數(shù)用于獲取變量的當(dāng)前實時模擬值。語法使用格式 :GetRealDBForFloat ("VarName"); 參數(shù) 描述 VarName： 變量名稱，字符串格式 說明：變量只能是實型變量。 例如： ff= GetRealDBForFloat ( "原料油液位"); GetRealDBForInt 此函數(shù)用于獲取變量的當(dāng)前實時整型值。語法使用格式 :GetRealDBForInt

29、( "VarName"); 參數(shù) 描述 VarName： 變量名稱，字符串格式 說明：變量只能是整型變量。 例如： ii= GetRealDBForInt ( "水果");GetRealDBForString 此函數(shù)用于獲取變量的當(dāng)前實時字符串型值。語法使用格式 :GetRealDBForString ( "VarName"); 參數(shù) 描述 VarName： 變量名稱，字符串格式 說明：變量只能是字符串型變量。 例如： ss= GetRealDBForString ( "記錄日期"); GetStationStat

30、us 此函數(shù)用于在組態(tài)王進行網(wǎng)絡(luò)歷史數(shù)據(jù)備份合并時獲得備份的狀態(tài)。使用時需要通過命令語言調(diào)用來獲得狀態(tài)值。語法使用格式： BOOL GetStationStatus( str szStationName); 參數(shù)：szStationName 遠(yuǎn)程站點名稱。返回值：離散型， >0 正在備份數(shù)據(jù) =0空閑。例如：備份狀態(tài)= GetStationStatus (“IO采集站”); GetTime 此函數(shù)將以秒為單位的長整型數(shù)轉(zhuǎn)換為相應(yīng)的時間數(shù)值，分別以時、分、秒等的時間數(shù)值輸出。該長整型秒數(shù)的基準(zhǔn)為UTC(格林尼治)時間1970年1月1日00:00:00。轉(zhuǎn)換完成輸出的時間也為UTC(格林尼治

31、)時間。語法使用格式 :GetTime(DateTime,Hour,Minute,Second); 參數(shù) 描述 DateTime： 需要進行時間轉(zhuǎn)換的數(shù)，整型，為輸入?yún)?shù) Hour： 時，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) Minute： 分，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) Second： 秒，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) 例如： 自UTC(格林尼治)時間1970年1月1日00:00:00到2003年8月8日0:8:9的秒的數(shù)值為1060301289，使用GetTime ()函數(shù)可以從這個數(shù)值中分離出所表示的日期時、分、秒。 函數(shù)GetTime (1060301289,時,分,秒); 執(zhí)行

32、后，得到的“時”的值為0，“分” 的值為8，“秒” 的值為9。 獲得其中日期的函數(shù)為GetDate ()。 GetTimelocal 此函數(shù)將以秒為單位的長整型數(shù)轉(zhuǎn)換為相應(yīng)的時間數(shù)值，分別以本地的時、分、秒的時間數(shù)值輸出。該長整型秒數(shù)的基準(zhǔn)為UTC(格林尼治)時間1970年1月1日00:00:00。轉(zhuǎn)換完成輸出的時間為本地時間。語法使用格式:GetTimelocal(DateTime,Hour,Minute,Second); 參數(shù) 描述DateTime： 需要進行時間轉(zhuǎn)換的數(shù)，整型，為輸入?yún)?shù) Hour： 時，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) Minute： 分，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參

33、數(shù)Second： 秒，整型，轉(zhuǎn)換后得到的數(shù)據(jù)，輸出參數(shù) 例如： 使用HTConvertTime函數(shù)將自UTC(格林尼治)時間1970年1月1日00:00:00到北京時間2006年9月26日9:22:4轉(zhuǎn)換為以秒為單位的長整數(shù)數(shù)值為1159233724，使用GetTimelocal函數(shù)可以從這個數(shù)值中分離出所表示的北京時間時、分、秒。 GetTimelocal (1159233724,時,分,秒); 執(zhí)行后，得到的“時”的值為9，“分” 的值為22，“秒” 的值為4。 HidePicture 此函數(shù)用于隱藏正在顯示的畫面，但并不將其從內(nèi)存中刪除。調(diào)用格式： HidePicture("畫

34、面名")； 參數(shù)：畫面名稱 字符串型 例如： HidePicture("反應(yīng)車間")； HTConvertTime 此函數(shù)將指定的時間格式（年，月，日，時，分，秒）轉(zhuǎn)換為以秒為單位的長整型數(shù)，轉(zhuǎn)換的時間基準(zhǔn)是UTC(格林尼治)1970年1月1日00:00:00。例：北京為東八區(qū)，那么轉(zhuǎn)換的時間基準(zhǔn)為1970 年1月1日8:00:00。 語法使用格式 :HTConvertTime(Year,Month,Day,Hour,Minute,Second); 參數(shù) 描述 Year： 年，整型，此值必須介于1970和2019之間 Month： 月，整型，此值必須介于1和12之

35、間 Day： 日，整型，此值必須介于1和31之間 Hour： 小時，整型，此值必須介于0和23之間 Minute： 分鐘，整型，此值必須介于0和59之間 Second： 秒，整型，此值必須介于0和59之間 返回值：整型 注： 調(diào)用此函數(shù)將用年、月、日、時、分、秒表示的時間轉(zhuǎn)換成自1970年1月1日00:00:00即UCT起到該時刻所經(jīng)過的秒數(shù)。在定義返回值變量時，應(yīng)注意將其最大值置為整型數(shù)的最大范圍，如2×109，否則可能會因為返回數(shù)據(jù)超出范圍導(dǎo)致轉(zhuǎn)換的時間不正確。 例如： 語句HTConvertTime(1970,1,1,9,0,0)執(zhí)行后返回長整型數(shù)為3600;HTGetPenR

36、ealValue 此函數(shù)用于獲取指定歷史趨勢曲線中的趨勢筆所對應(yīng)的實際值。調(diào)用格式： HTGetPenRealValue(HistroyName,PenNum,ContentString); 參數(shù)說明 HistroyName 指在“歷史趨勢曲線”對話框中定義的歷史趨勢曲線名稱 PenNum 與歷史趨勢曲線中的一個變量相對應(yīng)的趨勢筆的索引號 ContentString 字符串常量 “start” 表示獲取與歷史趨勢曲線的域ValueStart相對應(yīng)的實際值，ValueStart是用工程百分比來表示變量的下限值，start則表示將下限值的工程百分比轉(zhuǎn)換為實際值。 “end” 表示獲取與歷史趨勢曲線

37、的域ValueEnd相對應(yīng)的實際值，ValueEnd是用工程百分比來表示變量的上限值，end則表示將上限值的工程百分比轉(zhuǎn)換為實際值。 例如: 設(shè)有一溫度歷史曲線，其最大上限值為500，最小下限值為0， 如果用ValueStart和ValueEnd輸出顯示，則顯示的數(shù)據(jù)是溫度值的工程百分比，如ValueEnd 的輸出為50，表示百分比是50%，如果使用函數(shù)語句 HTGetPenRealValue(histroy,1,“end”)； 則函數(shù)返回工程百分比50%對應(yīng)的實際值500*50%=250，其中history為歷史趨勢曲線名，1表示對應(yīng)溫度的趨勢筆。HTScrollRight 此函數(shù)將趨勢曲線

38、的起始時間右移給定的百分比值。百分比是相對于趨勢曲線的時間軸長度。移動后時間軸的長度保持不變。調(diào)用格式： HTScrollRight(HistoryName,Percent); 參數(shù) 描述 HistoryName 歷史趨勢變量，代表趨勢名。 Percent 實數(shù)，代表圖表要滾動的百分比(0.0到100.0)。 例如： 將趨勢曲線Trend1的間軸范圍向右滾動 20%。調(diào)用函數(shù): HTScrollRight(Trend1,20.0); 若當(dāng)前顯示起始于下午 12:00:00，而且顯示寬度為60秒，則新的趨勢將起始于下午 12:00:12 (在函數(shù)執(zhí)行后)。InfoAppDir info '

39、;nf信息，情報，統(tǒng)計dir,di a 'r 目錄（directory）；方向（direction）；用法（directione）；指示（direct）此函數(shù)返回當(dāng)前組態(tài)王的工程路徑。調(diào)用格式： MessageResult=InfoAppDir(); 當(dāng)前組態(tài)王工程路徑返回給MessageResult. 例如： DemoPath=InfoAppDir(); 將返回 "C:Program FilesKingviewExampleKingdemo3"。 InfoAppTitle title 'tat()l n. 冠軍；標(biāo)題；頭銜；權(quán)利；字幕此函數(shù)返回應(yīng)用程序的標(biāo)

40、題或者一個當(dāng)前正在運行的指定程序的Windows任務(wù)列表名。調(diào)用格式： MessageResult=InfoAppTitle(ProgramEXEName); 返回值：字符型值； 參數(shù) 描述 ProgramEXEName 應(yīng)用程序的執(zhí)行文件名。 例如： InfoAppTitle;("calc.exe"); / 將返回 "Calculator" InfoAppTitle;("excel.exe"); /將返回 "Microsoft Excel"InfoDisk 此函數(shù)返回指定的本地(或網(wǎng)絡(luò))磁盤驅(qū)動器信息。調(diào)用格式：

41、 IntegerResult=InfoDisk(Drive,InfoType,Trigger); 參數(shù) 描述 Drive 代表驅(qū)動器號的字符串或字符串變量。若提供的字符串變量包含多于一個的字符，則只使用此變量的首字符。 InfoType 代表信息類型的整數(shù)，可為以下兩個值之一： 1 返回磁盤驅(qū)動器的總空間數(shù)(以字節(jié)計)。 2 返回磁盤驅(qū)動器上可用的空閑空間數(shù)(以字節(jié)計)。 Trigger 每當(dāng) Trigger 的值改變時，執(zhí)行 InfoDisk() 函數(shù)。Trigger 可為任何變量名(不受系統(tǒng)變量的限制)。 由驅(qū)動器號指定的磁盤驅(qū)動器的有關(guān)信息返回給IntegerResult。 例如： 下面

42、的語句每分鐘執(zhí)行一次并返回當(dāng)前的值： InfoDisk("C", 1, $分);/將返回C盤總空間數(shù) InfoDisk("C", 2, $分);/將返回C盤空閑空間數(shù) InfoFile 此函數(shù)返回指定文件或子目錄的有關(guān)信息。調(diào)用格式： IntegerResult=InfoFile(Filename,InfoType,Trigger); 參數(shù) 描述 Filename 代表要處理的文件名的字符串。 InfoType 代表要獲取的信息的類型的整數(shù)，可為以下值之一： 1 查找文件是否存在。若文件名是一個實際文件，返回1。若找不到文件則返回0。 2 文件大?。ㄗ止?jié)

43、數(shù)）。3 文件日期/時間（自1970年1月1日起的相對秒數(shù)） 4 與文件名描述相匹配的文件數(shù)。僅當(dāng)使用通配符查找并找到多個匹配的文件時，返回值大于1。 Trigger為任一變量名，每當(dāng) Trigger 的值改變時，將執(zhí)行 InfoFile() 函數(shù)。 由文件名指定的文件的有關(guān)信息返回給IntegerResult。文件名必須包括文件的完整路徑，可包含通配符(*，?)。 例如： 下面的語句每分鐘執(zhí)行一次并返回下列值： InfoFile("c:kingviewtouchvew.exe", 1, $分);將返回1，文件找到 InfoFile("c:kingviewtouc

44、hvew.exe", 2, $分);將返回634960，文件大小 InfoFile("c:kingviewtouchvew.exe", 3, $分);將返回736701852， 自70年1月1日起的秒數(shù) InfoFile("c:kingview*.exe", 4, $分);將返回4，找到4個可執(zhí)行文件。InfoResource 此函數(shù)返回各種系統(tǒng)資源值。調(diào)用格式： IntegerResult=InfoResource(ResourceType,Trigger); 參數(shù) 描述 ResourceType 代表要監(jiān)視的資源類型的整數(shù)，可為以下值之一：

45、 1 返回GDI資源可用空閑空間的百分比。 2 返回USER資源可用空閑空間的百分比。 3 返回當(dāng)前內(nèi)存中空閑空間字節(jié)數(shù)。 4 返回當(dāng)前正在運行的任務(wù)數(shù)。 Trigger 每當(dāng) Trigger 值改變時，執(zhí)行InfoResource() 函數(shù)。Trigger 可為任一變量名(不受系統(tǒng)變量限制)。 由整數(shù) ResourceType 指定的特定系統(tǒng)資源信息存放在 IntegerResult 中。 例如：下面的語句每分鐘執(zhí)行一次并返回當(dāng)前值： InfoResource(1, $分);/將返回空閑百分比 InfoResource(2, $分);/將返回空閑百分比 InfoResource(3, $分)

46、;將返回內(nèi)存中空閑空間字節(jié)數(shù) InfoResource(4, $分);將返回任務(wù)數(shù) 注意: 在WIN NT 下返回GDI和USER的資源可用空閑空間的百分比是一樣的，與WIN NT系統(tǒng)有關(guān)。Int 此函數(shù)返回小于等于指定數(shù)值的最大整數(shù)。調(diào)用格式： IntegerResult=Int(Number); 參數(shù) 描述 Number 任一數(shù)字或者組態(tài)王的實型或整型變量名。 例如： Int(4.7);將返回 4 ；Int(-4.7);將返回 -5listLoadList 此函數(shù)用于將CSV文件Filename中的列表項調(diào)入指定的列表框控件ControlName中，并替換列表框中的原有列表項。列表框中只顯

47、示列表項的成員名稱（字符串信息），而不顯示相關(guān)的數(shù)據(jù)值。語法格式使用如下： listLoadList("ControlName","Filename"); 參數(shù)說明： ControlName：工程人員定義的列表框控件名稱，可以為中文名或英文名。 Filename：csv文件，用寫字板程序進行編輯，用以存放列表框中要顯示的列表項。 例如： istLoadList("組合框信息","c:組態(tài)王list.csv"); 此語句將指定的文件list.csv調(diào)入名為組合框信息的列表框中并顯示出來。 注： 如果沒有給出csv文件

48、所在的完整路徑，則該函數(shù)就從組態(tài)王所在的路徑下尋找指定的文件。 listSaveList 此函數(shù)用于將列表框控件ControlName中的列表項信息存入CSV文件Filename中。如果該文件不存在，則直接創(chuàng)建。語法格式使用如下： listSaveList("ControlName","Filename"); 參數(shù)說明： ControlName：工程人員定義的列表框控件名稱，可以為中文名或英文名。 Filename：CSV文件，按一定格式用以存放列表框中的列表項。 例如： listSaveList("組合框信息","c:組態(tài)

49、王list.csv"); 此語句將組合框信息列表框中的列表項存入到文件c:組態(tài)王list.csv中。 注： 如果沒有給出CSV文件所在的完整路徑，則該函數(shù)在組態(tài)王所在的路徑下創(chuàng)建該文件。LogE 此函數(shù)返回對數(shù)函數(shù)logex的計算結(jié)果, X為變量值調(diào)用格式： LogE(變量值); 例如： LogE(100);返回loge100計算值4.605 LogE(1);返回loge1計算值0 LogN 此函數(shù)返回以n為底的x的對數(shù)。以1為底的對數(shù)沒有定義。調(diào)用格式： Result=LogN(Number,Base); 參數(shù) 描述 Number 任一數(shù)字或者組態(tài)王的實型或整型變量名。 Base

50、做底的整數(shù)。 例如： LogN(8, 3);將返回 1.89279. LogN(3, 7);將返回 0.564.LogOff 此函數(shù)用于在TOUCHVEW中退出登錄。調(diào)用格式： LogOff( ); 參數(shù) 無 LogOn 此函數(shù)用于在TouchVew中登錄。調(diào)用格式： LogOn( ); 參數(shù) 無 例如： 為畫面上某個按鈕建立命令語言連接： LogOn( ); 畫面程序運行時單擊此按鈕，彈出“登錄”對話框：工程人員在此對話框中輸入用戶名和口令，以獲得操作權(quán)限。Max 此函數(shù)用于求得給定的數(shù)中最大的一個數(shù)。其參數(shù)個數(shù)為1-16個。調(diào)用格式： Max( Val1, Val2 ); 例如： MaxV

51、alue = Max(Max(var1,var2), var3 ); 此函數(shù)返回值MaxValue為var1、var2、var3中最大的數(shù)。 Min 此函數(shù)用于求得給定的數(shù)中最小的一個數(shù)。其參數(shù)個數(shù)為1-16個。 例如： MinValue=Min(Min(var1,var2),var3); 此函數(shù)返回值MinValue為var1、var2、var3中最小的數(shù)。 ModifyTagField 此函數(shù)用于修改變量的屬性值 語法格式使用如下： ModifyTagField("VarName",Value,Quality,Year,Month,Date,Hour,Minute,Se

52、cond,millSecond);參數(shù)說明： VarName：變量名稱。 Value： 變量值。 Quality：變量的質(zhì)量戳。 Year：變量時間戳的年。 Month：變量時間戳的月。 Date：變量時間戳的日。 Hour：變量時間戳的時。 Minute：變量時間戳的分Second：變量時間戳的秒。 millSecond：變量時間戳的毫秒。 例如： ModifyTagField("R1",999.9,192,2005,10,1,9,0,0,0);PageDown 用于報警窗口信息的向前翻頁顯示。調(diào)用形式： PageDown(AlmWin, Lines); 參數(shù)： AlmW

53、in： 報警窗口名 Lines： 翻頁行數(shù) 例如： PageDown(全廠歷史報警記錄窗口,7); 該調(diào)用將“全廠歷史報警記錄窗口”的報警記錄向下翻7行（如果有足夠報警記錄的話）。 PageUp 用于報警窗口信息的向后翻頁顯示。調(diào)用格式： PageUp(AlmWin, Lines); 參數(shù)： AlmWin： 報警窗口名 Lines： 翻頁行數(shù) 例如： PageUp(全廠歷史報警記錄窗口,7); 該調(diào)用將“全廠歷史報警記錄窗口”的報警記錄向上翻7行（如果有足夠報警記錄的話）. PI 此函數(shù)返回圓周率的值。調(diào)用格式： RealResult=PI();例如： PI( );將返回 3.1415926.

54、PowerCheckUser 此函數(shù)當(dāng)用戶希望進行一項操作時（如分閘或合閘），為防止誤操作，需要進行雙重認(rèn)證。即在身份認(rèn)證對話框中，既要輸入操作者的名稱和密碼，又要輸入監(jiān)控者的姓名和密碼，兩者驗證無誤時方可操作。調(diào)用該函數(shù)后，彈出身份驗證對話框。如下圖所示。其中使用的用戶信息是通過組態(tài)王中的用戶配置得到的。調(diào)用格式： Result= PowerCheckUser(string OperatorName, string MonitorName); 參數(shù) 描述 OperatorName 返回的操作者姓名 MonitorName 返回的控制者姓名 Result 1：驗證成功，0：驗證失敗 例如： R

55、esult= PowerCheckUser(OperatorName, MonitorName);PreviewWindow 該函數(shù)具有組態(tài)王畫面的打印預(yù)覽功能。調(diào)用格式： PreviewWindow( "Window", xScale, yScale , option, xStart, yStart); 參數(shù)說明： Window：要打印預(yù)覽的組態(tài)王窗口名，即組態(tài)王畫面名稱。字符串類型。 xScale：打印輸出的寬度占頁面總寬度的百分比。整型或?qū)嵭汀４藚?shù)為0時，option參數(shù)起作用。 yScale：打印輸出的高度度占頁面總高度的百分比。整型或?qū)嵭?。此參?shù)為0時，opti

56、on參數(shù)起作用。 option：僅當(dāng)xScale和yScale為0時有效。整型，取值0或1。 如果組態(tài)王畫面上不包含位圖，OCX控件，報表，報警窗，那么，option為0時, 保持畫面的縱橫比不變，以適合打印頁面的最大比例打印（畫面不失真）；option為1時，按頁面的大小對畫面進行縮放（畫面有可能失真）。 如果組態(tài)王畫面上包含位圖， OCX控件，報表，報警窗，中的任何一個，那么，option為1時, 保持畫面的縱橫比不變，以適合打印頁面的最大比例打?。ó嬅娌皇д妫?；option為0時，按頁面的大小對畫面進行縮放（畫面有可能失真）。 當(dāng)畫面上包含位圖， OCX控件，報表，報警窗時，建議將opt

57、ion參數(shù)設(shè)為1。 xStart：要打印窗口的橫向空白占頁面寬度的百分比。整型或?qū)嵭?。如果組態(tài)王畫面上包含位圖， OCX控件，報表，報警窗，中的任何一個時，xStart參數(shù)值無意義。 yStart：要打印窗口的縱向空白占頁面高度的百分比。整型或?qū)嵭?。如果組態(tài)王畫面上包含位圖， OCX控件，報表，報警窗，中的任何一個時，yStart參數(shù)值無意義。 注意： 1、組態(tài)王運行系統(tǒng)預(yù)覽打印畫面后，如果在開發(fā)系統(tǒng)對畫面進行了修改，請重新預(yù)覽。 2、只能預(yù)覽當(dāng)前顯示的畫面。 3、請在組態(tài)王運行系統(tǒng)啟動，顯示運行畫面之后，再進行打印預(yù)覽。 4、如果畫面的顯示尺寸小于畫面的實際尺寸時（畫面的顯示尺寸和實際尺寸在開發(fā)系統(tǒng)的畫面屬性中設(shè)置），預(yù)覽到的畫面與組態(tài)王運行系統(tǒng)顯示的畫面相同，也就是說，預(yù)覽到的是部分畫面。 5、建議將畫面的顯示尺寸設(shè)在計算機顯示屏的像素點以下。 例如： 預(yù)覽報表打印窗口，可以使用下面的按鈕命令語言： PreviewWindow( "報表", 0, 0 , 1, 0, 0); 其中“報表”為包含報表的組態(tài)王畫面名。ReBuildDDE 此函數(shù)用于重新建立DDE連接。 調(diào)用形式： ReBuildDDE(); 此函數(shù)無參數(shù)。 ReBuildUnConnectDDE 此函數(shù)用于重新建立未成功的DDE連接。 調(diào)用形式： ReBuild UnConne