System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
1.14.2.6 DataLogs Object
Description
Using the object, swapped archive segments of Tag Logging may be reconnected to Runtime,
or previously swapped archive segments of Tag Logging may be deleted again. Therein
● Archive segments to be swapped are copied to the common archiving directory of the
WinCC project, or
● previously swapped archive segments are deleted in the common archiving directory.
Using parameters you may control from where archive segments are to be swapped. You may
also specify the time period over which archive segments are to be swapped or deleted. In
addition,
you may set the archive type ("Tag Logging Fast", "Tag Logging Slow", "Tag Logging
Fast and Tag Logging Slow"). Archive segments are copied to the common archiving directory
of the project.
If an error occurred during the operation with archiving segments, the method used returns an
error message. Additional information may be found under the subject heading "Error
Messages from Database Area".
Usage
Previously swapped archive segments of Tag Logging may be connected with Runtime
("Restore" method).
Previously swapped archive segments of Tag Logging may be deleted from the Runtime
project ("Remove" method).
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
121
Example:
In the following example, fast archive segments from Tag Logging are swapped and the return
value is output as Trace.
'VBS188
HMIRuntime.Trace "Ret: " & HMIRuntime.Logging.DataLogs.Restore("D:
\Folder","2004-09-14","2004-09-20",-1,1) & vbNewLine
See also
Error Messages from Database Area (Page 732)
Restore Method (Page 708)
Remove Method (Page 703)
AlarmLogs Object (Page 118)
Logging Object (Page 130)
1.14.2.7 DataSet-Objekt (List)
Description
Using the DataSet object, data may be exchanged across several actions.
A DataSet object is global and defined by the Screen object. Any VBS action may access the
data.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
122
System Manual, 11/2008,
The DataSet object at the Screen object must be addressed according to picture hierarchy
and
shall persist as long as the picture is displayed. The global object persists over the entire
Runtime time period.
Access uses the DataItem object.
Note
Objects of type Screen, Screens, ScreenItem, ScreenItems, Tag and TagSet cannot be
included in the DataSet list.
The DataSet object does not support any classes.
Usage
Using the "DataSet" list, you may:
● Output or process (enumerate) all objects in the list.
● Output the number of elements contained ("Count" property).
● To process a specific object in the list ("Item" method).
● Add an object to the list ("Add" method).
● Remove a specific object from the list ("Remove" method).
● Remove all objects from the list ("RemoveAll" method).
Access to list elements uses:
HMIRuntime.DataSet("Itemname")
For a picture-specific list, access uses:
HMIRuntime.Screens("Screenname").DataSet("Itemname")
In a picture, you may access the DataSet object of the picture by using:
DataSet("Itemname")
If upon access the stated name does not exist in the list, VT_Empty is returned and an
Exception is triggered.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
123
Example:
The example shows how to add a value to the list, how to read it and remove it. It make sense
to perform this in several different actions.
'VBS162
HMIRuntime.DataSet.Add "motor1", 23
HMIRuntime.Trace "motor1: " & HMIRuntime.DataSet("motor1").Value & vbNewLine
HMIRuntime.DataSet.Remove("motor1")
See also
DataItem Object (Page 119)
RemoveAll Method (Page 707)
Remove Method (Page 703)
Item Method (Page 687)
Count Property (Page 346)
Add Method (Page 641)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
124
System Manual, 11/2008,
1.14.2.8 HMIRuntime Object
Description
The HMIRuntime object represents the graphic Runtime environment.
Usage
The "HMIRuntime" object can be used for the following, for example:
● Read or set the current Runtime language ("Language" property).
● Read or set the name of the current base picture ("BaseScreenName" property).
● Read the path of the active Runtime project ("ActiveProject" property).
● Access tags ("Tags" property).
● Access tags of a list ("DataSet" property).
● Exit Runtime ("Stop" method).
● Display messages in a diagnostics window ("Trace" method).
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
125
Example:
The following command terminates WinCC Runtime:
'VBS3
HMIRuntime.Stop
See also
Screens Object (List) (Page 143)
TagSet Object (List) (Page 151)
Tags Object (List) (Page 149)
Logging Object (Page 130)
DataSet-Objekt (List) (Page 122)
Visible Property (Page 624)
Trace Method (Page 724)
Tags Property (Page 531)
Stop Method (Page 723)
AlignmentLeft Property (Page 283)
Logging Property (Page 431)
Language Property (Page 406)
DataSet Property (Page 351)
CurrentContext Property (Page 347)
BaseScreenName Property (Page 302)
ActiveProject Property (Page 278)
ActiveScreen Property (Page 278)
MenuToolBarConfig Property (Page 442)
Alarms object (list) (Page 116)
1.14.2.9 Item Object
Description
The "Item" object provides a reference to the current object.
Usage
The "Item" object is used, for example, to address the properties of the object currently selected
in Graphics Designer.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
126
System Manual, 11/2008,
Example:
In the following example, a rectangle has been created. When the object has been selected,
all the properties of the current object can be set a background color red:
'VBS195
Item.BackColor = RGB(255,0,0)
See also
Objects and Lists (Page 113)
1.14.2.10 Layer Object
Description
The layer object returns the result of access to the layers list.
Parent Object
Picture, in which the picture layer is.
Usage
Depending on certain events, the Layer object can be used to obtain access to the properties
of a complete layer in order, for example, to hide or unhide a layer with operating elements
according to the operator authorization.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
127
The "Layer" object can be used to:
● To activate or deactivate the visualization of a layer ("Visible" property).
● To read out the name of a layer ("Name" property).
Note
The layer property specifies the layer in which the object is located. The layer "0" is output
as "Layer0".
When accessed, the layers are counted up from 1 in VBS. Therefore, the layer "1" must
be addressed with "layers(2)".
Example:
In the following example, Layer 1 is set invisible:
'VBS4
Layers(2).Visible = vbFalse
See also
Layer Object (Page 127)
Visible Property (Page 624)
Parent Property (Page 471)
Name Property (Page 452)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
128
System Manual, 11/2008,
1.14.2.11 Layers Object (Listing)
Description
The Layers list enables access to all 32 layers of the graphical Runtime system.
Parent Object
Picture, in which the picture layer is.
Usage
The "Layers" list can be used to:
● Process all layers in the list ("_NewEnum" property).
● Count all layers contained in the list ("Count" property).
● Process a layer from the list ("Item" method).
The properties represent default properties and methods of a list and are not described in detail
in the WinCC documentation.
See also
Parent Property (Page 471)
Item Method (Page 687)
Count Property (Page 346)
Layer Object (Page 127)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
129
1.14.2.12 Logging Object
Description
Using the object, swapped archive segments may be reconnected to Runtime, or previously
swapped archive segments may be deleted again. Therein
● Archive segments to be swapped are copied to the common archiving directory of the
WinCC project, or
● previously swapped archive segments are deleted in the common archiving directory.
Using parameters you may control from where archive segments are to be swapped. You may
also
specify the time period over which archive segments are to be swapped or deleted. Archive
segments are copied to the common archiving directory of the project.
If an error occurred during the operation with archiving segments, the method used returns an
error message. Additional information may be found under the subject heading "Error
Messages from Database Area".
Usage
Previously swapped archive segments of Alarm Logging and Tag Logging may be connected
with Runtime ("Restore" method).
Previously swapped archive segments of Alarm Logging and Tag Logging may be deleted
from the Runtime project ("Remove" method).
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
130
System Manual, 11/2008,