WinCC标准函数总结.docx
《WinCC标准函数总结.docx》由会员分享,可在线阅读,更多相关《WinCC标准函数总结.docx(80页珍藏版)》请在冰豆网上搜索。
WinCC标准函数总结
标准函数
该系统包含标准函数。
可以按需要修改这些函数。
此外,还可以自己创建标准函数。
该系统包括一个标准函数集。
一、Alarm-简短描述
Alarm组包含控制WinCC报警控件的函数。
标准函数可用于工具栏中的每一个按钮。
这些函数可用来创建自定义工具栏,例如选择画面,或者定义控件上的设置。
1.voidAcknowledgeMessage(DWORDMsgNr)函数,确认消息系统中带编号的消息,该编号被传递为参数。
使用标准函数操作WinCC报警控件的实例
{//确认选择的报警记录消息
AcknowledgeMessage(GetTagWord("U08i_MsgNr"));
}
指定待确认的消息号。
在本例中是从变量读取的。
2.BOOLAXC_OnBtnArcLong(char*lpszPictureName,char*pszMsgWin)函数,在消息窗口中该函数表示消息存储在长期归档中。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
3.BOOLAXC_OnBtnArcShort(char*lpszPictureName,char*pszMsgWin)函数,在消息窗口中该函数表示消息存储在短期归档中。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
4.BOOLAXC_OnBtnComment(char*lpszPictureName,char*pszMsgWin)函数
外部消息窗口操作,该函数显示先前所选消息的注释。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
5.BOOLAXC_OnBtnEmergAckn(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,此函数打开确认对话框(紧急确认/复位)。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
6.BOOLAXC_OnBtnHornAckn(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数确认蜂鸣器信号。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
7.BOOLAXC_OnBtnInfo(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数显示信息文本。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
7.BOOLAXC_OnBtnLock(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数打开“设置锁定”对话框。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
8.BOOLAXC_OnBtnLockUnlock(char*lpszPictureName,char*pszMsgWin),函数,该函数锁住在消息窗口中选择的消息。
之后,不再归档该消息。
该函数释放在锁定列表中选择的消息。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
9.BOOLAXC_OnBtnLockWin(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作.该函数调用锁定列表。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
10.BOOLAXC_OnBtnLoop(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,此函数触发所选消息的“报警回路”函数。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
11.BOOLAXC_OnBtnMsgFirst(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数移动到消息列表的开始处。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
12.BOOLAXC_OnBtnMsgLast(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数移动到消息列表的结束处。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的最后一条消息
AXC_OnBtnMsgLast("gs_alarm_00","Control1");
}
AXC_OnBtnMsgLast函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
13.BOOLAXC_OnBtnMsgNext(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数移动到消息列表中的下一条消息。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
14.BOOLAXC_OnBtnMsgPrev(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数移动到消息列表中的前一条消息。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
15.BOOLAXC_OnBtnMsgWin(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数调用过程消息窗口。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
16.BOOLAXC_OnBtnPrint(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,打印机打印出符合在报警控件中定义的选择标准的全部消息。
WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
17.BOOLAXC_OnBtnScroll(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数激活水平和垂直滚动功能。
使用标准函数操作WinCC报警控件的实例
{//激活/取消激活滚动功能
AXC_OnBtnScroll("gs_alarm_00","Control1");
}
AXC_OnBtnScroll函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
18.BOOLAXC_OnBtnSelect(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数打开“设置选择”对话框。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
19.BOOLAXC_OnBtnSinglAckn(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,该函数确认当前所选的消息。
使用标准函数操作WinCC报警控件的实例
{//确认激活的消息
AXC_OnBtnSinglAckn("gs_alarm_00","Control1");
}
AXC_OnBtnSinglAckn函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
20.BOOLAXC_OnBtnVisibleAckn(char*lpszPictureName,char*pszMsgWin)函数,外部消息窗口操作,确认消息窗口中可见的全部消息(组确认)。
使用标准函数操作WinCC报警控件的实例
{//跳转到WinCC报警控件中的第一条消息
AXC_OnBtnMsgFirst("gs_alarm_00","Control1");
}
AXC_OnBtnMsgFirst函数参数:
“gs_alarm_00”是在其中组态WinCC报警控件的画面的名称。
Control1是WinCC报警控件的对象名。
21.BOOLAXC_SetFilter(char*lpszPictureName,char*lpszObjectName,LPMSG_FILTER_STRUCTlpMsgFilter,LPCMN_ERROR,lpError)函数,外部消息窗口操作,该函数为WinCC报警控件设置过滤器,以便根据指定的过滤标准筛选出可用的消息。
使用标准函数操作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
.dwMsgNr[0]=2;
//消息号来自Filter
.dwMsgNr[1]=2;
ret=AXC_SetFilter("gs_alarm_00","Control1",&Filter,&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.用空值填充过滤器结构。
结构定义MSG_FILTER_STRUCT
typedefstruct{
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;
描述
在该结构中定义过滤标准。
组成部分
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_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
日期从...到...
MSG_FILTER_TIME
日期从...到...
MSG_FILTER_NR
消息号从...到...
st
日期/时间从...到...
在这种情况下,st[0]是开始时间(从),st[1]是结束时间(到)
为过滤标准填充这些域:
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
消息号从...到...
在这种情况下,dwMsgNr[0]是开始号(从),dwMsgNr[1]是结束号(到)
为过滤标准填充这些域:
MSG_FILTER_NR,MSG_FILTER_NR_FROM和MSG_FILTER_NR_TO
dwMsgClass
位代码消息等级
为过滤标准填充这个域:
MSG_FILTER_CLASS
dwMsgType
每个消息等级的位代码消息类型
为过滤标准填充这个域:
MSG_FILTER_CLASS
dwMsgState
位代码消息状态
为过滤标准填充这个域:
MSG_FILTER_STATE
wAGNr
AG号从...到...
为过滤标准填充这些域:
MSG_FILTER_AG_FROM和MSG_FILTER_AG_TO
wAGSubNr
AGSubNr从...到
为过滤标准填充这些域:
MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TO
dwArchivMode
归档/协议识别
必须用0填充。
szTB
文本块文本
为过滤标准填充这个域:
MSG_FILTER_TEXT
dwTB
文本块激活(从...到...,位代码)
为过滤标准填充这个域:
MSG_FILTER_TEXT
dPValue
过程值从...到...
为过滤标准填充这个域:
MSG_FILTER_PVALUE
dwPValue
过程值激活(从...到...位代码)
为过滤标准填充这个域:
MSG_FILTER_PVALUE
dwMsgCounter
内部消息计数器从...到...
为过滤标准填充这些域:
MSG_FILTER_COUNTER_FROM,MSG_FILTER_COUNTER_TO
dwQuickSelect
快速选择小时,天,月
为以后扩展而保留该参数,并且必须用0预定义。
为过滤标准填充这个域:
MSG_FILTER_QUICKSELECT
LOWORD类型:
MSG_FILTER_QUICK_MONTH
快速选择后n个月
MSG_FILTER_QUICK_DAYS
快速选择后n天
MSG_FILTER_QUICK_HOUR
快速选择后n个小时
HIWORD号:
1...n
快速选择函数的结束时间与本地计算机的当前系统时间有关。
开始时间是n*(往回计算月,日,小时)。
结构定义CMNERROR
structCMNERRORSTRUCT{
DWORD dwError1,
DWORD dwError2,
DWORD dwError3,
DWORD dwError4,
DWORD dwError5;
TCHAR szErrorText[MAX_ERROR_LEN];
}
CMNERROR
描述
扩展的错误结构包含错误代码和与发生的错误相关的错误文本。
每个应用程序可以使用该错误结构评价或发出错误消息。
组成部分
dwError1..dwError5
可按API函数的要求使用这些条目。
API描述包含出错时条目的各自数值。
否则,错误代码在dwError1中。
szErrorText
错误代码的文本描述缓冲区
从资源建立该内容,因此依赖于语言。
BOOLGMsgFunction(char*pszMsgData)函数
该函数提供消息数据。
表示单个消息的全局函数。
为每个消息调用全局函数,为每个消息设置“触发动作”参数。
最好在项目函数中解释消息数据,从GMsgFunction调用项目函数。
参数
pszMsgData
指向在其中存储消息数据的缓冲区的指针。
返回值
TRUE
已执行函数,无错。
FALSE
出错。
注意
请注意,WinCC安装会重写