wincc全部函数-经典

在WinCC的全局脚本里有几种函数专门是用来提取(GetTag函数)和设置函数值(SetTag函数)的。这里的列表给出了不同的函数及它们的功能：SetTag函数：SetTagxxx此函数给作业赋予一个值去写，然后立即返回到调用函数。它并不等到值实际写好后再返回。该调用的明显特点是：此调用比较快。调用函数并不清楚这个值实际是在何时写的。该函数也不提供写作业状态的有关信息。SetTagxxxWait此函数给作业赋予一个值去写，但是只有当值已经写好后才返回到调用函数。该调用的明显特点是：该调用慢于SetTagxxx。其实际速度取决于通道和PLC的其它因素。调用后值已经实际写好。该函数不提供写作业状态的有关信息。SetTagxxxState此函数具有SetTagxxx相同的特点。另外，SetTagxxxState函数还提供写作业的状态的信息。由于状态永远是内部提供的，故相比于SetTagxxx性能上没有什么差别。SetTagxxxStateWait此函数具有与SetTagxxxWait相同的特点。但是SetTagxxxStateWait函数还提供了写作业的状态信息。由于状态永远是内部提供的，故相比于SetTagxxxWait性能上没有什么差别。SetTagxxxStateWait与SetTagxxxState这两个函数间的差别与SetTagxxxWait与SetTagxxx这两个函数间的差别相对应。注意：当写过程结束时只能给出某些状态。SetTagMultiWait此函数的特点与SetTagxxxWait相同。但是它也提供在一个作业里发出多个写作业的选件。GetTag函数：GetTagxxx当此函数被调用时变量被注册下来。然后变量受到PLC的周期性请求。注册的周期取决于触发器（参看下面的叙述）。使用GetTagxxx调用，提供了WinCC中的可用值。取消了对图象的选择后，变量被再次注消。注意：如果变量在一个全局脚本动作里被请求，那么它将对WinCC的整个运行系统保持注册状态。在回调函数里你必须使用相应的GetTagxxxWait函数。变量触发器的动作特点在规定的监控时间里选择图像那一刻，变量触发器里包含的所有变量已经注册。如果触发器里包含了被请求的变量，那么它的值已经可用并直接传送到调用。注意：如果被请求的一个变量不包含在变量触发器中，则其动作将与标准触发器一样。标准变量触发器的动作特点第一次调用时，变量在半个周期时间里被注册。其值对于后续的每个调用都可用。事件触发动作的特点对于第一次调用，“当被修改后”变量被注册。对于过程变量，其计时过程的管理取决于通道（缺省为1秒）。注意：如果在鼠标单击事件背后由函数GetTagXXX请求一个值，那么变量被注册，而且该变量自此之后被PLC周期性的请求。这增加了基本负荷。因此必须考虑是否用GetTagXXXWait请求值更好（只有一次高通讯负荷），也可因之避免注册（增加基本负荷）。GetTagxxxWait变量不注册。值仅仅被PLC请求一次。此调用有下述特点：此调用相比与GetTagxxx用的时间要长。其延续时间由通道和PLC决定。当前值取自PLC。该函数不提供变量状态的任何信息。GetTagxxxState此函数具有与GetTagxxx相同的特点。但是GetTagxxxState函数另外还提供变量状态的信息。由于状态永远是内部提供的，故相比于GetTagxxx性能上没有什么差别。GetTagxxxStateWait此函数具有与GetTagxxxWait相同的特点。但是GetTagxxxStateWait函数另外还提供变量状态的信息。由于状态永远是内部提供的，故相比于GetTagxxxWait性能上没有什么差别。GetTagxxxStateWait与GetTagxxxState函数的差别对应于GetTagxxxWait和GetTagxxx函数将的差别。注意，由于过程变量的值是从PLC读得，它的状态要比GetTagxxxState给出的状态要更新一些。GetTagMultiWait此函数具有与GetTagxxxWait相同的特点。但是它也提供在一个作业里请求多个变量的选件。）另外，WinCC还提供了脚本中高效数据交换（批量读写）的函数和方法：GetTagMultiWait/SetTagMultiWait（VBS中的TagSet）和原始数据类型RawData。其中GetTagMultiWait是同步方式，可以一次读取上百个不同类型的WinCC变量（不是数组），而所花费的时间却和GetTagWait函数调用一次的时间差别不明显，优化效果极为显著。而WinCC的原始数据类型RawData大家都比较熟悉了，以数组方式和PLC交换数据，优点：数据量大，缺点：无法直接在画面等处直接使用，需要脚本拆解。标准函数该系统包含标准函数。可以按需要修改这些函数。此外，还可以自己创建标准函数。该系统包括一个标准函数集。一、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函