WINCC 标准函数.docx

1、WINCC 标准函数标准函数该系统包含标准函数。可以按需要修改这些函数。此外，还可以自己创建标准函数。该系统包括一个标准函数集。一、Alarm-简短描述Alarm组包含控制WinCC报警控件的函数。标准函数可用于工具栏中的每一个按钮。这些函数可用来创建自定义工具栏，例如选择画面,或者定义控件上的设置。1voidAcknowledgeMessage(DWORDMsgNr)函数，确认消息系统中带编号的消息，该编号被传递为参数。使用标准函数操作WinCC报警控件的实例/确认选择的报警记录消息AcknowledgeMessage(GetTagWord(U08i_MsgNr);指定待确认的消息号。在本例

2、中是从变量读取的。2BOOLAXC_OnBtnArcLong(char*lpszPictureName,char*pszMsgWin)函数，在消息窗口中该函数表示消息存储在长期归档中。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。3BOOLAXC_OnBtnArcShort(char*lpszPictureName,char

3、*pszMsgWin)函数，在消息窗口中该函数表示消息存储在短期归档中。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。4BOOLAXC_OnBtnComment(char*lpszPictureName,char*pszMsgWin)函数外部消息窗口操作，该函数显示先前所选消息的注释。使用标准函数操作WinCC报警控件的实例

4、/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。5BOOLAXC_OnBtnEmergAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，此函数打开确认对话框(紧急确认/复位)。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_0

5、0,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。6BOOLAXC_OnBtnHornAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数确认蜂鸣器信号。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC

6、报警控件的画面的名称。Control1是WinCC报警控件的对象名。7BOOLAXC_OnBtnInfo(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数显示信息文本。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。7BOOLAXC_OnBtnLock(char*lpszP

7、ictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数打开“设置锁定”对话框。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。8BOOLAXC_OnBtnLockUnlock(char*lpszPictureName,char*pszMsgWin)，函数，该函数锁住在消息窗口中选择的消息。之后，不再

8、归档该消息。该函数释放在锁定列表中选择的消息。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。9BOOLAXC_OnBtnLockWin(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作.该函数调用锁定列表。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一

9、条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。10BOOLAXC_OnBtnLoop(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，此函数触发所选消息的“报警回路”函数。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnM

10、sgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。11BOOLAXC_OnBtnMsgFirst(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表的开始处。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Contro

11、l1是WinCC报警控件的对象名。12BOOLAXC_OnBtnMsgLast(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表的结束处。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的最后一条消息AXC_OnBtnMsgLast(gs_alarm_00,Control1);AXC_OnBtnMsgLast函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。13BOOLAXC_OnBtnMsgNext(char*lpszPictur

12、eName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表中的下一条消息。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。14BOOLAXC_OnBtnMsgPrev(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表中的前一条消息。

13、使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。15BOOLAXC_OnBtnMsgWin(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数调用过程消息窗口。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(

14、gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。16BOOLAXC_OnBtnPrint(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，打印机打印出符合在报警控件中定义的选择标准的全部消息。WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alar

15、m_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。17BOOLAXC_OnBtnScroll(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数激活水平和垂直滚动功能。使用标准函数操作WinCC报警控件的实例/激活/取消激活滚动功能AXC_OnBtnScroll(gs_alarm_00,Control1);AXC_OnBtnScroll函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。18BOOLAXC_OnBtnSe

16、lect(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数打开“设置选择”对话框。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。19BOOLAXC_OnBtnSinglAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作

17、，该函数确认当前所选的消息。使用标准函数操作WinCC报警控件的实例/确认激活的消息AXC_OnBtnSinglAckn(gs_alarm_00,Control1);AXC_OnBtnSinglAckn函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。20BOOLAXC_OnBtnVisibleAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，确认消息窗口中可见的全部消息(组确认)。使用标准函数操作WinCC报警控件的实例/跳转到WinCC报警控件中的第一条消息A

18、XC_OnBtnMsgFirst(gs_alarm_00,Control1);AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。21BOOLAXC_SetFilter(char*lpszPictureName,char*lpszObjectName,LPMSG_FILTER_STRUCTlpMsgFilter,LPCMN_ERROR,lpError)函数，外部消息窗口操作，该函数为WinCC报警控件设置过滤器，以便根据指定的过滤标准筛选出可用的消息。使用标准函数操作WinCC报警控件的

19、实例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,Control1,&Filter

20、,&Error);1.命名该过滤器。2.选择过滤器的类型。3.指定过滤器标准。4.设置过滤器。常规使用注释过滤器类型和过滤器标准必须适合使用；在过滤器结构中描述所有其它的过滤器类型。使用标准函数操作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;DWORDdwPValue2;

22、DWORDdwMsgCounter2;DWORDdwQuickSelect;MSG_FILTER_STRUCT;描述在该结构中定义过滤标准。组成部分dwFilter通过下列常数从“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_STATE 消息状态 MSG

23、_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 从内部消息计数器 MSG_FILTER_COUNTER_TO 到内部消息计数器 MSG_FILTER_PROCESSMSG 过程消息 MSG_FILTER_SYSMSG 系统消息 MSG_FILTER_BEDMSG 事件消息 MSG_FILTER_DATE 日期从.到.

24、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参数要求当前时间，使用GetLocalTime函数而非GetSystemTime。通常这两个函数之间的时间差别很大。dwMsgNr消息号从.到.在这种情况下，

25、dwMsgNr0是开始号(从)，dwMsgNr1是结束号(到)为过滤标准填充这些域：MSG_FILTER_NR，MSG_FILTER_NR_FROM和MSG_FILTER_NR_TOdwMsgClass位代码消息等级为过滤标准填充这个域：MSG_FILTER_CLASSdwMsgType每个消息等级的位代码消息类型为过滤标准填充这个域：MSG_FILTER_CLASSdwMsgState位代码消息状态为过滤标准填充这个域：MSG_FILTER_STATEwAGNrAG号从.到.为过滤标准填充这些域：MSG_FILTER_AG_FROM和MSG_FILTER_AG_TOwAGSubNrAGSub

26、Nr从.到为过滤标准填充这些域：MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TOdwArchivMode归档/协议识别必须用0填充。szTB文本块文本为过滤标准填充这个域：MSG_FILTER_TEXTdwTB文本块激活(从.到.，位代码)为过滤标准填充这个域：MSG_FILTER_TEXTdPValue过程值从.到.为过滤标准填充这个域：MSG_FILTER_PVALUEdwPValue过程值激活(从.到.位代码)为过滤标准填充这个域：MSG_FILTER_PVALUEdwMsgCounter内部消息计数器从.到.为过滤标准填充这些域：MSG_FILTER_

27、COUNTER_FROM，MSG_FILTER_COUNTER_TOdwQuickSelect快速选择小时，天，月为以后扩展而保留该参数，并且必须用0预定义。为过滤标准填充这个域：MSG_FILTER_QUICKSELECTLOWORD类型： MSG_FILTER_QUICK_MONTH 快速选择后n个月 MSG_FILTER_QUICK_DAYS 快速选择后n天 MSG_FILTER_QUICK_HOUR 快速选择后n个小时HIWORD号：1.n快速选择函数的结束时间与本地计算机的当前系统时间有关。开始时间是n*(往回计算月，日，小时)。结构定义CMNERRORstructCMNERRORS

28、TRUCTDWORDdwError1,DWORDdwError2,DWORDdwError3,DWORDdwError4,DWORDdwError5;TCHARszErrorTextMAX_ERROR_LEN;CMNERROR描述扩展的错误结构包含错误代码和与发生的错误相关的错误文本。每个应用程序可以使用该错误结构评价或发出错误消息。组成部分dwError1.dwError5可按API函数的要求使用这些条目。API描述包含出错时条目的各自数值。否则，错误代码在dwError1中。szErrorText错误代码的文本描述缓冲区从资源建立该内容，因此依赖于语言。BOOLGMsgFunction(char*pszMsgData)函数该函数提供消息数据。表示单个消息的全局函数。为每个消息调用全局函数，为每个消息设置“触发动作”参数。最好在项目函数中解释消息数据，从GMsgFunction调用项目函数。参数pszMsgData指向在其中存储消息数据的缓冲区的指针。返回值TRUE已执行函数，无错。FALSE出错。注意请注意，WinCC安装会重写已修改的标准函数，所以被改变的函数丢失。