1、WINCC C腳本的標(biāo)準(zhǔn)函數(shù) 1 - 標(biāo)準(zhǔn)函數(shù)該系統(tǒng)包含標(biāo)準(zhǔn)函數(shù)。 可以按需要修改這些函數(shù)。 此外，還可以自己創(chuàng)建標(biāo)準(zhǔn)函數(shù)。該系統(tǒng)包括一個(gè)標(biāo)準(zhǔn)函數(shù)集。一、Alarm - 簡(jiǎn)短描述Alarm組包含控制WinCC報(bào)警控件的函數(shù)。標(biāo)準(zhǔn)函數(shù)可用于工具欄中的每一個(gè)按鈕。這些函數(shù)可用來(lái)創(chuàng)建自定義工具欄，例如選擇畫(huà)面,或者定義控件上的設(shè)置。1void AcknowledgeMessage(DWORD MsgNr)函數(shù)，確認(rèn)消息系統(tǒng)中帶編號(hào)的消息，該編號(hào)被傳遞為參數(shù)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例 /確認(rèn)選擇的報(bào)警記錄消息AcknowledgeMessage(GetTagWord(U08i_MsgN

2、r);指定待確認(rèn)的消息號(hào)。在本例中是從變量讀取的。2BOOL AXC_OnBtnArcLong(char* lpszPictureName, char* pszMsgWin)函數(shù)，在消息窗口中該函數(shù)表示消息存儲(chǔ)在長(zhǎng)期歸檔中。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 3BOOL AXC_OnBtnArcShort(c

3、har* lpszPictureName, char* pszMsgWin)函數(shù)，在消息窗口中該函數(shù)表示消息存儲(chǔ)在短期歸檔中。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 4BOOL AXC_OnBtnComment(char* lpszPictureName, char* pszMsgWin)函數(shù)外部消息窗口操作，該

4、函數(shù)顯示先前所選消息的注釋。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 5BOOL AXC_OnBtnEmergAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，此函數(shù)打開(kāi)確認(rèn)對(duì)話框(緊急確認(rèn)/復(fù)位)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到Wi

5、nCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 6BOOL AXC_OnBtnHornAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)確認(rèn)蜂鳴器信號(hào)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control

6、1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 7BOOL AXC_OnBtnInfo(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)顯示信息文本。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面

7、的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 7BOOL AXC_OnBtnLock(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)打開(kāi)“設(shè)置鎖定”對(duì)話框。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 8BOOL AXC_OnBtnLockUnl

8、ock(char* lpszPictureName, char* pszMsgWin)，函數(shù)，該函數(shù)鎖住在消息窗口中選擇的消息。之后，不再歸檔該消息。該函數(shù)釋放在鎖定列表中選擇的消息。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 9BOOL AXC_OnBtnLockWin(char* lpszPictureName,

9、 char* pszMsgWin)函數(shù)，外部消息窗口操作.該函數(shù)調(diào)用鎖定列表。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 10BOOL AXC_OnBtnLoop(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，此函數(shù)觸發(fā)所選消息的“報(bào)警回路”函數(shù)。使用標(biāo)準(zhǔn)函數(shù)操

10、作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 11BOOL AXC_OnBtnMsgFirst(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動(dòng)到消息列表的開(kāi)始處。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsg

11、First(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 12BOOL AXC_OnBtnMsgLast(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動(dòng)到消息列表的結(jié)束處。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的最后一條消息AXC_OnBtnMsgLast(gs_alarm_00,Control1);AXC_OnBtnMsgLast函數(shù)參

12、數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 13BOOL AXC_OnBtnMsgNext(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動(dòng)到消息列表中的下一條消息。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control

13、 1是WinCC報(bào)警控件的對(duì)象名。 14BOOL AXC_OnBtnMsgPrev(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動(dòng)到消息列表中的前一條消息。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 15BOOL AXC_OnBtnMsgWin(cha

14、r* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)調(diào)用過(guò)程消息窗口。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 16BOOL AXC_OnBtnPrint(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，打印機(jī)打

15、印出符合在報(bào)警控件中定義的選擇標(biāo)準(zhǔn)的全部消息。WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 17BOOL AXC_OnBtnScroll(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)激活水平和垂直滾動(dòng)功能。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例 / 激活/取消激活滾動(dòng)功

16、能AXC_OnBtnScroll(gs_alarm_00,Control1);AXC_OnBtnScroll函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 18BOOL AXC_OnBtnSelect(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)打開(kāi)“設(shè)置選擇”對(duì)話框。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMs

17、gFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 19BOOL AXC_OnBtnSinglAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)確認(rèn)當(dāng)前所選的消息。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 確認(rèn)激活的消息AXC_OnBtnSinglAckn(gs_alarm_00,Control1);AXC_OnBtnSinglAckn函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是W

18、inCC報(bào)警控件的對(duì)象名。 20BOOL AXC_OnBtnVisibleAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，確認(rèn)消息窗口中可見(jiàn)的全部消息(組確認(rèn))。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/ 跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱(chēng)。Control 1是WinCC報(bào)警控件的對(duì)象名。 21BOOL AXC_SetFilter(cha

19、r* lpszPictureName, char* lpszObjectName, LPMSG_FILTER_STRUCT lpMsgFilter, LPCMN_ERROR, lpError)函數(shù)，外部消息窗口操作，該函數(shù)為WinCC報(bào)警控件設(shè)置過(guò)濾器，以便根據(jù)指定的過(guò)濾標(biāo)準(zhǔn)篩選出可用的消息。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例BOOL ret;MSG_FILTER_STRUCT Filter;CMN_ERROR Error;/重新設(shè)置過(guò)濾器結(jié)構(gòu) memset( &Filter, 0, sizeof( MSG_FILTER_STRUCT ) ); /設(shè)置過(guò)濾器名稱(chēng) strcpy( Filt

20、er.szFilterName, Control1);/ 挑選選擇元素 Filter.dwFilter = MSG_FILTER_NR_FROM | MSG_FILTER_NR_TO;/ 消息號(hào)來(lái)自 Filter.dwMsgNr0 = 2;/ 消息號(hào)來(lái)自 Filter.dwMsgNr1 = 2;ret = AXC_SetFilter(gs_alarm_00,Control1,&Filter,&Error);1. 命名該過(guò)濾器。2. 選擇過(guò)濾器的類(lèi)型。3. 指定過(guò)濾器標(biāo)準(zhǔn)。4. 設(shè)置過(guò)濾器。常規(guī)使用注釋過(guò)濾器類(lèi)型和過(guò)濾器標(biāo)準(zhǔn)必須適合使用；在過(guò)濾器結(jié)構(gòu)中描述所有其它的過(guò)濾器類(lèi)型。 使用標(biāo)準(zhǔn)函數(shù)操作

21、WinCC報(bào)警控件的實(shí)例BOOL ret;MSG_FILTER_STRUCT Filter;CMN_ERROR Error;/刪除整個(gè)過(guò)濾器結(jié)構(gòu) memset( &Filter, 0, sizeof( MSG_FILTER_STRUCT ) ); /設(shè)置空的過(guò)濾器結(jié)構(gòu) AXC_SetFilter(gs_alarm_00,Control 1,&Filter,&Error);1. 刪除該過(guò)濾器結(jié)構(gòu)。2. 用空值填充過(guò)濾器結(jié)構(gòu)。 結(jié)構(gòu)定義MSG_FILTER_STRUCTtypedef struct CHAR szFilterNameMSG_MAX_TEXTLEN+1;WORD dwFilter;S

22、YSTEMTIME st2;DWORD dwMsgNr2;DWORD dwMsgClass;DWORD dwMsgTypeMSG_MAX_CLASS;DWORD dwMsgState;WORD wAGNr2;WORD wAGSubNr2;DWORD dwArchivMode;char szTBMSG_MAX_TBMSG_MAX_TB_CONTENT+1DWORD dwTB;Double dPValueMSG_MAX_PVALUE2;DWORD dwPValue2;DWORD dwMsgCounter2;DWORD dwQuickSelect;MSG_FILTER_STRUCT;描述在該結(jié)構(gòu)中定

23、義過(guò)濾標(biāo)準(zhǔn)。組成部分dwFilter通過(guò)下列常數(shù)從“m_global.h”文件定義過(guò)濾條件： MSG_FILTER_DATE_FROM 從日期 MSG_FILTER_DATE_TO 到日期 MSG_FILTER_TIME_FROM 從時(shí)間 MSG_FILTER_TIME_TO 到時(shí)間 MSG_FILTER_NR_FROM 從消息號(hào) MSG_FILTER_NR_TO 到消息號(hào) MSG_FILTER_CLASS 消息等級(jí) MSG_FILTER_STATE 消息狀態(tài) MSG_FILTER_AG_FROM 從AG號(hào) MSG_FILTER_AG_TO 到AG號(hào) MSG_FILTER_AGSUB_FROM

24、 從AG子號(hào) MSG_FILTER_AGSUB_TO 到AG子號(hào) MSG_FILTER_TEXT 消息文本 MSG_FILTER_PVALUE 過(guò)程值 MSG_FILTER_COUNTER_FROM 從內(nèi)部消息計(jì)數(shù)器 MSG_FILTER_COUNTER_TO 到內(nèi)部消息計(jì)數(shù)器 MSG_FILTER_PROCESSMSG 過(guò)程消息 MSG_FILTER_SYSMSG 系統(tǒng)消息 MSG_FILTER_BEDMSG 事件消息 MSG_FILTER_DATE 日期從.到. MSG_FILTER_TIME 日期從.到. MSG_FILTER_NR 消息號(hào)從.到.st日期/時(shí)間從.到.在這種情況下，st

25、0是開(kāi)始時(shí)間(從)，st1是結(jié)束時(shí)間(到)為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_DATE，MSG_FILTER_DATE_FROM，MSG_FILTER_DATE_TO， MSG_FILTER_TIME，MSG_FILTER_TIME_FROM和MSG_FILTER_TIME_TO如果傳送SYSTEMTIME參數(shù)要求當(dāng)前時(shí)間，使用GetLocalTime函數(shù)而非GetSystemTime。通常這兩個(gè)函數(shù)之間的時(shí)間差別很大。dwMsgNr消息號(hào)從.到.在這種情況下，dwMsgNr0是開(kāi)始號(hào)(從)，dwMsgNr1是結(jié)束號(hào)(到)為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_NR，MSG_FIL

26、TER_NR_FROM和MSG_FILTER_NR_TOdwMsgClass位代碼消息等級(jí)為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_CLASSdwMsgType每個(gè)消息等級(jí)的位代碼消息類(lèi)型為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_CLASSdwMsgState位代碼消息狀態(tài)為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_STATEwAGNrAG號(hào)從.到.為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_AG_FROM和MSG_FILTER_AG_TOwAGSubNrAGSubNr從.到為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TOdwArch

27、ivMode歸檔/協(xié)議識(shí)別必須用0填充。szTB文本塊文本為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_TEXTdwTB文本塊激活(從.到.，位代碼)為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_TEXTdPValue過(guò)程值從.到.為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_PVALUEdwPValue過(guò)程值激活(從.到. 位代碼)為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_PVALUEdwMsgCounter內(nèi)部消息計(jì)數(shù)器從.到.為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_COUNTER_FROM，MSG_FILTER_COUNTER_TOdwQuickSelect快速選擇小時(shí)，天，月為以后擴(kuò)展

28、而保留該參數(shù)，并且必須用0預(yù)定義。為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_QUICKSELECTLOWORD類(lèi)型： MSG_FILTER_QUICK_MONTH 快速選擇后n個(gè)月 MSG_FILTER_QUICK_DAYS 快速選擇后n天 MSG_FILTER_QUICK_HOUR 快速選擇后n個(gè)小時(shí)HIWORD號(hào)：1.n快速選擇函數(shù)的結(jié)束時(shí)間與本地計(jì)算機(jī)的當(dāng)前系統(tǒng)時(shí)間有關(guān)。開(kāi)始時(shí)間是n * (往回計(jì)算月，日，小時(shí))。 結(jié)構(gòu)定義CMNERRORstruct CMNERRORSTRUCT DWORD dwError1,DWORD dwError2,DWORD dwError3,DWORD d

29、wError4,DWORD dwError5;TCHAR szErrorTextMAX_ERROR_LEN;CMNERROR描述擴(kuò)展的錯(cuò)誤結(jié)構(gòu)包含錯(cuò)誤代碼和與發(fā)生的錯(cuò)誤相關(guān)的錯(cuò)誤文本。每個(gè)應(yīng)用程序可以使用該錯(cuò)誤結(jié)構(gòu)評(píng)價(jià)或發(fā)出錯(cuò)誤消息。組成部分dwError1 . dwError5可按API函數(shù)的要求使用這些條目。API描述包含出錯(cuò)時(shí)條目的各自數(shù)值。否則，錯(cuò)誤代碼在dwError1中。szErrorText錯(cuò)誤代碼的文本描述緩沖區(qū)從資源建立該內(nèi)容，因此依賴于語(yǔ)言。 BOOL GMsgFunction(char* pszMsgData)函數(shù)該函數(shù)提供消息數(shù)據(jù)。表示單個(gè)消息的全局函數(shù)。為每個(gè)消息調(diào)用

30、全局函數(shù)，為每個(gè)消息設(shè)置“觸發(fā)動(dòng)作”參數(shù)。最好在項(xiàng)目函數(shù)中解釋消息數(shù)據(jù)，從GMsgFunction調(diào)用項(xiàng)目函數(shù)。參數(shù)pszMsgData指向在其中存儲(chǔ)消息數(shù)據(jù)的緩沖區(qū)的指針。返回值TRUE已執(zhí)行函數(shù)，無(wú)錯(cuò)。FALSE出錯(cuò)。注意請(qǐng)注意，WinCC安裝會(huì)重寫(xiě)已修改的標(biāo)準(zhǔn)函數(shù)，所以被改變的函數(shù)丟失。 Graphics - 簡(jiǎn)短描述Graphics組包含用于編程圖形系統(tǒng)的函數(shù)。1char* GetLinkedVariable(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName)函數(shù)，提供與指定的對(duì)象屬性鏈接的變量的名稱(chēng)

31、。讀出直接連接的變量名的實(shí)例。char* pszVarName = NULL;char szVarName_MAX_PATH+1;/獲得變量名 pszVarName = GetLinkedVariable(gs_stand_graph_00,Static Text 6,Visible);/復(fù)制字符串 if (pszVarName != NULL) strncpy(szVarName,pszVarName,_MAX_PATH);/自定義代碼/在那里用戶可以使用返回值做某事.GetLinkedVariable函數(shù)參數(shù)：“gs_stand_graph_00”是在其中組態(tài)該對(duì)象的畫(huà)面的名稱(chēng)?！癝tat

32、ic Text 6”是該對(duì)象的名稱(chēng)。“Visible”是鏈接到變量的屬性。1）. 將函數(shù)GetLinkedVariable的返回值緩沖存儲(chǔ)在pszVarName中。2）. 如果返回有效數(shù)值，將該返回值存儲(chǔ)在szVarName中。最多存儲(chǔ)_MAX_PATH個(gè)字符。3）. 執(zhí)行處理返回值的自定義代碼。 2char* GetLocalPicture(char* lpszPictureName)函數(shù)，返回指向畫(huà)面名的指針。 在這種情況下，畫(huà)面名就是該文件名，不帶擴(kuò)展名“.PDL”。讀出本地畫(huà)面的實(shí)例。char* pszPicName = NULL;char szPicName_MAX_PATH+1;/

33、獲得本地畫(huà)面 pszPicName = GetLocalPicture(lpszPictureName);/復(fù)制字符串 if (pszPicName != NULL) strncpy(szPicName,pszPicName,_MAX_PATH);/自定義代碼/在那里用戶可以使用返回值做某事.1). 將函數(shù)GetLocalPicture的返回值緩沖存儲(chǔ)在pszPicName中。2). 如果返回有效數(shù)值，將該返回值存儲(chǔ)在szPicName中。最多存儲(chǔ)_MAX_PATH個(gè)字符。3). 執(zhí)行處理返回值的自定義代碼。 3.char* GetParentPicture(char* lpszPicture

34、Name)函數(shù),返回指向畫(huà)面名稱(chēng)的指針。 在這種情況下，畫(huà)面名就是該文件名，不帶擴(kuò)展名“.PDL”。讀出畫(huà)面名稱(chēng)路徑的實(shí)例char* pszPicName = NULL;char szPicName_MAX_PATH+1;/獲得母畫(huà)面 pszPicName = GetParentPicture(lpszPictureName);/復(fù)制字符串 if (pszPicName != NULL) strncpy(szPicName,pszPicName,_MAX_PATH);/自定義代碼/在那里用戶可以使用返回值做某事.1). 將該函數(shù)GetParentPicture的返回值緩沖存儲(chǔ)在pszPicNa

35、me中。2). 如果返回有效數(shù)值，將該返回值存儲(chǔ)在szPicName中。. 最多存儲(chǔ)_MAX_PATH個(gè)字符。3). 執(zhí)行處理返回值的自定義代碼。 4.char* GetParentPictureWindow(char* lpszPictureName)函數(shù),返回指向畫(huà)面窗口的名稱(chēng)的指針。實(shí)例：基本畫(huà)面“Picture_1”有畫(huà)面窗口“Picture Window_1”，在其中調(diào)用畫(huà)面“Picture_2”。畫(huà)面“Picture_2”有畫(huà)面窗口“Picture Window_2”，在其中調(diào)用畫(huà)面“Picture_3”。該函數(shù)調(diào)用GetParentPictureWindow(lpszPictur

36、eName)指向畫(huà)面窗口名稱(chēng)的指針：“Picture_2”，是否從畫(huà)面“Picture_3”調(diào)用該函數(shù)?！癙icture Window_1”，是否從畫(huà)面“Picture_2”調(diào)用該函數(shù)?！癙icture_1”，是否從畫(huà)面“Picture_1”調(diào)用該函數(shù)。 5. void OpenPicture(Picture Name)函數(shù),用設(shè)置的畫(huà)面名打開(kāi)畫(huà)面。6. char* Registry2(char* mode, char* String0, char* String1)函數(shù),該函數(shù)管理字符串對(duì)(String0，String1)的列表。 Report - 簡(jiǎn)短描述Report組包含用來(lái)啟動(dòng)打印作業(yè)

37、的打印預(yù)覽或打印輸出本身的函數(shù)。1. void ReportJob(LPSTR lpJobName, LPSTR lpMethodName)函數(shù),根據(jù)參數(shù)lpMethodName的數(shù)值，決定啟動(dòng)打印作業(yè)或打印預(yù)覽。RPTJobPreview和RPTJobPrint, 打印作業(yè)被啟動(dòng)和打印作業(yè)的預(yù)覽被啟動(dòng)2. BOOL RPTJobPreview(LPSTR lpJobName)函數(shù),打印作業(yè)的預(yù)覽被啟動(dòng)。啟動(dòng)作業(yè)預(yù)覽的實(shí)例/啟動(dòng)指定打印作業(yè)的打印預(yù)覽RPTJobPreview(Documentation Text Library);RPTJobPreview函數(shù)參數(shù)：Text library

38、(compact)是打印作業(yè)的名稱(chēng)。 3. BOOL RPTJobPrint(LPSTR lpJobName)函數(shù),打印作業(yè)被啟動(dòng)。啟動(dòng)打印作業(yè)的實(shí)例/打印輸出指定的打印作業(yè)RPTJobPrint(Text library (compact);RPTJobPrint函數(shù)參數(shù)：Text library (compact)是打印作業(yè)的名稱(chēng)。 4. void RptShowError(LPCSTR pszFailedFunction, CMN_ERRORA* pCmnErrorA)函數(shù),該函數(shù)提供對(duì)失敗的打印作業(yè)的錯(cuò)誤描述。該函數(shù)調(diào)用是標(biāo)準(zhǔn)函數(shù)RptJobPrint和RptJobPreview的組成

39、部分，因此不要求單個(gè)調(diào)用命令。結(jié)構(gòu)定義CMNERROR struct CMNERRORSTRUCT DWORD dwError1,DWORD dwError2,DWORD dwError3,DWORD dwError4,DWORD dwError5;TCHAR szErrorTextMAX_ERROR_LEN;CMNERROR描述擴(kuò)展的錯(cuò)誤結(jié)構(gòu)包含錯(cuò)誤代碼和與發(fā)生的錯(cuò)誤相關(guān)的錯(cuò)誤文本。每個(gè)應(yīng)用程序可以使用該錯(cuò)誤結(jié)構(gòu)評(píng)價(jià)或發(fā)出錯(cuò)誤消息。組成部分dwError1 . dwError5可按API函數(shù)的要求使用這些條目。API描述包含出錯(cuò)時(shí)條目的各自數(shù)值。否則，錯(cuò)誤代碼在dwError1中。szErr

40、orText錯(cuò)誤代碼的文本描述緩沖區(qū)從資源建立該內(nèi)容，因此依賴于語(yǔ)言。TagLog - 簡(jiǎn)短描述TagLog函數(shù)包含控制WinCC表格控件和WinCC趨勢(shì)控件的函數(shù)。Template子組包含調(diào)用某些控制值的函數(shù)。Toolbar Buttons子組包含用于工具欄中每個(gè)按鈕的標(biāo)準(zhǔn)函數(shù)。 這些函數(shù)可用來(lái)創(chuàng)建自定義工具欄，例如選擇畫(huà)面，或者定義控件上的設(shè)置。1. int TlgGetColumnPosition(char* lpszTemplate)函數(shù),以表格窗口中的列指針的當(dāng)前位置作為列索引。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例char text5;long int columns /獲得列數(shù)

41、 columns = GetNumberOfColumns(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符 sprintf(text,%d,columns);/在Text Field 5 SetText上設(shè)置文本(lpszPictureName,Static Text 5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“Table Control_01”是WinCC表格控件的名稱(chēng)。1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2). 將返回值緩沖存儲(chǔ)在String text中。3). 在靜態(tài)文本域中發(fā)出返回值。 2. int

42、 TlgGetNumberOfColumns(char* lpszTemplate)函數(shù),在表格窗口中給出列的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱(chēng)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例char text5;long int columns /獲得列數(shù) columns = GetNumberOfColumns(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符 sprintf(text,%d,columns);/在Text Field 5 SetText上設(shè)置文本(lpszPictureName,Static Text 5,text);TlgGetN

43、umberOfColumns函數(shù)參數(shù)：“Table Control_01”是WinCC表格控件的名稱(chēng)。1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2). 將返回值緩沖存儲(chǔ)在String text中。3). 在靜態(tài)文本域中發(fā)出返回值。 3. int TlgGetNumberOfRows(char* lpszTemplate)函數(shù),在表格窗口中給出行的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱(chēng)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例char text5;long int rows;/獲得行數(shù) rows = TlgG

44、etNumberOfRows(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符 sprintf(text,%d,rows);/在Text Field 5 SetText上設(shè)置文本(lpszPictureName,Static Text 5,text);TlgGetNumberOfRows函數(shù)參數(shù)：Table Control_01是WinCC表格控件的名稱(chēng)。1). 將函數(shù)TlgGetNumberOfRows的返回值緩沖存儲(chǔ)在rows中。2). 將返回值緩沖存儲(chǔ)在String text中。3). 在靜態(tài)文本域中發(fā)出返回值。 4. int TlgGetNumberOfTrends(char* l

45、pszTemplate)函數(shù),在趨勢(shì)窗口中給出趨勢(shì)的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口的名稱(chēng)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例char text5;long int columns /獲得列數(shù) columns = GetNumberOfColumns(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符 sprintf(text,%d,columns);/在Text Field 5 SetText上設(shè)置文本(lpszPictureName,Static Text 5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“Table Con

46、trol_01”是WinCC表格控件的名稱(chēng)。1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2). 將返回值緩沖存儲(chǔ)在String text中。3). 在靜態(tài)文本域中發(fā)出返回值。 5. int TlgGetRowPosition(char* lpszTemplate)函數(shù),在表格窗口中給出行指針的當(dāng)前位置。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱(chēng)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例char text5;long int columns /獲得列數(shù) columns = GetNumberOfColumns(Table

47、Control_01);/轉(zhuǎn)換長(zhǎng)整型為字符 sprintf(text,%d,columns);/在Text Field 5 SetText上設(shè)置文本(lpszPictureName,Static Text 5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“Table Control_01”是WinCC表格控件的名稱(chēng)。1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2). 將返回值緩沖存儲(chǔ)在String text中。3). 在靜態(tài)文本域中發(fā)出返回值。 6. char* TlgGetRulerArchivNameTrend(char*

48、 lpszTemplate, int nTrend)函數(shù),在趨勢(shì)窗口中這個(gè)標(biāo)尺位置上給出帶編號(hào)nTrend的趨勢(shì)的歸擋名稱(chēng)。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口的名稱(chēng)。使用標(biāo)準(zhǔn)函數(shù)操作WinCC趨勢(shì)控件的實(shí)例char* pszVarName = NULL;char szVarName20;/獲得標(biāo)尺變量名 pszVarName = TlgGetRulerVariableNameTrend(TrendControl_01,0);if (pszVarName != NULL) / 復(fù)制字符串 strncpy(szVarName,pszVarName,19); /輸出變量

49、名 SetText(lpszPictureName,Static Text 6,szVarName);TlgGetRulerVariableNameTrend函數(shù)參數(shù)：“Trend Control_01”是WinCC趨勢(shì)控件的名稱(chēng)?！?”是該趨勢(shì)的編號(hào)。1). 將函數(shù)TlgGetRulerVariableNameTrend的返回值緩沖存儲(chǔ)在pszVarName中。2). 如果返回有效數(shù)值，將返回值復(fù)制到szVarName中。3). 在靜態(tài)文本域中發(fā)出返回值。 7. SYSTEMTIME TlgGetRulerTimeTrend(char* lpszTemplate, int nTrend)函數(shù)

50、,在趨勢(shì)窗口中這個(gè)標(biāo)尺位置上給出帶編號(hào)nTrend的趨勢(shì)的時(shí)間。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口。使用標(biāo)準(zhǔn)函數(shù)操作WinCC趨勢(shì)控件的實(shí)例SYSTEMTIME systime;WORD wHour;WORD wMin;WORD wSec;char szTime10;/獲得當(dāng)前系統(tǒng)時(shí)間 systime = TlgGetRulerTimeTrend(TrendControl_01,0);/獲得小時(shí) wHour = systime.wHour;/獲得分鐘 wMin = systime.wMinute;/獲得秒 wSec = systime.wSecond;/sprintf(szTime,%d:%d:%d,wHour,wMin,wSec);/輸出變量名 SetText(lpszPictureName,Static Text 7,szTime);1).