System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)

Подождите немного. Документ загружается.

dwID

Contains the key ID of the tags if dwKeyType is set accordingly

szName

Contains the name of the tag if dwKeyType is set accordingly

lpvUserData

Pointer to application-specific data

3.4.3.8 Structure definition LINKINFO

typedef struct {

LINKTYPE LinkType;

DWORD dwCycle;

TCHAR szLinkName[256];

}

LINKINFO;

Members

LinkType

LinkType are enumeration constants defined in the "Trigger.h" file. They are to be integrated

into your script with the #include "Trigger.h" command and the corresponding enumeration

constants.

BUBRT_LT_NOLINK 0 no shortcut

BUBRT_LT_VARIABLE_DIRECT 1 direct tag

BUBRT_LT_VARIABLE_INDIRECT 2 indirect tag

BUBRT_LT_ACTION 3 C action

BUBRT_LT_ACTION_WIZARD 4 Dynamic Dialog

BUB_LT_DIRECT_CONNECTION 5 Direct connection

BUBRT_LT_ACTION_WIZARD_INPROC 6 Dynamic Dialog

For the function SetLink only the enumeration constants BUBRT_LT_VARIABLE_DIRECT and

BUBRT_LT_VARIABLE_INDIRECT may be used. The function GetLink allows to return all

listed enumeration constants.

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1551

dwCycle

Update cycle time

255 Picture cycle

235 Window Cycle

0 Upon change

1 250ms

2 500 ms

3 1 s

4 2 s

5 5s

6 10s

7 1min

8 5min

9 10min

10 1h

11-1

User cycle 1-5

szLinkName

Tag name

3.4.3.9 Structure definition MSG_FILTER_STRUCT

typedef struct {

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;

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

1552

System Manual, 11/2008,

Description

In this structure the filter criteria are specified.

Members

dwFilter

The filter conditions are defined by means of the following constants from the file "m_global.h":

MSG_FILTER_DATE_FROM Date from

MSG_FILTER_DATE_TO Date to

MSG_FILTER_TIME_FROM Time from

MSG_FILTER_TIME_TO Time to

MSG_FILTER_NR_FROM Message number from

MSG_FILTER_NR_TO Message number to

MSG_FILTER_CLASS Message classes

MSG_FILTER_STATE Message status

MSG_FILTER_AG_FROM AS number from

MSG_FILTER_AG_TO AS number to

MSG_FILTER_AGSUB_FROM AG subnumber from

MSG_FILTER_AGSUB_TO AG subnumber to

MSG_FILTER_TEXT Message texts

MSG_FILTER_PVALUE Process values

MSG_FILTER_COUNTER_FROM Internal message counter from

MSG_FILTER_COUNTER_TO Internal message counter to

MSG_FILTER_PROCESSMSG Process messages

MSG_FILTER_SYSMSG System messages

MSG_FILTER_BEDMSG Operator messages

MSG_FILTER_DATE Date from to

MSG_FILTER_TIME Time from to

MSG_FILTER_NR Message number from to

MSG_FILTER_VISIBLEONLY Display visible messages

MSG_FILTER_HIDDENONLY Display hidden messages

Date/time from - to

Where st[0] is the start time (from), st[1] the end time (to)

Assign these fields for the filter criteria: MSG_FILTER_DATE, MSG_FILTER_DATE_FROM,

MSG_FILTER_DATE_TO, MSG_FILTER_TIME, MSG_FILTER_TIME_FROM or

MSG_FILTER_TIME_TO

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1553

If a current time is needed for the transfer of a SYSTEMTIME parameter the function

GetLocalTime is to be used instead of GetSystemTime. As a rule there is a significant time

difference between these two functions.

dwMsgNr

Message number from - to

Where dwMsgNr[0] is the start no. (from), dwMsgNr[1] the end no. (to)

Assign these fields for the filter criteria: MSG_FILTER_NR, MSG_FILTER_NR_FROM or

MSG_FILTER_NR_TO

dwMsgClass

Message classes bit-coded.

Assign this field for the filter criterion: MSG_FILTER_CLASS

dwMsgType

Message type per message class, bit-coded

Assign this field for the filter criterion: MSG_FILTER_CLASS

dwMsgState

Message status bit-coded.

Assign this field for the filter criterion: MSG_FILTER_STATE

wAGNr

AGNr from - to

Assign these fields for the filter criteria: MSG_FILTER_AG_FROM or MSG_FILTER_AG_TO

wAGSubNr

AGSubNr from - to

Assign this field for the filter criteria: MSG_FILTER_AGSUB_FROM or

MSG_FILTER_AGSUB_TO

dwArchivMode

Archiving / logging

Must be assigned 0.

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

1554

System Manual, 11/2008,

szTB

Texts of the text blocks

Assign these fields for the filter criterion: MSG_FILTER_TEXT

dwTB

Active text blocks (from - to, bit-coded)

Assign this field for the filter criterion: MSG_FILTER_TEXT

dPValue

Process values from - to

Assign these fields for the filter criterion: MSG_FILTER_PVALUE

dwPValue

Active process values (from - to, bit-coded)

Assign this field for the filter criterion: MSG_FILTER_PVALUE

dwMsgCounter

Internal message counter from - to

Assign these fields for the filter criteria: MSG_FILTER_COUNTER_FROM,

MSG_FILTER_COUNTER_TO

dwQuickSelect

Quick selection for hour, day, month

The parameter is reserved for future upgrades and must be preset to 0.

Assign this field for the filter criterion: MSG_FILTER_QUICKSELECT

LOWORD type:

MSG_FILTER_QUICK_MONTH Quick selection last n months

MSG_FILTER_QUICK_DAYS Quick selection last n days

MSG_FILTER_QUICK_HOUR Quick selection last n hours

HIWORD number: 1...n

The end time of the quick selection refers to the current system time of the local computer.

The start time is calucalted back n * ( months, days, hours ).

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1555

3.4.3.10 Structure definition MSG_RTDATA_STRUCT

typedef struct {

DWORD dwMsgState;

DWORD dwMsgNr;

SYSTEMTIME stMsgTime;

DWORD dwTimeDiff;

DWORD dwCounter;

DWORD dwFlags;

WORD wPValueUsed;

WORD wTextValueUsed;

double dPValue[MSG_MAX_PVALUE];

MSG_TEXTVAL_STRUCT mtTextValue[MSG_MAX_PVALUE];

}

MSG_RTDATA_STRUCT;

Members

dwMsgState

Message status

MSG_STATE_COME 0x00000001 Message came in

MSG_STATE_GO 0x00000002 Message went out

MSG_STATE_QUIT 0x00000003 Message acknowledged

MSG_STATE_LOCK 0x00000004 Message locked

MSG_STATE_UNLOCK 0x00000005 Message unlocked

MSG_STATE_QUIT_SYSTEM 0x00000010 Message acknowledged by system

MSG_STATE_QUIT_EMERGENCY 0x00000011 Emergency acknowledgement

MSG_STATE_QUIT_HORN 0x00000012 Horn acknowledgement

MSG_STATE_COMEGO 0x00000013 Message came in and went out, only display in message list

MSG_STATE_UPDATE 0x00010000 Bit for message update

MSG_STATE_RESET 0x00020000 Bit for message reset

MSG_STATE_SUMTIME 0x00040000 Bit active for daylight savings time

MSG_STATE_INSTANCE 0x00080000 Bit for instance message (n messages of a no.)

dwMsgNr

Message number

stMsgTime

Date/Time: Telegram time depending on the calling function

dwTimeDiff

Duration coming/Telegram time in seconds

dwCounter

Internal message counter

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

1556

System Manual, 11/2008,

dwFlags

Message flags in the database

MSG_FLAG_SUMTIME 0x00000001 Daylight savings time active

MSG_FLAG_COMMENT 0x00000002 Message has comments

MSG_FLAG_ARCHIV 0x00000004 Archiving

MSG_FLAG_PROTOCOL 0x00000008 Logging

MSG_FLAG_TEXTVALUES 0x00000010 Message has values accompanying the text

MSG_FLAG_TIMEINVALID 0x00000020 Bit for invalid date/time stamp

MSG_FLAG_INSTANCE 0x00000040 Instance message identification (185269)

wPValueUsed

Process values used, bit-coded. Every bit may only be set in one of the two structure elements

"wPValueUsed" or "wTextValueUsed". An accompanying value may either be a number or a

text.

wTextValueUsed

text values used, bit-coded. Every bit may only be set in one of the two structure elements

"wPValueUsed" or "wTextValueUsed". An accompanying value may either be a number or a

text.

ANSI-C function descriptions

3.4 Appendix

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1557

VBA for Automated Configuration

4 Resources

4.1 Automated Configuring

Contents

You can use VBA to automate configuration in Graphics Designer. This comprises:

● Adaptation of the Graphics Designer

● Editing of pictures

● Editing of objects

● Dynamizing with VBA

● Access to external applications

A VBA editor is available for this purpose in the "Graphics Designer" editor.

This chapter contains

● a brief introduction on how to use VBA in WinCC,

● basic information on using VBA in Graphics Designer and

● reference to the VBA object model in Graphics Designer.

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1559

4.2 Introduction: Using VBA in WinCC

4.2.1 Introduction: Using VBA in WinCC

Introduction

You have a VBA editor available in Graphics Designer which allows you to configure pictures

automatically. The VBA editor is identical to the one from the products in the Microsoft Office

family. You can make direct use of your VBA programming experience.

Principle

With VBA you extend the functionality of the Graphics Designer and automate configuring.

You may use VBA in Graphics Designer as follows, including:

● Creating user-defined menus and toolbars

● Creating and editing Standard, Smart and Windows objects

● Adding dynamics to properties of pictures and objects

● Configuring actions in pictures and objects

● Accessing products that support VBA (e.g. products in the MS Office family)

VBA for Automated Configuration

4.2 Introduction: Using VBA in WinCC

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

1560

System Manual, 11/2008,