wincc標準函數(shù)介紹

1、標準函數(shù)該系統(tǒng)包含標準函數(shù)。可以按需要修改這些函數(shù)。此外，還可以自己創(chuàng)建標準函數(shù)。該系統(tǒng)包括一個標準函數(shù)集。一、Alarm-簡短描述Alarm組包含控制WinCC報警控件的函數(shù)。標準函數(shù)可用于工具欄中的每一個按鈕。這些函數(shù)可用來創(chuàng)建自定義工具欄，例如選擇畫面,或者定義控件上的設置。1voidAcknowledgeMessage(DWORDMsgNr)函數(shù)，確認消息系統(tǒng)中帶編號的消息，該編號被傳遞為參數(shù)。使用標準函數(shù)操作WinCC報警控件的實例/確認選擇的報警記錄消息AcknowledgeMessage(GetTagWord(U08i_MsgNr);指定待確認的消息號。在本例中是從變量讀取的。2

2、BOOLAXC_OnBtnArcLong(char*lpszPictureName,char*pszMsgWin)函數(shù)，在消息窗口中該函數(shù)表示消息存儲在長期歸檔中。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。3BOOLAXC_OnBtnArcShort(char*lpszPictureName,char*pszMsgWin

3、)函數(shù)，在消息窗口中該函數(shù)表示消息存儲在短期歸檔中。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。Control1是WinCC報警控件的對象名。4BOOLAXC_OnBtnComment(char*lpszPictureName,char*pszMsgWin)函數(shù)外部消息窗口操作，該函數(shù)顯示先前所選消息的注釋。使用標準函數(shù)操

4、作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。5BOOLAXC_OnBtnEmergAckn(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，此函數(shù)打開確認對話框(緊急確認/復位)。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFir

5、st(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。6BOOLAXC_OnBtnHornAckn(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)確認蜂鳴器信號。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_0

6、0”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。7BOOLAXC_OnBtnInfo(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)顯示信息文本。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。7BOOLAXC_OnBtnLo

7、ck(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)打開“設置鎖定”對話框。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。8BOOLAXC_OnBtnLockUnlock(char*lpszPictureName,char*pszMsgWin)，函數(shù)，該函數(shù)鎖住在消息窗

8、口中選擇的消息。之后，不再歸檔該消息。該函數(shù)釋放在鎖定列表中選擇的消息。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。9BOOLAXC_OnBtnLockWin(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作.該函數(shù)調用鎖定列表。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到

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

10、1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。11BOOLAXC_OnBtnMsgFirst(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表的開始處。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件

11、的畫面的名稱。Control1是WinCC報警控件的對象名。12BOOLAXC_OnBtnMsgLast(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表的結束處。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的最后一條消息AXC_OnBtnMsgLast(gs_alarm_00,Control1);AXC_OnBtnMsgLast函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。13BOOLAXC_OnBtnMsgNext(ch

12、ar*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表中的下一條消息。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。14BOOLAXC_OnBtnMsgPrev(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動

13、到消息列表中的前一條消息。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。15BOOLAXC_OnBtnMsgWin(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)調用過程消息窗口。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_O

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

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

16、OLAXC_OnBtnSelect(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)打開“設置選擇”對話框。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinCC報警控件中的第一條消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。19BOOLAXC_OnBtnSinglAckn(char*lpszPictureName,char*pszMsgWi

17、n)函數(shù)，外部消息窗口操作，該函數(shù)確認當前所選的消息。使用標準函數(shù)操作WinCC報警控件的實例/確認激活的消息AXC_OnBtnSinglAckn(gs_alarm_00,Control1);AXC_OnBtnSinglAckn函數(shù)參數(shù)：“gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。Control1是WinCC報警控件的對象名。20BOOLAXC_OnBtnVisibleAckn(char*lpszPictureName,char*pszMsgWin)函數(shù)，外部消息窗口操作，確認消息窗口中可見的全部消息(組確認)。使用標準函數(shù)操作WinCC報警控件的實例/跳轉到WinC

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

19、數(shù)操作WinCC報警控件的實例BOOLret;MSG_FILTER_STRUCTFilter;CMN_ERRORError;/重新設置過濾器結構memset(&Filter,0,sizeof(MSG_FILTER_STRUCT);/設置過濾器名稱strcpy(Filter.szFilterName,Control1);/挑選選擇元素Filter.dwFilter=MSG_FILTER_NR_FROM|MSG_FILTER_NR_TO;/消息號來自Filter.dwMsgNr0=2;/消息號來自Filter.dwMsgNr1=2;ret=AXC_SetFilter(gs_alarm_00,Con

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

21、值填充過濾器結構。結構定義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;描述在該結構中定義過濾標準。組成部分dwFilter通過下列常數(shù)從“m_global.h”文件定義過濾條件： MSG_FILTER_DATE_FROM 從日期 MSG_FILTER_DATE_TO 到日期 MSG_FILTER_TIME_FROM 從時間 MSG_FILTER_TIME_TO 到時間 MSG_FILTER_NR_FROM 從消息號 MSG_FILTER_NR_TO 到消息號 MSG_FILTER_CLASS 消息等級 MSG_FILTER_S

23、TATE 消息狀態(tài) MSG_FILTER_AG_FROM 從AG號 MSG_FILTER_AG_TO 到AG號 MSG_FILTER_AGSUB_FROM 從AG子號 MSG_FILTER_AGSUB_TO 到AG子號 MSG_FILTER_TEXT 消息文本 MSG_FILTER_PVALUE 過程值 MSG_FILTER_COUNTER_FROM 從內部消息計數(shù)器 MSG_FILTER_COUNTER_TO 到內部消息計數(shù)器 MSG_FILTER_PROCESSMSG 過程消息 MSG_FILTER_SYSMSG 系統(tǒng)消息 MSG_FILTER_BEDMSG 事件消息 MSG_FILTER

24、_DATE 日期從.到. MSG_FILTER_TIME 日期從.到. MSG_FILTER_NR 消息號從.到.st日期/時間從.到.在這種情況下，st0是開始時間(從)，st1是結束時間(到)為過濾標準填充這些域：MSG_FILTER_DATE，MSG_FILTER_DATE_FROM，MSG_FILTER_DATE_TO，MSG_FILTER_TIME，MSG_FILTER_TIME_FROM和MSG_FILTER_TIME_TO如果傳送SYSTEMTIME參數(shù)要求當前時間，使用GetLocalTime函數(shù)而非GetSystemTime。通常這兩個函數(shù)之間的時間差別很大。dwMsgNr消

25、息號從.到.在這種情況下，dwMsgNr0是開始號(從)，dwMsgNr1是結束號(到)為過濾標準填充這些域：MSG_FILTER_NR，MSG_FILTER_NR_FROM和MSG_FILTER_NR_TOdwMsgClass位代碼消息等級為過濾標準填充這個域：MSG_FILTER_CLASSdwMsgType每個消息等級的位代碼消息類型為過濾標準填充這個域：MSG_FILTER_CLASSdwMsgState位代碼消息狀態(tài)為過濾標準填充這個域：MSG_FILTER_STATEwAGNrAG號從.到.為過濾標準填充這些域：MSG_FILTER_AG_FROM和MSG_FILTER_AG_TO

26、wAGSubNrAGSubNr從.到為過濾標準填充這些域：MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TOdwArchivMode歸檔/協(xié)議識別必須用0填充。szTB文本塊文本為過濾標準填充這個域：MSG_FILTER_TEXTdwTB文本塊激活(從.到.，位代碼)為過濾標準填充這個域：MSG_FILTER_TEXTdPValue過程值從.到.為過濾標準填充這個域：MSG_FILTER_PVALUEdwPValue過程值激活(從.到.位代碼)為過濾標準填充這個域：MSG_FILTER_PVALUEdwMsgCounter內部消息計數(shù)器從.到.為過濾標準填充這些

27、域：MSG_FILTER_COUNTER_FROM，MSG_FILTER_COUNTER_TOdwQuickSelect快速選擇小時，天，月為以后擴展而保留該參數(shù)，并且必須用0預定義。為過濾標準填充這個域：MSG_FILTER_QUICKSELECTLOWORD類型： MSG_FILTER_QUICK_MONTH 快速選擇后n個月 MSG_FILTER_QUICK_DAYS 快速選擇后n天 MSG_FILTER_QUICK_HOUR 快速選擇后n個小時HIWORD號：1.n快速選擇函數(shù)的結束時間與本地計算機的當前系統(tǒng)時間有關。開始時間是n*(往回計算月，日，小時)。結構定義CMNERRORst

28、ructCMNERRORSTRUCTDWORDdwError1,DWORDdwError2,DWORDdwError3,DWORDdwError4,DWORDdwError5;TCHARszErrorTextMAX_ERROR_LEN;CMNERROR描述擴展的錯誤結構包含錯誤代碼和與發(fā)生的錯誤相關的錯誤文本。每個應用程序可以使用該錯誤結構評價或發(fā)出錯誤消息。組成部分dwError1.dwError5可按API函數(shù)的要求使用這些條目。API描述包含出錯時條目的各自數(shù)值。否則，錯誤代碼在dwError1中。szErrorText錯誤代碼的文本描述緩沖區(qū)從資源建立該內容，因此依賴于語言。BOOLG

29、MsgFunction(char*pszMsgData)函數(shù)該函數(shù)提供消息數(shù)據(jù)。表示單個消息的全局函數(shù)。為每個消息調用全局函數(shù)，為每個消息設置“觸發(fā)動作”參數(shù)。最好在項目函數(shù)中解釋消息數(shù)據(jù)，從GMsgFunction調用項目函數(shù)。參數(shù)pszMsgData指向在其中存儲消息數(shù)據(jù)的緩沖區(qū)的指針。返回值TRUE已執(zhí)行函數(shù)，無錯。FALSE出錯。注意請注意，WinCC安裝會重寫已修改的標準函數(shù)，所以被改變的函數(shù)丟失。Graphics-簡短描述Graphics組包含用于編程圖形系統(tǒng)的函數(shù)。1char*GetLinkedVariable(char*lpszPictureName,char*lpszObje

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

31、stand_graph_00”是在其中組態(tài)該對象的畫面的名稱?！癝taticText6”是該對象的名稱?！癡isible”是鏈接到變量的屬性。1）.將函數(shù)GetLinkedVariable的返回值緩沖存儲在pszVarName中。2）.如果返回有效數(shù)值，將該返回值存儲在szVarName中。最多存儲_MAX_PATH個字符。3）.執(zhí)行處理返回值的自定義代碼。2char*GetLocalPicture(char*lpszPictureName)函數(shù)，返回指向畫面名的指針。在這種情況下，畫面名就是該文件名，不帶擴展名“.PDL”。讀出本地畫面的實例。char*pszPicName=NULL;cha

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

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

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

35、稱的指針：“Picture_2”，是否從畫面“Picture_3”調用該函數(shù)。“PictureWindow_1”，是否從畫面“Picture_2”調用該函數(shù)。“Picture_1”，是否從畫面“Picture_1”調用該函數(shù)。5.voidOpenPicture(PictureName)函數(shù),用設置的畫面名打開畫面。6.char*Registry2(char*mode,char*String0,char*String1)函數(shù),該函數(shù)管理字符串對(String0，String1)的列表。Report-簡短描述Report組包含用來啟動打印作業(yè)的打印預覽或打印輸出本身的函數(shù)。1.voidReport

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

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

38、rror1,DWORDdwError2,DWORDdwError3,DWORDdwError4,DWORDdwError5;TCHARszErrorTextMAX_ERROR_LEN;CMNERROR描述擴展的錯誤結構包含錯誤代碼和與發(fā)生的錯誤相關的錯誤文本。每個應用程序可以使用該錯誤結構評價或發(fā)出錯誤消息。組成部分dwError1.dwError5可按API函數(shù)的要求使用這些條目。API描述包含出錯時條目的各自數(shù)值。否則，錯誤代碼在dwError1中。szErrorText錯誤代碼的文本描述緩沖區(qū)從資源建立該內容，因此依賴于語言。TagLog-簡短描述TagLog函數(shù)包含控制WinCC表格控

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

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

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

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

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

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

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

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

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

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

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

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

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