wincc標(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è)置。1voidAcknowledgeMessage(DWORDMsgNr)函數(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_MsgNr);指定待確認(rèn)的消息號(hào)。在本例中是從變量讀取的。2

2、BOOLAXC_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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。3BOOLAXC_OnBtnArcShort(char*lpszPictureName,char*pszMsgWin

3、)函數(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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。Control1是WinCC報(bào)警控件的對(duì)象名。4BOOLAXC_OnBtnComment(char*lpszPictureName,char*pszMsgWin)函數(shù)外部消息窗口操作，該函數(shù)顯示先前所選消息的注釋。使用標(biāo)準(zhǔn)函數(shù)操

4、作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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。5BOOLAXC_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)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFir

5、st(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。6BOOLAXC_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,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_0

6、0”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。7BOOLAXC_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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。7BOOLAXC_OnBtnLo

7、ck(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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。8BOOLAXC_OnBtnLockUnlock(char*lpszPictureName,char*pszMsgWin)，函數(shù)，該函數(shù)鎖住在消息窗

8、口中選擇的消息。之后，不再歸檔該消息。該函數(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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。9BOOLAXC_OnBtnLockWin(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作.該函數(shù)調(diào)用鎖定列表。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/跳轉(zhuǎn)到

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

10、1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。11BOOLAXC_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_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件

11、的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。12BOOLAXC_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ù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。13BOOLAXC_OnBtnMsgNext(ch

12、ar*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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。14BOOLAXC_OnBtnMsgPrev(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動(dòng)

13、到消息列表中的前一條消息。使用標(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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。15BOOLAXC_OnBtnMsgWin(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)調(diào)用過(guò)程消息窗口。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_O

14、nBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。16BOOLAXC_OnBtnPrint(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，打印機(jī)打印出符合在報(bào)警控件中定義的選擇標(biāo)準(zhǔn)的全部消息。WinCC報(bào)警控件的實(shí)例/跳轉(zhuǎn)到WinCC報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst

15、函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。17BOOLAXC_OnBtnScroll(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)激活水平和垂直滾動(dòng)功能。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/激活/取消激活滾動(dòng)功能AXC_OnBtnScroll(gs_alarm_00,Control1);AXC_OnBtnScroll函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。18BO

16、OLAXC_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_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。19BOOLAXC_OnBtnSinglAckn(char*lpszPictureName,char*pszMsgWi

17、n)函數(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à)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。20BOOLAXC_OnBtnVisibleAckn(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，確認(rèn)消息窗口中可見(jiàn)的全部消息(組確認(rèn))。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例/跳轉(zhuǎn)到WinC

18、C報(bào)警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報(bào)警控件的畫(huà)面的名稱。Control1是WinCC報(bào)警控件的對(duì)象名。21BOOLAXC_SetFilter(char*lpszPictureName,char*lpszObjectName,LPMSG_FILTER_STRUCTlpMsgFilter,LPCMN_ERROR,lpError)函數(shù)，外部消息窗口操作，該函數(shù)為WinCC報(bào)警控件設(shè)置過(guò)濾器，以便根據(jù)指定的過(guò)濾標(biāo)準(zhǔn)篩選出可用的消息。使用標(biāo)準(zhǔn)函

19、數(shù)操作WinCC報(bào)警控件的實(shí)例BOOLret;MSG_FILTER_STRUCTFilter;CMN_ERRORError;/重新設(shè)置過(guò)濾器結(jié)構(gòu)memset(&Filter,0,sizeof(MSG_FILTER_STRUCT);/設(shè)置過(guò)濾器名稱strcpy(Filter.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,Con

20、trol1,&Filter,&Error);1.命名該過(guò)濾器。2.選擇過(guò)濾器的類型。3.指定過(guò)濾器標(biāo)準(zhǔn)。4.設(shè)置過(guò)濾器。常規(guī)使用注釋過(guò)濾器類型和過(guò)濾器標(biāo)準(zhǔn)必須適合使用；在過(guò)濾器結(jié)構(gòu)中描述所有其它的過(guò)濾器類型。使用標(biāo)準(zhǔn)函數(shù)操作WinCC報(bào)警控件的實(shí)例BOOLret;MSG_FILTER_STRUCTFilter;CMN_ERRORError;/刪除整個(gè)過(guò)濾器結(jié)構(gòu)memset(&Filter,0,sizeof(MSG_FILTER_STRUCT);/設(shè)置空的過(guò)濾器結(jié)構(gòu)AXC_SetFilter(gs_alarm_00,Control1,&Filter,&Error);1.刪除該過(guò)濾器結(jié)構(gòu)。2.用空

21、值填充過(guò)濾器結(jié)構(gòu)。結(jié)構(gòu)定義MSG_FILTER_STRUCTtypedefstructCHARszFilterNameMSG_MAX_TEXTLEN+1;WORDdwFilter;SYSTEMTIMEst2;DWORDdwMsgNr2;DWORDdwMsgClass;DWORDdwMsgTypeMSG_MAX_CLASS;DWORDdwMsgState;WORDwAGNr2;WORDwAGSubNr2;DWORDdwArchivMode;charszTBMSG_MAX_TBMSG_MAX_TB_CONTENT+1DWORDdwTB;DoubledPValueMSG_MAX_PVALUE2;DW

22、ORDdwPValue2;DWORDdwMsgCounter2;DWORDdwQuickSelect;MSG_FILTER_STRUCT;描述在該結(jié)構(gòu)中定義過(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_S

23、TATE 消息狀態(tài) MSG_FILTER_AG_FROM 從AG號(hào) MSG_FILTER_AG_TO 到AG號(hào) MSG_FILTER_AGSUB_FROM 從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

24、_DATE 日期從.到. MSG_FILTER_TIME 日期從.到. MSG_FILTER_NR 消息號(hào)從.到.st日期/時(shí)間從.到.在這種情況下，st0是開(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消

25、息號(hào)從.到.在這種情況下，dwMsgNr0是開(kāi)始號(hào)(從)，dwMsgNr1是結(jié)束號(hào)(到)為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_NR，MSG_FILTER_NR_FROM和MSG_FILTER_NR_TOdwMsgClass位代碼消息等級(jí)為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_CLASSdwMsgType每個(gè)消息等級(jí)的位代碼消息類型為過(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_TO

26、wAGSubNrAGSubNr從.到為過(guò)濾標(biāo)準(zhǔn)填充這些域：MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TOdwArchivMode歸檔/協(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)填充這些

27、域：MSG_FILTER_COUNTER_FROM，MSG_FILTER_COUNTER_TOdwQuickSelect快速選擇小時(shí)，天，月為以后擴(kuò)展而保留該參數(shù)，并且必須用0預(yù)定義。為過(guò)濾標(biāo)準(zhǔn)填充這個(gè)域：MSG_FILTER_QUICKSELECTLOWORD類型： 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)定義CMNERRORst

28、ructCMNERRORSTRUCTDWORDdwError1,DWORDdwError2,DWORDdwError3,DWORDdwError4,DWORDdwError5;TCHARszErrorTextMAX_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ǔ)言。BOOLG

29、MsgFunction(char*pszMsgData)函數(shù)該函數(shù)提供消息數(shù)據(jù)。表示單個(gè)消息的全局函數(shù)。為每個(gè)消息調(diào)用全局函數(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*lpszObje

30、ctName,char*lpszPropertyName)函數(shù)，提供與指定的對(duì)象屬性鏈接的變量的名稱。讀出直接連接的變量名的實(shí)例。char*pszVarName=NULL;charszVarName_MAX_PATH+1;/獲得變量名pszVarName=GetLinkedVariable(gs_stand_graph_00,StaticText6,Visible);/復(fù)制字符串if(pszVarName!=NULL)strncpy(szVarName,pszVarName,_MAX_PATH);/自定義代碼/在那里用戶可以使用返回值做某事.GetLinkedVariable函數(shù)參數(shù)：“gs_

31、stand_graph_00”是在其中組態(tài)該對(duì)象的畫(huà)面的名稱?！癝taticText6”是該對(duì)象的名稱。“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;cha

32、rszPicName_MAX_PATH+1;/獲得本地畫(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*lp

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

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

35、稱的指針：“Picture_2”，是否從畫(huà)面“Picture_3”調(diào)用該函數(shù)。“PictureWindow_1”，是否從畫(huà)面“Picture_2”調(diào)用該函數(shù)?！癙icture_1”，是否從畫(huà)面“Picture_1”調(diào)用該函數(shù)。5.voidOpenPicture(PictureName)函數(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è)的打印預(yù)覽或打印輸出本身的函數(shù)。1.voidReport

36、Job(LPSTRlpJobName,LPSTRlpMethodName)函數(shù),根據(jù)參數(shù)lpMethodName的數(shù)值，決定啟動(dòng)打印作業(yè)或打印預(yù)覽。RPTJobPreview和RPTJobPrint,打印作業(yè)被啟動(dòng)和打印作業(yè)的預(yù)覽被啟動(dòng)2.BOOLRPTJobPreview(LPSTRlpJobName)函數(shù),打印作業(yè)的預(yù)覽被啟動(dòng)。啟動(dòng)作業(yè)預(yù)覽的實(shí)例/啟動(dòng)指定打印作業(yè)的打印預(yù)覽RPTJobPreview(DocumentationTextLibrary);RPTJobPreview函數(shù)參數(shù)：Textlibrary(compact)是打印作業(yè)的名稱。3.BOOLRPTJobPrint(LPSTR

37、lpJobName)函數(shù),打印作業(yè)被啟動(dòng)。啟動(dòng)打印作業(yè)的實(shí)例/打印輸出指定的打印作業(yè)RPTJobPrint(Textlibrary(compact);RPTJobPrint函數(shù)參數(shù)：Textlibrary(compact)是打印作業(yè)的名稱。4.voidRptShowError(LPCSTRpszFailedFunction,CMN_ERRORA*pCmnErrorA)函數(shù),該函數(shù)提供對(duì)失敗的打印作業(yè)的錯(cuò)誤描述。該函數(shù)調(diào)用是標(biāo)準(zhǔn)函數(shù)RptJobPrint和RptJobPreview的組成部分，因此不要求單個(gè)調(diào)用命令。結(jié)構(gòu)定義CMNERRORstructCMNERRORSTRUCTDWORDdwE

38、rror1,DWORDdwError2,DWORDdwError3,DWORDdwError4,DWORDdwError5;TCHARszErrorTextMAX_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ǔ)言。TagLog-簡(jiǎn)短描述TagLog函數(shù)包含控制WinCC表格控

39、件和WinCC趨勢(shì)控件的函數(shù)。Template子組包含調(diào)用某些控制值的函數(shù)。ToolbarButtons子組包含用于工具欄中每個(gè)按鈕的標(biāo)準(zhǔn)函數(shù)。這些函數(shù)可用來(lái)創(chuàng)建自定義工具欄，例如選擇畫(huà)面，或者定義控件上的設(shè)置。1.intTlgGetColumnPosition(char*lpszTemplate)函數(shù),以表格窗口中的列指針的當(dāng)前位置作為列索引。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例chartext5;longintcolumns/獲得列數(shù)columns=GetNumberOfColumns(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符sprintf(text,%d,columns)

40、;/在TextField5SetText上設(shè)置文本(lpszPictureName,StaticText5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“TableControl_01”是WinCC表格控件的名稱。1).將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2).將返回值緩沖存儲(chǔ)在Stringtext中。3).在靜態(tài)文本域中發(fā)出返回值。2.intTlgGetNumberOfColumns(char*lpszTemplate)函數(shù),在表格窗口中給出列的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。使

41、用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例chartext5;longintcolumns/獲得列數(shù)columns=GetNumberOfColumns(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符sprintf(text,%d,columns);/在TextField5SetText上設(shè)置文本(lpszPictureName,StaticText5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“TableControl_01”是WinCC表格控件的名稱。1).將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2).將返回值緩沖存儲(chǔ)在S

42、tringtext中。3).在靜態(tài)文本域中發(fā)出返回值。3.intTlgGetNumberOfRows(char*lpszTemplate)函數(shù),在表格窗口中給出行的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例chartext5;longintrows;/獲得行數(shù)rows=TlgGetNumberOfRows(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符sprintf(text,%d,rows);/在TextField5SetText上設(shè)置文本(lpszPictureName,StaticText5,text);T

43、lgGetNumberOfRows函數(shù)參數(shù)：TableControl_01是WinCC表格控件的名稱。1).將函數(shù)TlgGetNumberOfRows的返回值緩沖存儲(chǔ)在rows中。2).將返回值緩沖存儲(chǔ)在Stringtext中。3).在靜態(tài)文本域中發(fā)出返回值。4.intTlgGetNumberOfTrends(char*lpszTemplate)函數(shù),在趨勢(shì)窗口中給出趨勢(shì)的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口的名稱。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例chartext5;longintcolumns/獲得列數(shù)columns=GetNumberOfColum

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

45、表格窗口中給出行指針的當(dāng)前位置。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。使用標(biāo)準(zhǔn)函數(shù)操作WinCC表格控件的實(shí)例chartext5;longintcolumns/獲得列數(shù)columns=GetNumberOfColumns(TableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符sprintf(text,%d,columns);/在TextField5SetText上設(shè)置文本(lpszPictureName,StaticText5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“TableControl_01”是WinCC表格控件的名稱。1).將函

46、數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2).將返回值緩沖存儲(chǔ)在Stringtext中。3).在靜態(tài)文本域中發(fā)出返回值。6.char*TlgGetRulerArchivNameTrend(char*lpszTemplate,intnTrend)函數(shù),在趨勢(shì)窗口中這個(gè)標(biāo)尺位置上給出帶編號(hào)nTrend的趨勢(shì)的歸擋名稱。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口的名稱。使用標(biāo)準(zhǔn)函數(shù)操作WinCC趨勢(shì)控件的實(shí)例char*pszVarName=NULL;charszVarName20;/獲得標(biāo)尺變量名pszVarName=TlgGetRule

47、rVariableNameTrend(TrendControl_01,0);if(pszVarName!=NULL)/復(fù)制字符串strncpy(szVarName,pszVarName,19);/輸出變量名SetText(lpszPictureName,StaticText6,szVarName);TlgGetRulerVariableNameTrend函數(shù)參數(shù)：“TrendControl_01”是WinCC趨勢(shì)控件的名稱?！?”是該趨勢(shì)的編號(hào)。1).將函數(shù)TlgGetRulerVariableNameTrend的返回值緩沖存儲(chǔ)在pszVarName中。2).如果返回有效數(shù)值，將返回值復(fù)制到s

48、zVarName中。3).在靜態(tài)文本域中發(fā)出返回值。7.SYSTEMTIMETlgGetRulerTimeTrend(char*lpszTemplate,intnTrend)函數(shù),在趨勢(shì)窗口中這個(gè)標(biāo)尺位置上給出帶編號(hào)nTrend的趨勢(shì)的時(shí)間。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口。使用標(biāo)準(zhǔn)函數(shù)操作WinCC趨勢(shì)控件的實(shí)例SYSTEMTIMEsystime;WORDwHour;WORDwMin;WORDwSec;charszTime10;/獲得當(dāng)前系統(tǒng)時(shí)間systime=TlgGetRulerTimeTrend(TrendControl_01,0);/獲得小時(shí)wHour

49、=systime.wHour;/獲得分鐘wMin=systime.wMinute;/獲得秒wSec=systime.wSecond;/sprintf(szTime,%d:%d:%d,wHour,wMin,wSec);/輸出變量名SetText(lpszPictureName,StaticText7,szTime);1).讀出當(dāng)前系統(tǒng)時(shí)間。2).從SYSTEMTIME結(jié)構(gòu)讀出小時(shí)、分和秒。3).創(chuàng)建包含該時(shí)間的字符串。4).讀出當(dāng)前時(shí)間。8.doubleTlgGetRulerValueTrend(char*lpszTemplate,intnTrend)函數(shù),在趨勢(shì)窗口中這個(gè)標(biāo)尺位置上給出帶編號(hào)n

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

51、ableControl_01);/轉(zhuǎn)換長(zhǎng)整型為字符sprintf(text,%d,columns);/在TextField5SetText上設(shè)置文本(lpszPictureName,StaticText5,text);TlgGetNumberOfColumns函數(shù)參數(shù)：“TableControl_01”是WinCC表格控件的名稱。1).將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲(chǔ)在columns中。2).將返回值緩沖存儲(chǔ)在Stringtext中。3).在靜態(tài)文本域中發(fā)出返回值。6.char*TlgGetRulerArchivNameTrend(char*lpszTemplate,intnTrend)函數(shù),在趨勢(shì)窗口中這個(gè)標(biāo)尺位置上給出帶編號(hào)nTrend的趨勢(shì)的歸擋名稱。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢(shì)控件窗口的名稱。使用標(biāo)準(zhǔn)函數(shù)操作WinCC趨勢(shì)控件的實(shí)例char*pszVarName=NULL;charszVarName20;/獲得標(biāo)尺變量名pszVarName=TlgGetRulerVariableNameTrend(TrendControl_01,0);if(pszVarName!=NULL)/復(fù)制字符串strncpy(