|
該系統(tǒng)包含標準函數(shù)。 可以按需要修改這些函數(shù)。 此外，還可以自己創(chuàng)建標準函數(shù)。 該系統(tǒng)包括一個標準函數(shù)集。 一、Alarm - 簡短描述 Alarm組包含控制WinCC報警控件的函數(shù)。標準函數(shù)可用于工具欄中的每一個按鈕。這些函數(shù)可用來創(chuàng)建自定義工具欄，例如選擇畫面,或者定義控件上的設(shè)置。 1．void AcknowledgeMessage(DWORD MsgNr)函數(shù)，確認消息系統(tǒng)中帶編號的消息，該編號被傳遞為參數(shù)。 使用標準函數(shù)操作WinCC報警控件的實例 {//確認選擇的報警記錄消息 AcknowledgeMessage(GetTagWord("U08i_MsgNr")); } 指定待確認的消息號。在本例中是從變量讀取的。
2．BOOL AXC_OnBtnArcLong(char* lpszPictureName, char* pszMsgWin)函數(shù)，在消息窗口中該函數(shù)表示消息存儲在長期歸檔中。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
3．BOOL AXC_OnBtnArcShort(char* lpszPictureName, char* pszMsgWin)函數(shù)，在消息窗口中該函數(shù)表示消息存儲在短期歸檔中。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
4．BOOL AXC_OnBtnComment(char* lpszPictureName, char* pszMsgWin)函數(shù) 外部消息窗口操作，該函數(shù)顯示先前所選消息的注釋。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
5．BOOL AXC_OnBtnEmergAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，此函數(shù)打開確認對話框(緊急確認/復(fù)位)。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
6．BOOL AXC_OnBtnHornAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)確認蜂鳴器信號。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
7．BOOL AXC_OnBtnInfo(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)顯示信息文本。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
7．BOOL AXC_OnBtnLock(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)打開“設(shè)置鎖定”對話框。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
8．BOOL AXC_OnBtnLockUnlock(char* lpszPictureName, char* pszMsgWin)，函數(shù)，該函數(shù)鎖住在消息窗口中選擇的消息。之后，不再歸檔該消息。該函數(shù)釋放在鎖定列表中選擇的消息。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
9．BOOL AXC_OnBtnLockWin(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作.該函數(shù)調(diào)用鎖定列表。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
10．BOOL AXC_OnBtnLoop(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，此函數(shù)觸發(fā)所選消息的“報警回路”函數(shù)。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
11．BOOL AXC_OnBtnMsgFirst(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表的開始處。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
12．BOOL AXC_OnBtnMsgLast(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表的結(jié)束處。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的最后一條消息 AXC_OnBtnMsgLast("gs_alarm_00","Control1"); } AXC_OnBtnMsgLast函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
13．BOOL AXC_OnBtnMsgNext(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表中的下一條消息。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
14．BOOL AXC_OnBtnMsgPrev(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)移動到消息列表中的前一條消息。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
15．BOOL AXC_OnBtnMsgWin(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)調(diào)用過程消息窗口。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
16．BOOL AXC_OnBtnPrint(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，打印機打印出符合在報警控件中定義的選擇標準的全部消息。 WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
17．BOOL AXC_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報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
18．BOOL AXC_OnBtnSelect(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)打開“設(shè)置選擇”對話框。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
19．BOOL AXC_OnBtnSinglAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，該函數(shù)確認當(dāng)前所選的消息。 使用標準函數(shù)操作WinCC報警控件的實例 {// 確認激活的消息 AXC_OnBtnSinglAckn("gs_alarm_00","Control1"); } AXC_OnBtnSinglAckn函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
20．BOOL AXC_OnBtnVisibleAckn(char* lpszPictureName, char* pszMsgWin)函數(shù)，外部消息窗口操作，確認消息窗口中可見的全部消息(組確認)。 使用標準函數(shù)操作WinCC報警控件的實例 {// 跳轉(zhuǎn)到WinCC報警控件中的第一條消息 AXC_OnBtnMsgFirst("gs_alarm_00","Control1"); } AXC_OnBtnMsgFirst函數(shù)參數(shù)： “gs_alarm_00”是在其中組態(tài)WinCC報警控件的畫面的名稱。 Control 1是WinCC報警控件的對象名。
21．BOOL AXC_SetFilter(char* lpszPictureName, char* lpszObjectName, LPMSG_FILTER_STRUCT lpMsgFilter, LPCMN_ERROR, lpError)函數(shù)，外部消息窗口操作，該函數(shù)為WinCC報警控件設(shè)置過濾器，以便根據(jù)指定的過濾標準篩選出可用的消息。 使用標準函數(shù)操作WinCC報警控件的實例 {BOOL ret; MSG_FILTER_STRUCT Filter; CMN_ERROR Error; //重新設(shè)置過濾器結(jié)構(gòu) memset ( &Filter, 0, sizeof( MSG_FILTER_STRUCT ) ); //設(shè)置過濾器名稱 strcpy ( Filter.szFilterName, "Control1"); // 挑選選擇元素 Filter .dwFilter = MSG_FILTER_NR_FROM | MSG_FILTER_NR_TO; // 消息號來自 Filter .dwMsgNr[0] = 2; // 消息號來自 Filter .dwMsgNr[1] = 2; ret = AXC_SetFilter("gs_alarm_00","Control1",&Filter,&Error); } 1. 命名該過濾器。 2. 選擇過濾器的類型。 3. 指定過濾器標準。 4. 設(shè)置過濾器。 常規(guī)使用注釋 過濾器類型和過濾器標準必須適合使用；在過濾器結(jié)構(gòu)中描述所有其它的過濾器類型。 使用標準函數(shù)操作WinCC報警控件的實例 {BOOL ret; MSG_FILTER_STRUCT Filter; CMN_ERROR Error; //刪除整個過濾器結(jié)構(gòu) memset ( &Filter, 0, sizeof( MSG_FILTER_STRUCT ) ); //設(shè)置空的過濾器結(jié)構(gòu) AXC _SetFilter("gs_alarm_00","Control 1",&Filter,&Error); } 1. 刪除該過濾器結(jié)構(gòu)。 2. 用空值填充過濾器結(jié)構(gòu)。 結(jié)構(gòu)定義MSG_FILTER_STRUCT typedef struct { CHAR szFilterName[MSG_MAX_TEXTLEN+1]; WORD dwFilter; SYSTEMTIME st[2]; DWORD dwMsgNr[2]; DWORD dwMsgClass; DWORD dwMsgType[MSG_MAX_CLASS]; DWORD dwMsgState; WORD wAGNr[2]; WORD wAGSubNr[2]; DWORD dwArchivMode; char szTB[MSG_MAX_TB][ MSG_MAX_TB_CONTENT+1] DWORD dwTB; Double dPValue[MSG_MAX_PVALUE][2]; DWORD dwPValue[2]; DWORD dwMsgCounter[2]; DWORD dwQuickSelect; } MSG_FILTER_STRUCT; 描述 在該結(jié)構(gòu)中定義過濾標準。 組成部分 dwFilter 通過下列常數(shù)從“m_global.h”文件定義過濾條件：
st 日期/時間從...到... 在這種情況下，st[0]是開始時間(從)，st[1]是結(jié)束時間(到) 為過濾標準填充這些域：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)前時間，使用GetLocalTime函數(shù)而非GetSystemTime。通常這兩個函數(shù)之間的時間差別很大。 dwMsgNr 消息號從...到... 在這種情況下，dwMsgNr[0]是開始號(從)，dwMsgNr[1]是結(jié)束號(到) 為過濾標準填充這些域：MSG_FILTER_NR，MSG_FILTER_NR_FROM和MSG_FILTER_NR_TO dwMsgClass 位代碼消息等級 為過濾標準填充這個域：MSG_FILTER_CLASS dwMsgType 每個消息等級的位代碼消息類型 為過濾標準填充這個域：MSG_FILTER_CLASS dwMsgState 位代碼消息狀態(tài) 為過濾標準填充這個域：MSG_FILTER_STATE wAGNr AG號從...到... 為過濾標準填充這些域：MSG_FILTER_AG_FROM和MSG_FILTER_AG_TO wAGSubNr AGSubNr從...到 為過濾標準填充這些域：MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TO dwArchivMode 歸檔/協(xié)議識別 必須用0填充。 szTB 文本塊文本 為過濾標準填充這個域：MSG_FILTER_TEXT dwTB 文本塊激活(從...到...，位代碼) 為過濾標準填充這個域：MSG_FILTER_TEXT dPValue 過程值從...到... 為過濾標準填充這個域：MSG_FILTER_PVALUE dwPValue 過程值激活(從...到... 位代碼) 為過濾標準填充這個域：MSG_FILTER_PVALUE dwMsgCounter 內(nèi)部消息計數(shù)器從...到... 為過濾標準填充這些域：MSG_FILTER_COUNTER_FROM，MSG_FILTER_COUNTER_TO dwQuickSelect 快速選擇小時，天，月 為以后擴展而保留該參數(shù)，并且必須用0預(yù)定義。 為過濾標準填充這個域：MSG_FILTER_QUICKSELECT LOWORD類型：
HIWORD號：1...n 快速選擇函數(shù)的結(jié)束時間與本地計算機的當(dāng)前系統(tǒng)時間有關(guān)。開始時間是n * (往回計算月，日，小時)。 結(jié)構(gòu)定義CMNERROR struct CMNERRORSTRUCT { DWORD dwError1, DWORD dwError2, DWORD dwError3, DWORD dwError4, DWORD dwError5; TCHAR szErrorText[MAX_ERROR_LEN]; } CMNERROR 描述 擴展的錯誤結(jié)構(gòu)包含錯誤代碼和與發(fā)生的錯誤相關(guān)的錯誤文本。每個應(yīng)用程序可以使用該錯誤結(jié)構(gòu)評價或發(fā)出錯誤消息。 組成部分 dwError1 .. dwError5 可按API函數(shù)的要求使用這些條目。 API描述包含出錯時條目的各自數(shù)值。否則，錯誤代碼在dwError1中。 szErrorText 錯誤代碼的文本描述緩沖區(qū) 從資源建立該內(nèi)容，因此依賴于語言。 BOOL GMsgFunction(char* pszMsgData)函數(shù) 該函數(shù)提供消息數(shù)據(jù)。 表示單個消息的全局函數(shù)。為每個消息調(diào)用全局函數(shù)，為每個消息設(shè)置“觸發(fā)動作”參數(shù)。 最好在項目函數(shù)中解釋消息數(shù)據(jù)，從GMsgFunction調(diào)用項目函數(shù)。 參數(shù) pszMsgData 指向在其中存儲消息數(shù)據(jù)的緩沖區(qū)的指針。 返回值 TRUE 已執(zhí)行函數(shù)，無錯。 FALSE 出錯。 注意 請注意，WinCC安裝會重寫已修改的標準函數(shù)，所以被改變的函數(shù)丟失。
Graphics - 簡短描述 Graphics組包含用于編程圖形系統(tǒng)的函數(shù)。 1．char* GetLinkedVariable(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName)函數(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)該對象的畫面的名稱。 “Static Text 6”是該對象的名稱。 “Visible”是鏈接到變量的屬性。 1）. 將函數(shù)GetLinkedVariable的返回值緩沖存儲在pszVarName中。 2）. 如果返回有效數(shù)值，將該返回值存儲在szVarName中。最多存儲_MAX_PATH個字符。 3）. 執(zhí)行處理返回值的自定義代碼。
2．char* GetLocalPicture(char* lpszPictureName)函數(shù)，返回指向畫面名的指針。 在這種情況下，畫面名就是該文件名，不帶擴展名“.PDL”。 讀出本地畫面的實例。 {char* pszPicName = NULL; char szPicName[_MAX_PATH+1]; //獲得本地畫面 pszPicName = GetLocalPicture(lpszPictureName); //復(fù)制字符串 if (pszPicName != NULL) { strncpy(szPicName,pszPicName,_MAX_PATH); }//自定義代碼 //在那里用戶可以使用返回值做某事 ... } 1). 將函數(shù)GetLocalPicture的返回值緩沖存儲在pszPicName中。 2). 如果返回有效數(shù)值，將該返回值存儲在szPicName中。最多存儲_MAX_PATH個字符。 3). 執(zhí)行處理返回值的自定義代碼。
3.char* GetParentPicture(char* lpszPictureName)函數(shù),返回指向畫面名稱的指針。 在這種情況下，畫面名就是該文件名，不帶擴展名“.PDL”。 讀出畫面名稱路徑的實例 {char* pszPicName = NULL; char szPicName[_MAX_PATH+1]; //獲得母畫面 pszPicName = GetParentPicture(lpszPictureName); //復(fù)制字符串 if (pszPicName != NULL) {strncpy(szPicName,pszPicName,_MAX_PATH); }//自定義代碼 //在那里用戶可以使用返回值做某事 ...} 1). 將該函數(shù)GetParentPicture的返回值緩沖存儲在pszPicName中。 2). 如果返回有效數(shù)值，將該返回值存儲在szPicName中。。。。。. 最多存儲_MAX_PATH個字符。 3). 執(zhí)行處理返回值的自定義代碼。
4.char* GetParentPictureWindow(char* lpszPictureName)函數(shù),返回指向畫面窗口的名稱的指針。 實例： 基本畫面“Picture_1”有畫面窗口“Picture Window_1”，在其中調(diào)用畫面“Picture_2”。 畫面“Picture_2”有畫面窗口“Picture Window_2”，在其中調(diào)用畫面“Picture_3”。 該函數(shù)調(diào)用 GetParentPictureWindow(lpszPictureName) 指向畫面窗口名稱的指針： “Picture_2”，是否從畫面“Picture_3”調(diào)用該函數(shù)。 “Picture Window_1”，是否從畫面“Picture_2”調(diào)用該函數(shù)。 “Picture_1”，是否從畫面“Picture_1”調(diào)用該函數(shù)。
5. void OpenPicture(Picture Name)函數(shù),用設(shè)置的畫面名打開畫面。
6. char* Registry2(char* mode, char* String0, char* String1)函數(shù),該函數(shù)管理字符串對(String0，String1)的列表。
Report - 簡短描述 Report組包含用來啟動打印作業(yè)的打印預(yù)覽或打印輸出本身的函數(shù)。 1. void ReportJob(LPSTR lpJobName, LPSTR lpMethodName)函數(shù),根據(jù)參數(shù)lpMethodName的數(shù)值，決定啟動打印作業(yè)或打印預(yù)覽。 RPTJobPreview和RPTJobPrint, 打印作業(yè)被啟動和打印作業(yè)的預(yù)覽被啟動
2. BOOL RPTJobPreview(LPSTR lpJobName)函數(shù),打印作業(yè)的預(yù)覽被啟動。 啟動作業(yè)預(yù)覽的實例 {//啟動指定打印作業(yè)的打印預(yù)覽 RPTJobPreview("Documentation Text Library"); } RPTJobPreview函數(shù)參數(shù)： @Text library (compact)是打印作業(yè)的名稱。
3. BOOL RPTJobPrint(LPSTR lpJobName)函數(shù),打印作業(yè)被啟動。 啟動打印作業(yè)的實例 {//打印輸出指定的打印作業(yè) RPTJobPrint("@Text library (compact)"); } RPTJobPrint函數(shù)參數(shù)： @Text library (compact)是打印作業(yè)的名稱。
4. void RptShowError(LPCSTR pszFailedFunction, CMN_ERRORA* pCmnErrorA)函數(shù),該函數(shù)提供對失敗的打印作業(yè)的錯誤描述。該函數(shù)調(diào)用是標準函數(shù)RptJobPrint和RptJobPreview的組成部分，因此不要求單個調(diào)用命令。 結(jié)構(gòu)定義CMNERROR
struct CMNERRORSTRUCT { DWORD dwError1, DWORD dwError2, DWORD dwError3, DWORD dwError4, DWORD dwError5; TCHAR szErrorText[MAX_ERROR_LEN]; } CMNERROR描述 擴展的錯誤結(jié)構(gòu)包含錯誤代碼和與發(fā)生的錯誤相關(guān)的錯誤文本。每個應(yīng)用程序可以使用該錯誤結(jié)構(gòu)評價或發(fā)出錯誤消息。 組成部分 dwError1 .. dwError5 可按API函數(shù)的要求使用這些條目。 API描述包含出錯時條目的各自數(shù)值。否則，錯誤代碼在dwError1中。 szErrorText 錯誤代碼的文本描述緩沖區(qū) 從資源建立該內(nèi)容，因此依賴于語言。
TagLog - 簡短描述 TagLog函數(shù)包含控制WinCC表格控件和WinCC趨勢控件的函數(shù)。 Template子組包含調(diào)用某些控制值的函數(shù)。 Toolbar Buttons子組包含用于工具欄中每個按鈕的標準函數(shù)。這些函數(shù)可用來創(chuàng)建自定義工具欄，例如選擇畫面，或者定義控件上的設(shè)置。 1. int TlgGetColumnPosition(char* lpszTemplate)函數(shù),以表格窗口中的列指針的當(dāng)前位置作為列索引。 使用標準函數(shù)操作WinCC表格控件的實例 {char text[5]; long int columns //獲得列數(shù) columns = GetNumberOfColumns("TableControl_01"); //轉(zhuǎn)換長整型為字符 sprintf (text,"%d",columns); //在Text Field 5 SetText上設(shè)置文本 (lpszPictureName,"Static Text 5",text); } TlgGetNumberOfColumns函數(shù)參數(shù)： “Table Control_01”是WinCC表格控件的名稱。 1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲在columns中。 2). 將返回值緩沖存儲在String text中。 3). 在靜態(tài)文本域中發(fā)出返回值。
2. int TlgGetNumberOfColumns(char* lpszTemplate)函數(shù),在表格窗口中給出列的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。 使用標準函數(shù)操作WinCC表格控件的實例 {char text[5]; long int columns //獲得列數(shù) columns = GetNumberOfColumns("TableControl_01"); //轉(zhuǎn)換長整型為字符 sprintf (text,"%d",columns); //在Text Field 5 SetText上設(shè)置文本 (lpszPictureName,"Static Text 5",text); } TlgGetNumberOfColumns函數(shù)參數(shù)： “Table Control_01”是WinCC表格控件的名稱。 1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲在columns中。 2). 將返回值緩沖存儲在String text中。 3). 在靜態(tài)文本域中發(fā)出返回值。
3. int TlgGetNumberOfRows(char* lpszTemplate)函數(shù),在表格窗口中給出行的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。 使用標準函數(shù)操作WinCC表格控件的實例 {char text[5]; long int rows; //獲得行數(shù) rows = TlgGetNumberOfRows("TableControl_01"); //轉(zhuǎn)換長整型為字符 sprintf (text,"%d",rows); //在Text Field 5 SetText上設(shè)置文本 (lpszPictureName,"Static Text 5",text); } TlgGetNumberOfRows函數(shù)參數(shù)： Table Control_01是WinCC表格控件的名稱。 1). 將函數(shù)TlgGetNumberOfRows的返回值緩沖存儲在rows中。 2). 將返回值緩沖存儲在String text中。 3). 在靜態(tài)文本域中發(fā)出返回值。
4. int TlgGetNumberOfTrends(char* lpszTemplate)函數(shù),在趨勢窗口中給出趨勢的數(shù)量。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢控件窗口的名稱。 使用標準函數(shù)操作WinCC表格控件的實例 {char text[5]; long int columns //獲得列數(shù) columns = GetNumberOfColumns("TableControl_01"); //轉(zhuǎn)換長整型為字符 sprintf (text,"%d",columns); //在Text Field 5 SetText上設(shè)置文本 (lpszPictureName,"Static Text 5",text); } TlgGetNumberOfColumns函數(shù)參數(shù)： “Table Control_01”是WinCC表格控件的名稱。 1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲在columns中。 2). 將返回值緩沖存儲在String text中。 3). 在靜態(tài)文本域中發(fā)出返回值。
5. int TlgGetRowPosition(char* lpszTemplate)函數(shù),在表格窗口中給出行指針的當(dāng)前位置。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。 使用標準函數(shù)操作WinCC表格控件的實例 {char text[5]; long int columns //獲得列數(shù) columns = GetNumberOfColumns("TableControl_01"); //轉(zhuǎn)換長整型為字符 sprintf (text,"%d",columns); //在Text Field 5 SetText上設(shè)置文本 (lpszPictureName,"Static Text 5",text); } TlgGetNumberOfColumns函數(shù)參數(shù)： “Table Control_01”是WinCC表格控件的名稱。 1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲在columns中。 2). 將返回值緩沖存儲在String text中。 3). 在靜態(tài)文本域中發(fā)出返回值。
6. char* TlgGetRulerArchivNameTrend(char* lpszTemplate, int nTrend)函數(shù),在趨勢窗口中這個標尺位置上給出帶編號nTrend的趨勢的歸擋名稱。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢控件窗口的名稱。 使用標準函數(shù)操作WinCC趨勢控件的實例 {char* pszVarName = NULL; char szVarName[20]; //獲得標尺變量名 pszVarName = TlgGetRulerVariableNameTrend("TrendControl_01",0); if (pszVarName != NULL) {// 復(fù)制字符串 strncpy (szVarName,pszVarName,19); } //輸出變量名 SetText (lpszPictureName,"Static Text 6",szVarName); } TlgGetRulerVariableNameTrend函數(shù)參數(shù)： “Trend Control_01”是WinCC趨勢控件的名稱。 “0”是該趨勢的編號。 1). 將函數(shù)TlgGetRulerVariableNameTrend的返回值緩沖存儲在pszVarName中。 2). 如果返回有效數(shù)值，將返回值復(fù)制到szVarName中。 3). 在靜態(tài)文本域中發(fā)出返回值。
7. SYSTEMTIME TlgGetRulerTimeTrend(char* lpszTemplate, int nTrend)函數(shù),在趨勢窗口中這個標尺位置上給出帶編號nTrend的趨勢的時間。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢控件窗口。 使用標準函數(shù)操作WinCC趨勢控件的實例 {SYSTEMTIME systime; WORD wHour; WORD wMin; WORD wSec; char szTime[10]; //獲得當(dāng)前系統(tǒng)時間 systime = TlgGetRulerTimeTrend("TrendControl_01",0); //獲得小時 wHour = systime.wHour; //獲得分鐘 wMin = systime.wMinute; //獲得秒 wSec = systime.wSecond; // sprintf(szTime,"%d:%d:%d",wHour,wMin,wSec); //輸出變量名 SetText (lpszPictureName,"Static Text 7",szTime); } 1). 讀出當(dāng)前系統(tǒng)時間。 2). 從SYSTEMTIME結(jié)構(gòu)讀出小時、分和秒。 3). 創(chuàng)建包含該時間的字符串。 4). 讀出當(dāng)前時間。
8. double TlgGetRulerValueTrend(char* lpszTemplate, int nTrend)函數(shù),在趨勢窗口中這個標尺位置上給出帶編號nTrend的趨勢的數(shù)值。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢控件窗口。 使用標準函數(shù)操作WinCC表格控件的實例 {char text[5]; long int columns //獲得列數(shù) columns = GetNumberOfColumns("TableControl_01"); //轉(zhuǎn)換長整型為字符 sprintf (text,"%d",columns); //在Text Field 5 SetText上設(shè)置文本 (lpszPictureName,"Static Text 5",text); } TlgGetNumberOfColumns函數(shù)參數(shù)： “Table Control_01”是WinCC表格控件的名稱。 1). 將函數(shù)TlgGetNumberOfColumns的返回值緩沖存儲在columns中。 2). 將返回值緩沖存儲在String text中。 3). 在靜態(tài)文本域中發(fā)出返回值。
9. char* TlgGetRulerVariableNameTrend(char* lpszTemplate, int nTrend)函數(shù),在趨勢窗口中給出編號為nTrend的趨勢的變量名。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線趨勢控件窗口。 使用標準函數(shù)操作WinCC趨勢控件的實例 {char* pszVarName = NULL; char szVarName[20]; //獲得標尺變量名 pszVarName = TlgGetRulerVariableNameTrend("TrendControl_01",0); if (pszVarName != NULL) {// 復(fù)制字符串 strncpy (szVarName,pszVarName,19); } //輸出變量名 SetText (lpszPictureName,"Static Text 6",szVarName); } TlgGetRulerVariableNameTrend函數(shù)參數(shù)： “Trend Control_01”是WinCC趨勢控件的名稱。 “0”是該趨勢的編號。 1). 將函數(shù)TlgGetRulerVariableNameTrend的返回值緩沖存儲在pszVarName中。 2). 如果返回有效數(shù)值，將返回值復(fù)制到szVarName中。 3). 在靜態(tài)文本域中發(fā)出返回值。
10. char* TlgGetTextAtPos(char* lpszTemplate, int nColumn, int nLine)函數(shù),為過程變量歸檔和用戶歸檔提供表格窗口的單元格內(nèi)容作為文本。單元由nColumn和nLine指定。用參數(shù)lpszTemplate傳遞相應(yīng)WinCC在線表格控件窗口的名稱。 使用標準函數(shù)操作WinCC趨勢控件的實例 {char* pszVarName = NULL; char szVarName[20]; //獲得標尺變量名 pszVarName = TlgGetRulerVariableNameTrend("TrendControl_01",0); if (pszVarName != NULL) {// 復(fù)制字符串 strncpy (szVarName,pszVarName,19); } //輸出變量名 SetText (lpszPictureName,"Static Text 6",szVarName); } TlgGetRulerVariableNameTrend函數(shù)參數(shù)： “Trend Control_01”是WinCC趨勢控件的名稱。 “0”是該趨勢的編號。 1). 將函數(shù)TlgGetRulerVariableNameTrend的返回值緩沖存儲在pszVarName中。 2). 如果返回有效數(shù)值，將返回值復(fù)制到szVarName中。 3). 在靜態(tài)文本域中發(fā)出返回值。
11. BOOL TlgTableWindowPressEditRecordButton(char* lpszWindowName)函數(shù),鎖住或釋放表格窗口的編輯(切換功能)。如果允許編輯，將停止更新表格窗口。即使因為使用另一個函數(shù)而使編輯被禁止，表格窗口更新將仍保持停止?fàn)顟B(tài)。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
12. BOOL TlgTableWindowPressFirstButton(char* lpszWindowName)函數(shù),顯示表格窗口中顯示區(qū)域的第一個數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
13. BOOL TlgTableWindowPressHelpButton(char* lpszWindowName)函數(shù),顯示表格窗口的在線幫助 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
14. BOOL TlgTableWindowPressInsertRecordButton(char* lpszWindowName)函數(shù),插入數(shù)據(jù)記錄。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
15. BOOL TlgTableWindowPressLastButton(char* lpszWindowName)函數(shù),顯示表格窗口中顯示區(qū)域的最后一個數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
16. BOOL TlgTableWindowPressNextButton(char* lpszWindowName)函數(shù),顯示表格窗口中當(dāng)前顯示區(qū)域后面的數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
17. BOOL TlgTableWindowPressNextItemButton(char* lpszWindowName)函數(shù),表格窗口的列將向左移動一列，最左邊的列移到右邊。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
18. BOOL lgTableWindowPressOpenArchiveVariableSelectionDlgButton(char* lpszWindowName)函數(shù),打開用來鏈接表格列與歸檔和變量的對話框。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
19. BOOL TlgTableWindowPressOpenDlgButton(char* lpszWindowName)函數(shù),打開用來在線組態(tài)表格窗口的對話框。 使用標準函數(shù)操作WinCC趨勢控件的實例 {//打開屬性對話框 TlgTrendWindowPressOpenDlgButton("TrendControl_01"); } TlgTrendWindowPressOpenDlgButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
20. BOOL TlgTableWindowPressOpenItemSelectDlgButton(char* lpszWindowName)函數(shù),打開用來選擇表格窗口的可見列和第一列的對話框。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
21. BOOL TlgTableWindowPressPrevButton(char* lpszWindowName)函數(shù),顯示表格窗口中當(dāng)前顯示區(qū)域前面的數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
22. BOOL TlgTableWindowPressPrevItemButton(char* lpszWindowName)函數(shù),表格窗口的列將向右移動一列，最右邊的列移到左邊。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
23. BOOL TlgTableWindowPressRemoveRecordButton(char* lpszWindowName)函數(shù),刪除數(shù)據(jù)記錄。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
24. BOOL TlgTableWindowPressStartStopButton(char* lpszWindowName)函數(shù),打開或關(guān)閉表格窗口的更新(切換功能)。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
25. BOOL TlgTrendWindowPressFirstButton(char* lpszWindowName)函數(shù),顯示趨勢窗口中顯示區(qū)域的首要數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
26. BOOL TlgTrendWindowPressHelpButton(char* lpszWindowName)函數(shù),顯示趨勢窗口的在線幫助。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
27. BOOL TlgTrendWindowPressLastButton(char* lpszWindowName)函數(shù),顯示趨勢窗口中顯示區(qū)域的最后一個數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
28. BOOL TlgTrendWindowPressLinealButton(char* lpszWindowName)函數(shù),顯示或隱藏趨勢窗口標尺(切換功能)。使用“光標向左”和“光標向右”鍵可以移動標尺。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
29. BOOL TlgTrendWindowPressNextButton(char* lpszWindowName)函數(shù),顯示趨勢窗口中當(dāng)前顯示區(qū)域后面的數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
30. BOOL TlgTrendWindowPressNextItemButton(char* lpszWindowName)函數(shù),將趨勢窗口中所有趨勢向前移動一個層面。前面的那個趨勢將被移到后面。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
31. BOOL TlgTrendWindowPressOneToOneButton(char* lpszWindowName)函數(shù),該趨勢窗口被重新設(shè)置為激活縮放功能前的狀態(tài)。縮放被取消激活。使用鼠標才可以選中待縮放的區(qū)域(參考TlgTrendWindowPressZoomInButton)。 使用標準函數(shù)操作WinCC報警趨勢的實例
{ //開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
32. BOOL lgTrendWindowPressOpenArchiveVariableSelectionDlgButton(char* lpszWindowName)函數(shù),打開鏈接趨勢與歸檔和變量的對話框。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
33. BOOL TlgTrendWindowPressOpenDlgButton(char* lpszWindowName)函數(shù),打開趨勢窗口的在線組態(tài)對話框。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
34. BOOL TlgTrendWindowPressOpenItemSelectDlgButton(char* lpszWindowNumber)函數(shù),打開用來選擇可見趨勢以及要在前景中顯示的趨勢的對話框。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
35. BOOL TlgTrendWindowPressOpenTimeSelectDlgButton(char* lpszWindowNumber)函數(shù),打開定義顯示時間段的對話框。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
36. BOOL TlgTrendWindowPressPrevButton(char* lpszWindowName)函數(shù),在趨勢窗口中顯示當(dāng)前顯示區(qū)域前面的數(shù)據(jù)記錄。顯示的數(shù)據(jù)記錄數(shù)量由所組態(tài)的時間范圍決定。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
37. BOOL TlgTrendWindowPressPrevItemButton(char* lpszWindowName) 函數(shù),將趨勢窗口中所有趨勢向后移動一個層面。后面的那個趨勢將被移到前面。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
38. BOOL TlgTrendWindowPressStartStopButton(char* lpszWindowName)函數(shù),打開或關(guān)閉趨勢窗口的更新(切換功能)。 使用標準函數(shù)操作WinCC報警趨勢的實例 {//開始/停止 TlgTrendWindowPressStartStopButton("TrendControl_01"); } TlgTrendWindowPressStartStopButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
39. BOOL TlgTrendWindowPressZoomInButton(char* lpszWindowName)函數(shù),將打開趨勢窗口中的放大鏡。 只能用鼠標選擇比例縮放區(qū)域。 使用標準函數(shù)操作WinCC趨勢控件的實例 {//放大 TlgTrendWindowPressZoomInButton("TrendControl_01"); } TlgTrendWindowPressZoomInButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
40. BOOL TlgTrendWindowPressZoomOutButton(char* lpszWindowName)函數(shù),恢復(fù)趨勢窗口到缺省大小(1:1)。 使用標準函數(shù)操作WinCC報警趨勢控件的實例 {// 縮小 TlgTrendWindowPressZoomOutButton("TrendControl_01"); } TlgTrendWindowPressZoomOutButton函數(shù)參數(shù)： “TrendControl_01”是WinCC趨勢控件的對象名。
WinCC簡短描述 WinCC組包含影響整個WinCC系統(tǒng)的函數(shù)。 1. BOOL GetHWDiag(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, LPCTSTR lpProperties)函數(shù) 運行時該函數(shù)可實現(xiàn)診斷的直接啟動，由事件觸發(fā)。必須在對象上組態(tài)、運用該事件。 如果該事件發(fā)生，硬件診斷功能從關(guān)聯(lián)PLC的STEP7被啟動。 為了使用該功能，必須滿足下列條件： · WinCC項目，帶有從其進行訪問的畫面，而且STEP7項目必須在同一臺計算機上。 · 必須將WinCC項目存儲為STEP7項目(STEP7 Projekt\wincproj\WinCC Projekt)的子目錄。 · 已將S7變量映射到WinCC。
2. BOOL GetHWDiagLevel(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, LPCTSTR lpProperties, DWORD dwLevel)函數(shù) 根據(jù)在dwLevel下面指定的用戶管理員功能號為激活的用戶執(zhí)行用戶配置文件級測試。 之后，運行時診斷被直接啟動并由事件觸發(fā)，須在對象上組態(tài)該事件。 如果該事件發(fā)生，硬件診斷功能從關(guān)聯(lián)PLC的STEP7被啟動。 為了使用該功能，必須滿足下列條件： · 在WinCC中激活的用戶必須有必要的用戶配置文件級。 · WinCC項目，帶有從其進行訪問的畫面，而且STEP7項目必須在同一臺計算機上。 · 必須將WinCC項目存儲為STEP7項目(STEP7 Projekt\wincproj\WinCC Projekt)的子目錄. · 已將S7變量映射到WinCC。
3. BOOL GetKopFupAwl(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName, LPCTSTR lpProperties)函數(shù) 該函數(shù)執(zhí)行WinCC Step7編輯器“KFA”的網(wǎng)絡(luò)激活。 執(zhí)行該函數(shù)，完成兩項子任務(wù)： · 建立從WinCC訪問網(wǎng)絡(luò)所需要的數(shù)據(jù)。 · 將該數(shù)據(jù)傳送到Step 7并使用AUTAPI定位Step 7程序中操作數(shù)的利用點。
4. BOOL GetKopFupAwlLevel(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName,LPCTSTR lpProperties, DWORD dwLevel)函數(shù) 根據(jù)在dwLevel下面指定的用戶管理員功能號為激活的用戶執(zhí)行用戶配置文件級測試，然后訪問Step 7編輯器“KFA”。 作為三項子任務(wù)執(zhí)行該函數(shù)： · 建立從WinCC進行網(wǎng)絡(luò)訪問所需要的數(shù)據(jù)。 · 在WinCC中為激活的用戶執(zhí)行用戶配置文件級測試。 · 將該數(shù)據(jù)傳送到Step 7并使用AUTAPI定位Step 7程序中操作數(shù)的利用點。
5. void OnDeactivateExecute()函數(shù) 終止WinCC時調(diào)用該函數(shù)。 由于它是標準函數(shù)，可以插入指令，然后執(zhí)行它們。
6. void OnErrorExecute(CCAPErrorExecute ErrorExecute)函數(shù) 執(zhí)行動作或函數(shù)而發(fā)生錯誤時由系統(tǒng)調(diào)用OnErrorExecute。 此函數(shù)能夠確定出錯的準確原因。 由系統(tǒng)調(diào)用該函數(shù)，并且不要求附加的調(diào)用命令。 由于包括作為標準函數(shù)的此函數(shù)，可以改變輸出的類型。
7. void OnTime(CCAPTime time)函數(shù) OnTime只能由系統(tǒng)調(diào)用。該函數(shù)給出所有動作的運行時間或確定哪個動作的運行時間超出了指定時間。 通過APDIAG可以激活和取消激活時間測量。 由于此函數(shù)是一個標準函數(shù)，所以可以通過修改函數(shù)代碼來改變輸出的類型。 結(jié)構(gòu)定義CCAPTime typedef struct { DWORD dwCurrentThreadID; 當(dāng)前線程的線程ID DWORD dwCode; 代碼 BOOL bCycle; 周期/非周期 char* szApplicationName;應(yīng)用程序的名稱 char* szFunctionName; 函數(shù)的名稱 LPVOID lpParam; 指向動作堆棧的指針 DWORD dwParamSize; 動作堆棧的大小 double dblTime; DWORD dwFlags; 標記 } CCAPTime; 組成部分 dwCode dwCode結(jié)構(gòu)元素提供OnTime調(diào)用信息：
dwFlags dwFlags結(jié)構(gòu)元素提供輸出類型的信息：
Windows - 簡短描述 Windows組包含Execute Program函數(shù)。 該函數(shù)可用來執(zhí)行任何功能。 1. unsigned int Execute(char* Program_Name)函數(shù),用指定的名稱啟動該程序。 從WinCC啟動程序的實例 {//啟動程序calc.exe 執(zhí)行程序 ("C:\\Winnt\\system32\\calc.exe"); } 指定帶路徑的文件為參數(shù)。
二、內(nèi)部函數(shù) 內(nèi)部函數(shù)用來畫圖形對象和使歸檔動態(tài)化，并用于項目函數(shù)、標準函數(shù)和全局腳本動作中。 在整個項目中都識別內(nèi)部函數(shù)。 既不能創(chuàng)建新的內(nèi)部函數(shù)，也不能修改已存在的內(nèi)部函數(shù)。 1. allocate保留和釋放工作存儲器空間的函數(shù) void SysFree(void* lpFree)函數(shù)，通過SysMalloc函數(shù)釋放保留的存儲器區(qū)域。 參數(shù)lpFree，指向通過SysMalloc函數(shù)保留的存儲器區(qū)域的指針。
2. void* SysMalloc(unsigned long int size)函數(shù)，為動作保留存儲器空間。存儲器區(qū)域被分配給該動作。已完成動作和已傳送結(jié)果時，系統(tǒng)再次釋放存儲器。 SysFree函數(shù)可用來過早釋放保留的存儲器空間。 參數(shù)size，按字節(jié)計算的存儲器區(qū)域的大小。
3. c_bib函數(shù)組c_bib包含來自C庫的C函數(shù)
Graphics - 簡短描述 使用Graphics組中的函數(shù)可以修改或調(diào)用WinCC對象的圖形屬性。
Axes - 簡短描述 Axes組中的函數(shù)僅用于棒圖對象。 該函數(shù)可用來修改或調(diào)用各種棒圖對象屬性。 1. BOOL GetAlignment(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它指明文本在棒圖的左面還是右面。 讀出棒圖對象的布爾型屬性的實例 { BOOL bscaling; //獲得標尺狀態(tài) bscaling = GetScaling(lpszPictureName,"Bar1"); if (bscaling) { // 自定義代碼 // 棒圖對象有一個附加的標尺 ... } else { // 自定義代碼 // 棒圖對象沒有附加的刻度 ... } } GetScaling函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。 1）. 讀出棒圖刻度是否可見以及bscaling中的緩沖區(qū)。 2）. 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
2. double GetAxisSection(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它指定兩個鄰近軸標簽之間的數(shù)值差。
3. BOOL GetExponent(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它指定軸標簽對應(yīng)于小數(shù)或指數(shù)形式。 讀出棒圖對象的布爾型屬性的實例 {BOOL bscaling; //獲得標尺狀態(tài) bscaling = GetScaling(lpszPictureName,"Bar1"); if (bscaling) { // 自定義代碼 // 棒圖對象有一個附加的標尺 ... } else { // 自定義代碼 // 棒圖對象沒有附加的刻度 ... } } GetScaling函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。 1）. 讀出棒圖刻度是否可見以及bscaling中的緩沖區(qū)。 2）. 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
4. long int GetLeftComma(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它指定軸標簽中的整數(shù)數(shù)量。 參數(shù)lpszPictureName 畫面名lpszObjectName 對象名 返回值，軸標簽中的整數(shù)數(shù)量
5. BOOL GetLongStrokesBold(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它指定以粗體還是常規(guī)形式顯示標尺上的主要刻度線。 讀出棒圖對象的布爾型屬性的實例 { BOOL bscaling; //獲得標尺狀態(tài) bscaling = GetScaling(lpszPictureName,"Bar1"); if (bscaling) { // 自定義代碼 // 棒圖對象有一個附加的標尺 ... } else { // 自定義代碼 // 棒圖對象沒有附加的刻度 ... } } GetScaling函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。 1). 讀出棒圖刻度是否可見以及bscaling中的緩沖區(qū)。 2). 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
6. long int GetLongStrokesSize(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定主要刻度線的長度。
7. long int GetLongStrokesTextEach(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定主要刻度線標簽的間隔長度。
8. long int GetRightComma(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定坐標軸標簽中的小數(shù)位數(shù)。
9. long int GetScaleTicks(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它將標尺單位定義為標尺分段的數(shù)量。一個標尺分段對應(yīng)于兩條主要刻度線之間的范圍
10. BOOL GetScaling(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖時，它指定激活還是取消激活標尺。 讀出棒圖對象的布爾型屬性的實例 { BOOL bscaling; //獲得標尺狀態(tài) bscaling = GetScaling(lpszPictureName,"Bar1"); if (bscaling) { // 自定義代碼 // 棒圖對象有一個附加的標尺 ... } else { // 自定義代碼 // 棒圖對象沒有附加的刻度 ... } } GetScaling函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。 1). 讀出棒圖刻度是否可見以及bscaling中的緩沖區(qū)。 2). 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
11. long int GetScalingType(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定棒圖標尺的類型。
Color - 簡短描述 使用Color組中的函數(shù)可以修改或調(diào)用對象的顏色屬性。 1. long int GetBackColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),指定對象的背景色為數(shù)字值。 讀出顏色值的實例 { long int bk_color; // linkinfo.szLinkName是變量名。 // linkinfo.dwCycle是更新周期 // linkinfo.LinkType是該連接的類型 //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackColor函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。 1). 讀出當(dāng)前背景色和bk_color中的緩沖區(qū)。 2). 執(zhí)行處理返回值的自定義代碼。
2. long int GetBackColor2(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定棒圖的顏色為數(shù)字值。 讀出顏色值的實例 { long int bk_color; // linkinfo.szLinkName是變量名。 // linkinfo.dwCycle是更新周期 // linkinfo.LinkType是該連接的類型 //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackColor函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。
3. long int GetBackColor3(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定棒圖的背景色為數(shù)字值。 讀出顏色值的實例 { long int bk_color; // linkinfo.szLinkName是變量名。 // linkinfo.dwCycle是更新周期 // linkinfo.LinkType是該連接的類型 //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackColor函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。
Fill - 簡短描述 Fill組中的函數(shù)控制對象的動態(tài)填充。 1. BOOL GetFilling(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),指定是否激活背景色動態(tài)填充。 讀出“動態(tài)填充”屬性的實例 { BOOL bfilling; //獲得動態(tài)填充的實際狀態(tài) bfilling = GetFilling(lpszPictureName," Rectangle 1"); if(bfilling) { // 自定義代碼 // 動態(tài)填充是否被激活 ... } else { // 自定義代碼 // 動態(tài)填充是否被取消激活 ... } } GetFilling函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Rectangle1”是該對象的名稱。 1). 讀出動態(tài)填充是否激活以及bfilling中的緩沖區(qū)。 2). 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
2.long int GetFillingIndex(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),指定當(dāng)前填充量。 讀出填充索引的實例 { long int filling_index; //獲得該對象的實際填充索引 filling _index = GetFillingIndex(lpszPictureName," Rectangle 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetFillingIndex函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Rectangle1”是該對象的名稱。 1）. 讀出該對象的當(dāng)前填充索引以及filling_index中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
Flash - 簡短描述 使用Flash組中的函數(shù)可以修改或調(diào)用各種閃爍屬性。 1. long int GetBackFlashColorOff(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定取消激活狀態(tài)的閃爍背景色 讀出閃爍顏色的實例 { long int flashcol_on; //獲得背景閃爍顏色 flashcol_on = GetBackFlashColorOn(lpszPictureName,"Group 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackFlashColorOn函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Group 1”是該對象的名稱。 1）. 讀出該對象的開狀態(tài)的當(dāng)前背景閃爍顏色以及flashcol_on中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
2. long int GetBackFlashColorOn(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定激活狀態(tài)的背景閃爍顏色。 讀出閃爍顏色的實例 { long int flashcol_on; //獲得背景閃爍顏色 flashcol_on = GetBackFlashColorOn(lpszPictureName,"Group 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackFlashColorOn函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Group 1”是該對象的名稱。 1）. 讀出該對象的開狀態(tài)的當(dāng)前背景閃爍顏色以及flashcol_on中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
3. long int GetBorderFlashColorOff(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定取消激活狀態(tài)的邊框或線閃爍顏色。 讀出閃爍顏色的實例 { long int flashcol_on; //獲得背景閃爍顏色 flashcol_on = GetBackFlashColorOn(lpszPictureName,"Group 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackFlashColorOn函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Group 1”是該對象的名稱。
4. long int GetBorderFlashColorOn(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定激活狀態(tài)的邊框或線閃爍顏色。 讀出閃爍顏色的實例
{ long int flashcol_on; //獲得背景閃爍顏色 flashcol_on = GetBackFlashColorOn(lpszPictureName,"Group 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetBackFlashColorOn函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Group 1”是該對象的名稱。
5. BOOL GetFlashBackColor(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定是否激活背景閃爍。 讀出“閃爍背景激活”屬性的實例
{ BOOL bflash_col; //了解閃爍是開還是關(guān) bflash _col = GetFlashBackColor(lpszPictureName,"Group 1"); if(bflash_col) { // 自定義代碼 // 閃爍是否被激活 ... } else { // 自定義代碼 // 閃爍是否被取消激活 ... } } GetFlashBackColor函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Group 1”是該對象的名稱。 1）. 讀出背景色閃爍是否被激活以及bflash_col中的緩沖區(qū)。 2）. 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
Focus - 簡短描述 使用Focus組中的函數(shù)，可以設(shè)置焦點或輪詢哪個對象有焦點。 1. char* Get_Focus()函數(shù)，指定當(dāng)前或最后聚焦的對象的名稱。 要求當(dāng)前在哪一個對象上設(shè)置焦點的實例 { char* pszValue = NULL; char szValue[_MAX_PATH+1]; //獲得具有焦點的對象 pszValue = Get_Focus(); //復(fù)制字符串 if (pszValue != NULL) { strncpy(szValue,pszValue,_MAX_PATH); } //自定義代碼 //在那里用戶可以使用返回值做某事 ... } 1）. 讀出在其上設(shè)置焦點的對象以及pszValue中的緩沖區(qū)。 2）. 如果返回有效數(shù)值，將該函數(shù)的返回值存儲在本地字符串szValue中。最多存儲_MAX_PATH個字符。 3）. 執(zhí)行處理返回值的自定義代碼。
Font - 簡短描述 使用Font組中的函數(shù)可以修改或調(diào)用影響文本的各種屬性。 1. long int GetAlignmentLeft(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，定義水平文本對齊(左對齊、居中、右對齊)。 讀出字體大小的實例
{ long int fontsize; //獲得實際字體大小 fontsize = GetFontSize(lpszPictureName,"Static Text 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetFontSize函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。 1）. 讀出當(dāng)前字體大小和fontsize中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
2. long int GetAlignmentTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，定義垂直文本對齊(上對齊、居中、下對齊)。 讀出字體大小的實例 { long int fontsize; //獲得實際字體大小 fontsize = GetFontSize(lpszPictureName,"Static Text 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetFontSize函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。
3. BOOL GetFontBold(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，定義字體樣式是否為“粗體字”。 讀出靜態(tài)文本域的布爾型屬性的實例 { BOOL bbold; //了解文本是否是粗體字 bbold = GetFontBold(lpszPictureName,"Static Text 1"); if(bbold) { // 自定義代碼 // 字體是否是粗體字 ... } else { // 自定義代碼 // 字體是否不是粗體字 ... } } GetFontBold函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。
4. char* GetText(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，為對象，例如靜態(tài)文本、復(fù)選框和單選框，指定“文本”屬性的數(shù)值。 讀出文本的實例 { char* pszValue = NULL; char szValue[13]; //獲得實際設(shè)置的文本 pszValue = GetText(lpszPictureName," Static Text 1"); if(pszValue != NULL) { //復(fù)制字符串 strncpy(szValue,pszValue,12); } //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetText函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Static Text1”是該對象的名稱。
5. long int GetLayer(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定該對象所在的畫面層。 參數(shù)lpszPictureName 畫面名lpszObjectName
Geometry - 簡短描述 使用Geometry組中的函數(shù)可以修改或調(diào)用對象的大小、位置和其它幾何屬性。 1. long int GetActualPointLeft(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定多邊形或折線中當(dāng)前位置的X軸數(shù)值。 讀出對象位置的實例 { long lPos; //獲得對象的X軸位置 lPos = GetLeft(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetLeft函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。 1）. 讀出對象的當(dāng)前X軸位置以及l(fā)Pos中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
2. long int GetActualPointTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定多邊形或折線中當(dāng)前頂點的Y軸數(shù)值。 讀出對象位置的實例 { long lPos; //獲得對象的Y軸位置 lPos = GetTop(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetTop函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
3. long int GetBoxCount(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定復(fù)選框和單選框的數(shù)字域。 參數(shù)lpszPictureName 畫面名lpszObjectName
4. long int GetDirection(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它指出棒圖的方向。 參數(shù)lpszPictureName 畫面名lpszObjectName
5. long int GetEndAngle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName) 函數(shù)，指定部分圓和部分橢圓以及圓弧和橢圓弧的結(jié)束角度。
6. BOOL GetGrid(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定是否在圖形編輯器的圖形域中激活網(wǎng)格。
7. long int GetGridHeight(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定在圖形編輯器的圖形域中網(wǎng)格的高度。
8. long int GetGridWidth(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定在圖形編輯器的圖形域中網(wǎng)格的寬度。
9. long int GetHeight(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定構(gòu)成對象的矩形的高度。 讀出對象位置的實例 { long lHeight; //獲得對象的高度 lHeight = GetHeight(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetHeight函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。 1）. 讀出對象的當(dāng)前高度以及l(fā)Height中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
10. long int GetLeft(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，定義構(gòu)成對象的矩形左上角的X軸位置。 讀出對象位置的實例 { long lPos; //獲得對象的X軸位置 lPos = GetLeft(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetLeft函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
11. long int GetPointCount(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定多邊形或折線的角的數(shù)量。
12. long int GetRadius(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName); 函數(shù)，定義圓、部分圓或圓弧的半徑。 讀出對象位置的實例 { long lHeight; //獲得對象的高度 lHeight = GetHeight(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetHeight函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。 1）. 讀出對象的當(dāng)前高度以及l(fā)Height中的緩沖區(qū)。 2）. 執(zhí)行處理返回值的自定義代碼。
13. long int GetRadiusHeight(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定橢圓、部分橢圓或橢圓弧的垂直半徑。 讀出對象位置的實例 { long lHeight; //獲得對象的高度 lHeight = GetHeight(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetHeight函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
14. long int GetRadiusWidth(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定橢圓、部分橢圓或橢圓弧的水平半徑。
15. long int GetReferenceRotationLeft(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用線、多邊形和折線時，它指定旋轉(zhuǎn)位置(圍繞其旋轉(zhuǎn)對象的中心坐標軸)的X軸數(shù)值。 讀出對象位置的實例 { long lPos; //獲得對象的X軸位置 lPos = GetLeft(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetLeft函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
16. long int GetReferenceRotationTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用線、多邊形和折線時，它指定旋轉(zhuǎn)位置(圍繞其旋轉(zhuǎn)對象的中心坐標軸)的Y軸數(shù)值。
17. long int GetRotationAngle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，定義圍繞中心坐標軸旋轉(zhuǎn)線、多邊形和折線的角度。
18. long int GetStartAngle(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定部分圓和部分橢圓以及圓弧和橢圓弧的起始角度。 讀出對象位置的實例 { long lHeight; //獲得對象的高度 lHeight = GetHeight(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetHeight函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
19. long int GetTop(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定構(gòu)成對象的矩形左上角的Y軸位置。 讀出對象位置的實例 { long lPos; //獲得對象的Y軸位置 lPos = GetTop(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetTop函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
20. long int GetWidth(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，指定構(gòu)成對象的矩形的寬度。 讀出對象位置的實例 { long lWidth; //獲得對象的寬度 lWidth = GetWidth(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetWidth函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
21. long int GetZeroPoint(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用棒圖對象時，它顯示零點。 讀出對象位置的實例 { long lHeight; //獲得對象的高度 lHeight = GetHeight(lpszPictureName,"WinCCLogo"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetHeight函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “WinCCLogo”是該對象的名稱。
i_o - 簡短描述 使用i_o組中的函數(shù)可以修改或調(diào)用影響輸入和輸出值的各種屬性。 1. char* GetAssignments(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，對于列表，分配文本給數(shù)值范圍
2. BOOL GetAssumeOnExit(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用I/O域時，它指定退出該域時是否應(yīng)用輸入的數(shù)值。
3. BOOL GetAssumeOnFull(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用I/O域時，它指定完成輸入時是否應(yīng)用輸入的數(shù)值。
4. long int GetBitNumber(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù)，使用列表類型“位”時，它指定輸出值中相關(guān)的位。 讀出布爾型屬性的實例 { BOOL bHiddenInput; //獲得隱藏輸入的狀態(tài) bHiddenInput = GetHiddenInput(lpszPictureName,"IO Field 1"); if(bHiddenInput) { // 自定義代碼 // 隱藏輸入是否被激活 ... } else { // 自定義代碼 // 隱藏輸入是否被取消激活 ... } } GetHiddenInput函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “IO Field1”是該對象的名稱。 1). 讀出文本是否是粗體字以及bHiddenInput中的緩沖區(qū)。 2). 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
5. BOOL GetClearOnError(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用I/O域時，它指定錯誤輸入后是否激活刪除內(nèi)容。
6. long int GetDataFormat(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于I/O域，它指定域內(nèi)容的數(shù)據(jù)類型。 讀出布爾型屬性的實例 { BOOL bHiddenInput; //獲得隱藏輸入的狀態(tài) bHiddenInput = GetHiddenInput(lpszPictureName,"IO Field 1"); if(bHiddenInput) { // 自定義代碼 // 隱藏輸入是否被激活 ... } else { // 自定義代碼 // 隱藏輸入是否被取消激活 ... } } GetHiddenInput函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “IO Field1”是該對象的名稱。
7. BOOL GetHiddenInput(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于I/O域，它指定是否激活隱藏輸入。 讀出布爾型屬性的實例 { BOOL bHiddenInput; //獲得隱藏輸入的狀態(tài) bHiddenInput = GetHiddenInput(lpszPictureName,"IO Field 1"); if(bHiddenInput) { // 自定義代碼 // 隱藏輸入是否被激活 ... } else { // 自定義代碼 // 隱藏輸入是否被取消激活 ... } } GetHiddenInput函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “IO Field1”是該對象的名稱。
8. double GetInputValueDouble(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于I/O域，它定義數(shù)據(jù)類型為“雙精度型”的輸入值。
9. long int GetListType(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName) 函數(shù),指定“文本列表”對象的列表類型。 讀出布爾型屬性的實例 { BOOL bHiddenInput; //獲得隱藏輸入的狀態(tài) bHiddenInput = GetHiddenInput(lpszPictureName,"IO Field 1"); if(bHiddenInput) { // 自定義代碼 // 隱藏輸入是否被激活 ... } else { // 自定義代碼 // 隱藏輸入是否被取消激活 ... } } GetHiddenInput函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “IO Field1”是該對象的名稱。
10. long int GetNumberLines(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),指定“文本列表”對象的可見行數(shù)。 讀出布爾型屬性的實例 { BOOL bHiddenInput; //獲得隱藏輸入的狀態(tài) bHiddenInput = GetHiddenInput(lpszPictureName,"IO Field 1"); if(bHiddenInput) { // 自定義代碼 // 隱藏輸入是否被激活 ... } else { // 自定義代碼 // 隱藏輸入是否被取消激活 ... } } GetHiddenInput函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “IO Field1”是該對象的名稱。
11. char* GetOutputFormat(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于I/O域，它指定輸出格式。
12. char* GetOutputValueChar(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于I/O域，它建立數(shù)據(jù)類型為“字符”的輸出值。當(dāng)I/O域的內(nèi)容為數(shù)據(jù)類型“字符串”時，才使用該函數(shù)。
Limits - 簡短描述 使用Limits組中的函數(shù)可以修改或調(diào)用影響限值的各種屬性。 1. double GetAlarmHigh(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指出報警上限。 讀出數(shù)字值的實例 { double dAlarmHigh; //獲得報警上限 dAlarmHigh = GetAlarmHigh(lpszPictureName,"Bar 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetAlarmHigh函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。 1). 讀出報警上限和dAlarmHigh中的緩沖區(qū)。 2). 執(zhí)行處理返回值的自定義代碼。
2. double GetAlarmLow(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指出報警下限。 讀出數(shù)字值的實例 { double dAlarmHigh; //獲得報警上限 dAlarmHigh = GetAlarmHigh(lpszPictureName,"Bar 1"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetAlarmHigh函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。
3. BOOL GetCheckAlarmHigh(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定是否監(jiān)控報警上限。 讀出布爾型屬性的實例 { BOOL bmarker; //獲得該標記的狀態(tài) bmarker = GetMarker(lpszPictureName,"Bar 1"); if(bmarker) { // 自定義代碼 // 標記是否被激活 ... } else { // 自定義代碼 // 標記是否被取消激活 ... } } GetMarker函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。
4. BOOL GetCheckLimitHigh4(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用棒圖對象時，它指定是否監(jiān)控上限值Reserve 4。 讀出布爾型屬性的實例 { BOOL bmarker; //獲得該標記的狀態(tài) bmarker = GetMarker(lpszPictureName,"Bar 1"); if(bmarker) { // 自定義代碼 // 標記是否被激活 ... } else { // 自定義代碼 // 標記是否被取消激活 ... } } GetMarker函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。
Link - 簡短描述 使用Link組中的函數(shù)可以創(chuàng)建或調(diào)用變量鏈接屬性。 1. BOOL GetLink(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName LPCTSTR lpszPropertyName, LPLINKINFO *pLink)函數(shù),指定對象屬性的當(dāng)前變量鏈接。 讀出變量鏈接的實例 { LINKINFO linkinfo; //獲得已鏈接的變量 GetLink(lpszPictureName,"Bar 1","Process",&linkinfo); // linkinfo.szLinkName是變量名 // linkinfo.dwCycle是更新周期 // linkinfo.LinkType是連接的類型 //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetLink函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Bar1”是該對象的名稱。 “Process”是鏈接到變量的屬性。 “&linkinfo”是結(jié)構(gòu)linkinfo的地址。 1). 用該變量鏈接上的信息填充傳送的linkinfo結(jié)構(gòu)。 2). 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
Miscs - 簡短描述 使用Miscs組中的函數(shù)可以修改或調(diào)用對象的屬性。 1. BOOL GetAdaptBorder(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName) 函數(shù),對于靜態(tài)文本、I/O域、復(fù)選框和單選框，它指定域邊框是否將動態(tài)適應(yīng)文本的大小。 讀出布爾型屬性的實例 { BOOL bVisible; //獲得可見性 bVisible = GetVisible(lpszPictureName,"Graphic Object 1"); if(bVisible) { // 自定義代碼 // 該對象是否可見 ... } else { // 自定義代碼 // 該對象是否不可見 ... } } GetVisible函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Graphic Object 1”是該對象的名稱。
2. BOOL GetAdaptPicture(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于畫面窗口，它指定畫面是否將適應(yīng)窗口的大小。 讀出布爾型屬性的實例 { BOOL bVisible; //獲得可見性 bVisible = GetVisible(lpszPictureName,"Graphic Object 1"); if(bVisible) { // 自定義代碼 // 該對象是否可見 ... } else { // 自定義代碼 // 該對象是否不可見 ... } } GetVisible函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Graphic Object 1”是該對象的名稱。
3. BOOL GetAdaptSize(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName) 函數(shù),對于畫面窗口，它指定是否改變窗口。 讀出布爾型屬性的實例
{ BOOL bVisible; //獲得可見性 bVisible = GetVisible(lpszPictureName,"Graphic Object 1"); if(bVisible) { // 自定義代碼 // 該對象是否可見 ... } else { // 自定義代碼 // 該對象是否不可見 ... } } GetVisible函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Graphic Object 1”是該對象的名稱。
4. BOOL GetAverage(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),對于棒圖對象，指定是否激活平均值計算。 讀出布爾型屬性的實例 { BOOL bVisible; //獲得可見性 bVisible = GetVisible(lpszPictureName,"Graphic Object 1"); if(bVisible) { // 自定義代碼 // 該對象是否可見 ... } else { // 自定義代碼 // 該對象是否不可見 ... } } GetVisible函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Graphic Object 1”是該對象的名稱。
5. BOOL GetCaption(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),指定畫面或應(yīng)用程序窗口是否有標題。 讀出布爾型屬性的實例 { BOOL bVisible; //獲得可見性 bVisible = GetVisible(lpszPictureName,"Graphic Object 1"); if(bVisible) { // 自定義代碼 // 該對象是否可見 ... } else { // 自定義代碼 // 該對象是否不可見 ... } } GetVisible函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Graphic Object 1”是該對象的名稱。
6. BOOL GetLanguageSwitch(LPCTSTR lpszPictureName, LPCTSTR lpszObjectName)函數(shù),使用“文本列表”對象時，它指定用一種還是多種語言組態(tài)文本列表。 讀出布爾型屬性的實例 { BOOL bVisible; //獲得可見性 bVisible = GetVisible(lpszPictureName,"Graphic Object 1"); if(bVisible) { // 自定義代碼 // 該對象是否可見 ... } else { // 自定義代碼 // 該對象是否不可見 ... } } GetVisible函數(shù)參數(shù)： “lpszPictureName”是在其中組態(tài)該對象的畫面的名稱。 “Graphic Object 1”是該對象的名稱。
SET啟動 1. BOOL OpenHomePicture()函數(shù), 打開定義的啟動畫面。 2. BOOL OpenNextPicture()函數(shù) WinCC存儲用戶在運行時打開的畫面的名稱以及打開畫面的順序。 在“畫面緩沖區(qū)大小”下面的計算機屬性標簽控件“圖形運行系統(tǒng)”中的WinCC資源管理器內(nèi)，可以定義用此方式所能存儲的畫面名的最大數(shù)目。 OpenNextPicture函數(shù)打開由OpenPrevPicture函數(shù)打開的最后一個畫面。 3. BOOL OpenPrevPicture()函數(shù)，WinCC存儲用戶在運行時打開的畫面的名稱以及打開畫面的順序。 在“畫面緩沖區(qū)大小”下面的計算機屬性標簽控件“圖形運行系統(tǒng)”中的WinCC資源管理器內(nèi)，可以定義用此方式所能存儲的畫面名的最大數(shù)目。 OpenPrevPicture函數(shù)打開當(dāng)前畫面的前一個畫面。
4. BOOL OpenStoredPicture()函數(shù)，打開使用Store Picture函數(shù)存儲的畫面。
5. BOOL StorePicture()函數(shù)，存儲當(dāng)前畫面；存儲后，使用OpenStoredPicture函數(shù)可以打開該畫面。
tag - 簡短描述 使用來自Tag組的函數(shù)可以設(shè)置或調(diào)用變量。 1. BOOL GetTagBitStateWait(Tag Tag_Name, PDWORD lp_dwstate)函數(shù)， 建立數(shù)據(jù)類型“二進制變量”的過程變量的數(shù)值。直接從PLC讀取該數(shù)值。 也返回變量的狀態(tài)。 讀出二進制類型變量的實例 { DWORD dwstate; BOOL bValue; dwstate = 0xFFFFFFFF; //獲得該變量值 //dwstate是變量狀態(tài) bValue = GetTagBitStateWait("gs_tag_bit",&dwstate); //創(chuàng)建包含該變量值的字符串 if (bValue) { // 自定義代碼 // 該變量的數(shù)值是否是true ... } else { // 自定義代碼 // 該變量的數(shù)值是否是false ... } } GetTagBitStateWait函數(shù)參數(shù)： “gs_tag_bit”是該變量的名稱。 “&dwstate”是應(yīng)在其中存儲變量狀態(tài)的變量地址。 1）. 讀出該變量值以及bstate中的緩沖區(qū)。 該函數(shù)將變量狀態(tài)存儲在dwstate中。 2）. 根據(jù)該函數(shù)的返回值執(zhí)行自定義代碼。
WinCC簡短描述 使用來自WinCC組的函數(shù)可以在運行系統(tǒng)中定義各種設(shè)置。 使用System子組中的函數(shù)可以操作WinCC運行系統(tǒng)。 1. BOOL DeactivateRTProject()函數(shù)，取消激活該項目。 取消激活WinCC運行系統(tǒng)的實例 { //取消激活運行系統(tǒng) DeactivateRTProject (); } 該函數(shù)取消激活WinCC運行系統(tǒng)。
2. BOOL ExitWinCC()函數(shù)，終止WinCC 退出WinCC的實例 { //退出wincc ExitWinCC (); } 該函數(shù)終止WinCC。
3. DWORD GetLanguage()函數(shù)，建立當(dāng)前運行系統(tǒng)語言。 讀出當(dāng)前運行系統(tǒng)語言的實例 { DWORD rt_language; //獲得當(dāng)前語言 rt _language = GetLanguage (); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } 1）. 讀出當(dāng)前運行系統(tǒng)語言并緩沖存儲在rt_language中。 2）. 執(zhí)行處理返回值的自定義代碼。
4. DWORD* InquireLanguage(DWORD* dwCount)函數(shù)，建立為運行系統(tǒng)而在文本庫中組態(tài)的全部語言。使用dwCount定義建立的語言數(shù)量應(yīng)該存儲在哪里。 讀出已組態(tài)的運行系統(tǒng)語言 { DWORD count; DWORD* language; int i; //計算已安裝的語言 language = InquireLanguage(&count); printf("##################### INQUIRE LANGUAGE ####################"); //打印輸出語言的計數(shù) printf ( "\r\nCount Languages=%d\r\n", count ); //打印輸出安裝了哪些語言 for (i=1;i<=count; i++) { printf ("\r\n%d.language=%x", i,*language++); } } 1）. 建立為該運行系統(tǒng)組態(tài)的語言。這些語言ID緩沖存儲在語言中。語言的數(shù)量緩沖存儲在計數(shù)中。 2）. 發(fā)出已建立的語言的數(shù)量。 3）.顯示所有已建立的語言ID。
5. BOOL SetLanguage(DWORD dwLocaleID)函數(shù)，改變運行系統(tǒng)中的語言設(shè)置。 定義運行系統(tǒng)語言的實例 { //德語 SetLanguage(0x0407); } 該運行系統(tǒng)語言被設(shè)置為德語。
6. void FillDiagnoseInTags(BOOL bfill)函數(shù)，激活或取消激活在變量中存儲診斷信息。由于填充變量表示附加系統(tǒng)負載，只應(yīng)為了診斷信息才激活它。
7. void GetServerTagPrefix(char** ppszServerPrefix, char** ppszTagPrefix, char** ppszWindowPrefix)函數(shù)，為了從分布式系統(tǒng)中的多客戶機訪問相關(guān)服務(wù)器中的變量，必須通過添加服務(wù)器前綴和變量前綴來擴展變量名。如果使用函數(shù)GetTagxx或SetTagxx訪問變量，該動作控件提供必要的擴展名。如果WinCC API函數(shù)被用來獲得訪問，必須由用戶擴展變量名。在這種情況下，GetServerTagPrefix函數(shù)提供必要的前綴。 分別為服務(wù)器前綴、變量前綴和窗口前綴返回一個“字符”類型的指針。 用戶既不修改(不包括strcat)也不釋放存儲器。 讀出服務(wù)器前綴的實例 { char* pszServerPrefix; char* pszTagPrefix; char* pszWindowPrefix; //獲得服務(wù)器前綴和變量前綴 GetServerTagPrefix (&pszServerPrefix, &pszTagPrefix, &pszWindowPrefix); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } GetServerTagPrefix函數(shù)參數(shù)： “pszServerPrefix”是在其中寫入服務(wù)器前綴的變量。 “pszTagPrefix”是在其中寫入變量前綴的變量。 “pszWindowPrefix”是在其中寫入窗口前綴的變量。 1）. 讀出服務(wù)器前綴、變量前綴和窗口前綴。 2）. 返回的服務(wù)器前綴緩沖存儲在pszServerPrefix中。 3）. 返回的變量前綴緩沖存儲在pszTagPrefix中。 4）. 返回的窗口前綴緩沖存儲在pszWindowPrefix中。 5）. 執(zhí)行處理返回值的自定義代碼。 讀出服務(wù)器前綴的實例 { char* pszServerPrefix; char* pszTagPrefix; char* pszWindowPrefix; int nServerPrefixLen = 0; int nTagPrefixLen = 0; int nTagLen = 0; char myTagName[MAX_DM_VAR_NAME+1]; //初始化返回值 memset(myTagName,0,MAX_DM_VAR_NAME + 1); //獲得服務(wù)器前綴、變量前綴和窗口前綴 GetServerTagPrefix (&pszServerPrefix, &pszTagPrefix, &pszWindowPrefix); //是否存在服務(wù)器前綴 if (pszServerPrefix) { //獲得該字符串的長度 nServerPrefixLen = strlen(pszServerPrefix); } else { printf("No server prefix was returned."); return; } //是否存在變量前綴 if (pszTagPrefix) { //獲得該字符串的長度 nTagPrefixLen = strlen(pszTagPrefix); } //獲得該變量的長度 nTagLen = strlen("TagName"); //檢查長度 //ServerPrefix+TagPrefix+VarName + the double points < MAX_DM_VAR_NAME if (nServerPrefixLen + nTagPrefixLen + nTagLen+2 < MAX_DM_VAR_NAME) { sprintf(myTagName,"%s::%s%s",pszServerPrefix,pszTagPrefix,"TagName"); //自定義代碼 //在那里用戶可以使用返回值做某事 ... } else { printf("The resulting string is too long."); return; } } 1）. 初始化myTagName變量。 2）. 讀出服務(wù)器前綴、變量前綴和窗口前綴。 3）. 如果未返回服務(wù)器前綴，發(fā)出文本，并且該函數(shù)被終止。 4）. 如果返回服務(wù)器前綴，建立其長度并將其存儲在nServerPrefixLen中。 5）. 如果返回變量前綴，建立其長度并將其存儲在nTagPrefixLen中。 6）. 確定變量名的長度和nVarLen中的緩沖區(qū)。 7）. 如果變量名的長度太長，發(fā)出文本，并且該函數(shù)被終止。 8）. 如果變量名的長度不太長，組成多客戶機環(huán)境要求的變量名。 9）. 執(zhí)行處理返回值的自定義代碼。
8. void TraceText(DWORD dwTraceLevel, char* pszFormat, <Parameter>)函數(shù)，達到定義的診斷標準時，在<參數(shù)>中指定的數(shù)值被記錄在APDiag內(nèi)。
9. void TraceTime(DWORD dwTraceLevel, char* pszFormat, <Parameter>)函數(shù)，達到定義的診斷標準時，在<參數(shù)>中指定的數(shù)值被記錄在APDiag內(nèi)。 此外，為了允許性能測評，發(fā)布從AP開始診斷的時間(毫秒)。 |
|
|
來自： xiaoxiaollll > 《我的圖書館》
