WINCC C脚本的标准函数

本文格式为Word版，下载可任意编辑——WINCCC脚本的标准函数WINCCC脚本的标准函数1

标准函数

该系统包含标准函数。可以按需要修改这些函数。此外，还可以自己创立标准函数。该系统包括一个标准函数集。一、Alarm-简短描述

Alarm组包含控制WinCC报警控件的函数。标准函数可用于工具栏中的每一个按钮。这些函数可用来创立自定义工具栏，例如选择画面,或者定义控件上的设置。

1．voidAcknowledgeMessage(DWORDMsgNr)函数，确认消息系统中带编号的消息，该编号被传递为参数。

使用标准函数操作WinCC报警控件的实例{//确认选择的报警记录消息

AcknowledgeMessage(GetTagWord(\}

指定待确认的消息号。在本例中是从变量读取的。2．BOOLAXC_OnBtnArcLong(char*lpszPictureName,char*pszMsgWin)函数，在消息窗口中该函数表示消息存储在长期归档中。

使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

3．BOOLAXC_OnBtnArcShort(char*lpszPictureName,char*pszMsgWin)函数，在消息窗口中该函数表示消息存储在短期归档中。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

4．BOOLAXC_OnBtnComment(char*lpszPictureName,char*pszMsgWin)函数外部消息窗口操作，该函数显示从前所选消息的解释。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

5．BOOLAXC_OnBtnEmergAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，此函数开启确认对话框(紧急确认/复位)。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

6．BOOLAXC_OnBtnHornAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数确认蜂鸣器信号。

使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

7．BOOLAXC_OnBtnInfo(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数显示信息文本。

使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

7．BOOLAXC_OnBtnLock(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数开启“设置锁定〞对话框。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

8．BOOLAXC_OnBtnLockUnlock(char*lpszPictureName,char*pszMsgWin)，函数，该函数锁住在消息窗口中选择的消息。之后，不再归档该消息。该函数释放在锁定列表中选择的消息。

使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

9．BOOLAXC_OnBtnLockWin(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作.该函数调用锁定列表。

使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

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

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

11．BOOLAXC_OnBtnMsgFirst(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表的开始处。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

12．BOOLAXC_OnBtnMsgLast(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表的终止处。使用标准函数操作WinCC报警控件的实例

{//跳转到WinCC报警控件中的最终一条消息AXC_OnBtnMsgLast(\}

AXC_OnBtnMsgLast函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

13．BOOLAXC_OnBtnMsgNext(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表中的下一条消息。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

14．BOOLAXC_OnBtnMsgPrev(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数移动到消息列表中的前一条消息。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

15．BOOLAXC_OnBtnMsgWin(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数调用过程消息窗口。

使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

16．BOOLAXC_OnBtnPrint(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，打印机打印出符合在报警控件中定义的选择标准的全部消息。WinCC报警控件的实例

{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

17．BOOLAXC_OnBtnScroll(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数激活水平和垂直滚动功能。使用标准函数操作WinCC报警控件的实例{//激活/取消激活滚动功能

AXC_OnBtnScroll(\}

AXC_OnBtnScroll函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

18．BOOLAXC_OnBtnSelect(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数开启“设置选择〞对话框。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

AXC_OnBtnMsgFirst函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

19．BOOLAXC_OnBtnSinglAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，该函数确认当前所选的消息。使用标准函数操作WinCC报警控件的实例{//确认激活的消息

AXC_OnBtnSinglAckn(\}

AXC_OnBtnSinglAckn函数参数：

“gs_alarm_00〞是在其中组态WinCC报警控件的画面的名称。Control1是WinCC报警控件的对象名。

20．BOOLAXC_OnBtnVisibleAckn(char*lpszPictureName,char*pszMsgWin)函数，外部消息窗口操作，确认消息窗口中可见的全部消息(组确认)。使用标准函数操作WinCC报警控件的实例{//跳转到WinCC报警控件中的第一条消息AXC_OnBtnMsgFirst(\}

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

(//设置过滤器名称strcpy

(Filter.szFilterName,\//挑拣选择元素Filter

.dwFilter=MSG_FILTER_NR_FROM|MSG_FILTER_NR_TO;//消息号来自Filter.dwMsgNr[0]=2;//消息号来自Filter.dwMsgNr[1]=2;

ret=AXC_SetFilter(\}

1.命名该过滤器。2.选择过滤器的类型。3.指定过滤器标准。4.设置过滤器。常规使用解释

过滤器类型和过滤器标准必需适合使用；在过滤器结构中描述所有其它的过滤器类型。使用标准函数操作WinCC报警控件的实例{BOOLret;

MSG_FILTER_STRUCTFilter;CMN_ERRORError;

//删除整个过滤器结构memset

(//设置空的过滤器结构AXC

_SetFilter(\}

1.删除该过滤器结构。

2.用空值填充过滤器结构。结构定义MSG_FILTER_STRUCTtypedefstruct{

CHARszFilterName[MSG_MAX_TEXTLEN+1];WORDdwFilter;SYSTEMTIMEst[2];DWORDdwMsgNr[2];DWORDdwMsgClass;

DWORDdwMsgType[MSG_MAX_CLASS];DWORDdwMsgState;WORDwAGNr[2];WORDwAGSubNr[2];DWORDdwArchivMode;charszTB[MSG_MAX_TB][MSG_MAX_TB_CONTENT+1]DWORDdwTB;

DoubledPValue[MSG_MAX_PVALUE][2];DWORDdwPValue[2];

DWORDdwMsgCounter[2];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_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_TOdwMsgClass位代码消息等级

为过滤标准填充这个域：MSG_FILTER_CLASSdwMsgType

每个消息等级的位代码消息类型

为过滤标准填充这个域：MSG_FILTER_CLASSdwMsgState

位代码消息状态

为过滤标准填充这个域：MSG_FILTER_STATEwAGNr

AG号从...到...

为过滤标准填充这些域：MSG_FILTER_AG_FROM和MSG_FILTER_AG_TOwAGSubNr

AGSubNr从...到

为过滤标准填充这些域：MSG_FILTER_AGSUB_FROM和MSG_FILTER_AGSUB_TOdwArchivMode归档/协议识别必需用0填充。szTB

文本块文本

为过滤标准填充这个域：MSG_FILTER_TEXTdwTB

文本块激活(从...到...，位代码)

为过滤标准填充这个域：MSG_FILTER_TEXTdPValue

过程值从...到...

为过滤标准填充这个域：MSG_FILTER_PVALUEdwPValue

过程值激活(从...到...位代码)

为过滤标准填充这个域：MSG_FILTER_PVALUEdwMsgCounter

内部消息计数器从...到...

为过滤标准填充这些域：MSG_FILTER_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*(往回计算月，日，小时)。

结构定义CMNERROR

structCMNERRORSTRUCT{DWORDdwError1,DWORDdwError2,DWORDdwError3,DWORDdwError4,DWORDdwError5;

TCHARszErrorText[MAX_ERROR_LEN];}

CMNERROR描述

扩展的错误结构包含错误代码和与发生的错误相关的错误文本。每个应用程序可以使用该错误结构评价或发出错误消息。组成部分

dwError1..dwError5

可按API函数的要求使用这些条目。

API描述包含出错时条目的各自数值。否则，错误代码在dwError1中。szErrorText

错误代码的文本描述缓冲区

从资源建立该内容，因此依靠于语言。BOOLGMsgFunction(char*pszMsgData)函数该函数提供消息数据。

表示单个消息的全局函数。为每个消息调用全局函数，为每个消息设置“触发动作〞参数。

最好在项目函数中解释消息数据，从GMsgFunction调用项目函数。参数

pszMsgData

指向在其中存储消息数据的缓冲区的指针。返回值TRUE

已执行函数，无错。FALSE出错。注意

请注意，WinCC安装会重写已修改的标准函数，所以被改变的函数丢失。

Graphics-简短描述

Graphics组包含用于编程图形系统的函数。

1．char*GetLinkedVariable(char*lpszPictureName,char*lpszObjectName,char*lpszPropertyName)函数，提供与指定的对象属性链接的变量的名称。读出直接连接的变量名的实例。{char*pszVarName=NULL;

charszVarName[_MAX_PATH+1];//获得变量名pszVarName

=GetLinkedVariable(\//复制字符串

if(pszVarName!=NULL)

{strncpy(szVarName,pszVarName,_MAX_PATH);}

//自定义代码

//在那里用户可以使用返回值做某事...}

GetLinkedVariable函数参数：

“gs_stand_graph_00〞是在其中组态该对象的画面的名称。“StaticText6〞是该对象的名称。“Visible〞是链接到变量的属性。

1）.将函数GetLinkedVariable的返回值缓冲存储在pszVarName中。

2）.假使返回有效数值，将该返回值存储在szVarName中。最多存储_MAX_PATH个字符。

3）.执行处理返回值的自定义代码。

2．char*GetLocalPicture(char*lpszPictureName)函数，返回指向画面名的指针。在这种状况下，画面名就是该文件名，不带扩展名“.PDL〞。读出本地画面的实例。{char*pszPicName=NULL;

charszPicName[_MAX_PATH+1];//获得本地画面pszPicName

=GetLocalPicture(lpszPictureName);//复制字符串

if(pszPicName!=NULL)

{strncpy(szPicName,pszPicName,_MAX_PATH);}//自定义代码

//在那里用户可以使用返回值做某事...}

1).将函数GetLocalPicture的返回值缓冲存储在pszPicName中。

2).假使返回有效数值，将该返回值存储在szPicName中。最多存储_MAX_PATH个字

4.BOOLGetCheckLimitHigh4(LPCTSTRlpszPictureName,LPCTSTRlpszObjectName)函数,使用棒图对象时，它指定是否监控上限值Reserve4。读出布尔型属性的实例{

BOOLbmarker;

//获得该标记的状态bmarker

=GetMarker(lpszPictureName,\if(bmarker){

//自定义代码//标记是否被激活...}else{

//自定义代码

//标记是否被取消激活...}}

GetMarker函数参数：

“lpszPictureName〞是在其中组态该对象的画面的名称。“Bar1〞是该对象的名称。

Link-简短描述

使用Link组中的函数可以创立或调用变量链接属性。

1.BOOLGetLink(LPCTSTRlpszPictureName,LPCTSTRlpszObjectNameLPCTSTRlpszPropertyName,LPLINKINFO*pLink)函数,指定对象属性的当前变量链接。读出变量链接的实例{

LINKINFOlinkinfo;//获得已链接的变量

GetLink(lpszPictureName,\//linkinfo.szLinkName是变量名//linkinfo.dwCycle是更新周期//linkinfo.LinkType是连接的类型//自定义代码

//在那里用户可以使用返回值做某事...}

GetLink函数参数：

“lpszPictureName〞是在其中组态该对象的画面的名称。“Bar1〞是该对象的名称。

“Process〞是链接到变量的属性。“

//获得可见性bVisible

=GetVisible(lpszPictureName,\if(bVisible){

//自定义代码//该对象是否可见...}else{

//自定义代码

//该对象是否不可见...}}

GetVisible函数参数：

“lpszPictureName〞是在其中组态该对象的画面的名称。“GraphicObject1〞是该对象的名称。

2.BOOLGetAdaptPicture(LPCTSTRlpszPictureName,LPCTSTRlpszObjectName)函数,对于画面窗口，它指定画面是否将适应窗口的大小。读出布尔型属性的实例{

BOOLbVisible;

//获得可见性bVisible

=GetVisible(lpszPictureName,\if(bVisible){

//自定义代码//该对象是否可见...

}else{

//自定义代码

//该对象是否不可见...}}

GetVisible函数参数：

“lpszPictureName〞是在其中组态该对象的画面的名称。“GraphicObject1〞是该对象的名称。

3.BOOLGetAdaptSize(LPCTSTRlpszPictureName,LPCTSTRlpszObjectName)函数,对于画面窗口，它指定是否改变窗口。读出布尔型属性的实例{

BOOLbVisible;

//获得可见性bVisible

=GetVisible(lpszPictureName,\if(bVisible){

//自定义代码//该对象是否可见...}else{

//自定义代码

//该对象是否不可见...}}

GetVisible函数参数：

“lpszPictureName〞是在其中组态该对象的画面的名称。“GraphicObject1〞是该对象的名称。

4.BOOLGetAverage(LPCTSTRlpszPictureName,LPCTSTRlpszObjectName)函数,对于棒图对象，指定是否激活平均值计算。读出布尔型属性的实例{

BOOLbVisible;

//获得可见性bVisible

=GetVisible(lpszPictureName,\

if(bVisible){

//自定义代码//该对象是否可见...}else{

//自定义代码

//该对象是否不可见...}}

GetVisible函数参数：

“lpszPictureName〞是在其中组态该对象的画面的名称。“GraphicObject1〞是该对象的名称。

5.BOOLGetCaption(LPCTSTRlpszPictureName,LPCTSTRl