wincc标准函数注解Word文档格式.docx

1、Control1）;AXC_OnBtnMsgFirst函数参数：“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。Control 1是WinCC报警控件的对象名。 3BOOL AXC_OnBtnArcShort（char* lpszPictureName, char* pszMsgWin）函数，在消息窗口中该函数表示消息存储在短期归档中。4BOOL AXC_OnBtnComment（char* lpszPictureName, char* pszMsgWin）函数外部消息窗口操作，该函数显示先前所选消息的注释。5BOOL AXC_OnBtnEmergAckn（char* l

2、pszPictureName, char* pszMsgWin）函数，外部消息窗口操作，此函数打开确认对话框（紧急确认/复位）。6BOOL AXC_OnBtnHornAckn（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数确认蜂鸣器信号。7BOOL AXC_OnBtnInfo（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数显示信息文本。7BOOL AXC_OnBtnLock（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操

3、作，该函数打开“设置锁定”对话框。8BOOL AXC_OnBtnLockUnlock（char* lpszPictureName, char* pszMsgWin），函数，该函数锁住在消息窗口中选择的消息。之后，不再归档该消息。该函数释放在锁定列表中选择的消息。9BOOL AXC_OnBtnLockWin（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作.该函数调用锁定列表。10BOOL AXC_OnBtnLoop（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，此函数触发所选消息的“报警

4、回路”函数。11BOOL AXC_OnBtnMsgFirst（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数移动到消息列表的开始处。12BOOL AXC_OnBtnMsgLast（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数移动到消息列表的结束处。/ 跳转到WinCC报警控件中的最后一条消息AXC_OnBtnMsgLast（AXC_OnBtnMsgLast函数参数：13BOOL AXC_OnBtnMsgNext（char* lpszPictureName, char*

5、pszMsgWin）函数，外部消息窗口操作，该函数移动到消息列表中的下一条消息。14BOOL AXC_OnBtnMsgPrev（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数移动到消息列表中的前一条消息。15BOOL AXC_OnBtnMsgWin（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数调用过程消息窗口。16BOOL AXC_OnBtnPrint（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，打印机打印出符合

6、在报警控件中定义的选择标准的全部消息。WinCC报警控件的实例17BOOL AXC_OnBtnScroll（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数激活水平和垂直滚动功能。/ 激活/取消激活滚动功能AXC_OnBtnScroll（AXC_OnBtnScroll函数参数：18BOOL AXC_OnBtnSelect（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，该函数打开“设置选择”对话框。19BOOL AXC_OnBtnSinglAckn（char* lpszPictur

7、eName, char* pszMsgWin）函数，外部消息窗口操作，该函数确认当前所选的消息。/ 确认激活的消息AXC_OnBtnSinglAckn（AXC_OnBtnSinglAckn函数参数：20BOOL AXC_OnBtnVisibleAckn（char* lpszPictureName, char* pszMsgWin）函数，外部消息窗口操作，确认消息窗口中可见的全部消息（组确认）。21BOOL AXC_SetFilter（char* lpszPictureName, char* lpszObjectName, LPMSG_FILTER_STRUCT lpMsgFilter, LPC

8、MN_ERROR, lpError）函数，外部消息窗口操作，该函数为WinCC报警控件设置过滤器，以便根据指定的过滤标准筛选出可用的消息。BOOL ret;MSG_FILTER_STRUCT Filter;CMN_ERROR Error;/重新设置过滤器结构 memset（ &Filter, 0, sizeof（ MSG_FILTER_STRUCT ） ）;/设置过滤器名称 strcpy（ Filter.szFilterName, / 挑选选择元素 Filter.dwFilter = MSG_FILTER_NR_FROM | MSG_FILTER_NR_TO;/ 消息号来自 Filter.dw

9、MsgNr0 = 2;.dwMsgNr1 = 2;ret = AXC_SetFilter（,&Filter,&Error）;1. 命名该过滤器。2. 选择过滤器的类型。3. 指定过滤器标准。4. 设置过滤器。常规使用注释过滤器类型和过滤器标准必须适合使用；在过滤器结构中描述所有其它的过滤器类型。/删除整个过滤器结构 memset/设置空的过滤器结构 AXC_SetFilter（Control 11. 删除该过滤器结构。2. 用空值填充过滤器结构。结构定义MSG_FILTER_STRUCTtypedef struct CHARszFilterNameMSG_MAX_TEXTLEN+1;WORDd

10、wFilter;SYSTEMTIMEst2;DWORDdwMsgNr2;dwMsgClass;dwMsgTypeMSG_MAX_CLASS;dwMsgState;wAGNr2;wAGSubNr2;dwArchivMode;charszTBMSG_MAX_TBMSG_MAX_TB_CONTENT+1dwTB;DoubledPValueMSG_MAX_PVALUE2;dwPValue2;dwMsgCounter2;dwQuickSelect;MSG_FILTER_STRUCT;描述在该结构中定义过滤标准。组成部分dwFilter通过下列常数从“m_global.h”文件定义过滤条件：MSG_FIL

11、TER_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_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_FI

12、LTER_COUNTER_FROM从内部消息计数器MSG_FILTER_COUNTER_TO到内部消息计数器MSG_FILTER_PROCESSMSG过程消息MSG_FILTER_SYSMSG系统消息MSG_FILTER_BEDMSG事件消息MSG_FILTER_DATE日期从.到.MSG_FILTER_TIMEMSG_FILTER_NR消息号从.到.st日期/时间从.到.在这种情况下，st0是开始时间（从），st1是结束时间（到）为过滤标准填充这些域：MSG_FILTER_DATE，MSG_FILTER_DATE_FROM，MSG_FILTER_DATE_TO， MSG_FILTER_TIM

13、E，MSG_FILTER_TIME_FROM和MSG_FILTER_TIME_TO如果传送SYSTEMTIME参数要求当前时间，使用GetLocalTime函数而非GetSystemTime。通常这两个函数之间的时间差别很大。dwMsgNr在这种情况下，dwMsgNr0是开始号（从），dwMsgNr1是结束号（到）MSG_FILTER_NR，MSG_FILTER_NR_FROM和MSG_FILTER_NR_TOdwMsgClass位代码消息等级为过滤标准填充这个域：dwMsgType每个消息等级的位代码消息类型dwMsgState位代码消息状态wAGNrAG号从.到.MSG_FILTER_AG

14、_FROM和MSG_FILTER_AG_TOwAGSubNrAGSubNr从.到MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TOdwArchivMode归档/协议识别必须用0填充。szTB文本块文本dwTB文本块激活（从.到.，位代码）dPValue过程值从.到.dwPValue过程值激活（从.到. 位代码）dwMsgCounter内部消息计数器从.到.MSG_FILTER_COUNTER_FROM，MSG_FILTER_COUNTER_TOdwQuickSelect快速选择小时，天，月为以后扩展而保留该参数，并且必须用0预定义。MSG_FILTER_QUIC

15、KSELECTLOWORD类型：MSG_FILTER_QUICK_MONTH快速选择后n个月MSG_FILTER_QUICK_DAYS快速选择后n天MSG_FILTER_QUICK_HOUR快速选择后n个小时HIWORD号：1.n快速选择函数的结束时间与本地计算机的当前系统时间有关。开始时间是n * （往回计算月，日，小时）。结构定义CMNERRORstruct CMNERRORSTRUCT dwError1,DWORD dwError2,dwError3,dwError4,dwError5;TCHAR szErrorTextMAX_ERROR_LEN;CMNERROR扩展的错误结构包含错误代

16、码和与发生的错误相关的错误文本。每个应用程序可以使用该错误结构评价或发出错误消息。dwError1 . dwError5可按API函数的要求使用这些条目。API描述包含出错时条目的各自数值。否则，错误代码在dwError1中。szErrorText错误代码的文本描述缓冲区从资源建立该内容，因此依赖于语言。BOOL GMsgFunction（char* pszMsgData）函数该函数提供消息数据。表示单个消息的全局函数。为每个消息调用全局函数，为每个消息设置“触发动作”参数。最好在项目函数中解释消息数据，从GMsgFunction调用项目函数。参数pszMsgData指向在其中存储消息数据的缓冲区的指针。返回值TRUE已执行函数，无错。FALSE出错。注意请注意，WinCC安装会重写