System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Parameters
Parameters Description
bstrPropertyName Name of property to which trigger relates.
bstrCycleName Name of activation cycle, e.g. "CycleTime1s".
Add Method
Description of TagSet Object
Adds a tag to the list. A tag may be added to the tag object by using name or reference.
syntax
Expression.Add [Tag]
Expression
Necessary. An expression which returns an object of type "TagSet".
Parameters
VARIANT
Parameters Description
Tag Name of a WinCC tag or reference to a tag object
to be added to the list.
Example:
In the following example, a TagSet object is generated and a tag is added.
'VBS170
Dim group
Set group = HMIRuntime.Tags.CreateTagSet
group.Add "Motor1"
Tag objects may also be added as follows.
'VBS171
Dim Tag
Set Tag = HMIRuntime.Tags("Motor2")
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
641
Dim group2
Set group2 = HMIRuntime.Tags.CreateTagSet
group2.Add Tag
Description of DataSet Object
Adds a value or object reference to the list.
Note
The Data Set Object does not support classes.
Objects of type Screen, Screens, ScreenItem, ScreenItems, Tag and TagSet cannot be
included in the DataSet list.
For object references it must be ascertained that objects are multiread-enabled.
syntax
Expression.Add [vtName], [vtUserData]
Expression
Necessary. An expression which returns an object of type "DataSet".
Parameters
VARIANT
Parameters Description
vtName Name by which value or tag are to be added to list.
vtUserData Value to be added to list.
Example:
In this example, a value is included in the DataSet list.
'VBS172
HMIRuntime.DataSet.Add "Motor1",23
See also
TagSet Object (List) (Page 151)
DataSet-Objekt (List) (Page 122)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
642
System Manual, 11/2008,
AttachDB method
Function
Executes the "Connect backup" key function of the control.
Syntax
Ausdruck.AttachDB()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
CalculateStatistic method
Function
Executes the "Calculate statistics" key function of the OnlineTrendControl and
OnlineTableControl.
Syntax
Ausdruck.CalculateStatistic()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
CopyRows method
Function
Executes the "Copy lines" key function of the control.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
643
Syntax
Ausdruck.CopyRows()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Create method
Function
Creates a new Alarm object.
Syntax
Expression.Create (VARIANT vtApplication)
Expression
Necessary. An expression which returns an object of type "Alarm".
Parameters
VARIANT
Parameters Description
vtApplication Name of alarm object (optional)
See also
Alarms object (list) (Page 116)
CreateTagSet Method
Function
Creates a new TagSet object. This object may be used for optimized multi-tag access.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
644
System Manual, 11/2008,
syntax
Expression.CreateTagSet()
Expression
Necessary. An expression which returns an object of type "TagSet".
Parameters
VARIANT
Example:
The following example shows how to create a TagSet object.
'VBS168
'Build a Reference to the TagSet Object
Dim group
Set group = HMIRuntime.Tags.CreateTagSet
See also
TagSet Object (List) (Page 151)
Tags Object (List) (Page 149)
CutRows method
Function
Executes the "Cut lines" key function of the UserArchiveControl.
Syntax
Ausdruck.CutRows()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
645
DeactivateDynamic method
Function
Deactivates the trigger used with the "ActivateDynamic" method for the defined property during
runtime.
Syntax
Ausdruck.DeactivateDynamic(ByVal bstrPropertyName As String)
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
String
Parameters Description
bstrPropertyName Name of property to which trigger relates.
DeleteRows method
Function
Executes the "Delete Rows" key function of the UserArchiveControl.
Syntax
Ausdruck.DeleteRows()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
DetachDB method
Function
Executes the "Disconnect backup" key function of the control.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
646
System Manual, 11/2008,
Syntax
Ausdruck.DetachDB()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Edit method
Function
Executes the "Edit" key function of the OnlineTableControl.
Syntax
Ausdruck.Edit()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Export Method
Function
Executes the "Export archive" or "Export data" key function of the control.
Syntax
Ausdruck.Export()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
647
Parameters
VARIANT
1.14.5.3 Get methods
GetColumn method
Function
Returns the name or index designated column object of the UserArchiveControl as type
"ICCAxUAColumn".
Syntax
Ausdruck.GetColumn(ByVal vIndex As Variant)
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
VARIANT
Parameters Description
vIndex Index or name of column of UserArchiveControl.
Example
Use of the "Getxxx" methods in the controls is illustrated on the basis of an example relating
to a toolbar button function.
'VBS201
Dim ctrl
Set ctrl = ScreenItems.Item("Control1")
Dim toolbu
Set toolbu = ctrl.GetToolbarButton ("ShowHelp")
HMIRuntime.Trace "Name: " & toolbu.Name & vbCrLf
HMIRuntime.Trace "Index: " & toolbu.Index & vbCrLf
HMIRuntime.Trace "Hotkey: " & toolbu.HotKey & vbCrLf
End Sub
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
648
System Manual, 11/2008,
Note
If you use the "Get..." methods to access properties of a control, you must use the latter part
of
the property name. For example, if the index of a toolbar button function is not addressed
via ".ToolbarButtonIndex" but via ".Index".
GetColumnCollection method
Function
Returns the collection of all column objects of the UserArchiveControl as type
"ICCAxCollection".
Syntax
Ausdruck.GetColumnCollection()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Features and functions of the ICCAxCollection
The following properties are available for the ICCAxCollection:
● Count
● Item
The following functions are available for the ICCAxCollection:
● AddItem(vName) As Object
● RemoveItem(vIndex)
Example
Use of the "GetxxxCollection" methods in the controls is illustrated on the basis of an example
relating to the toolbar button functions.
'VBS202
Dim ctrl
Set ctrl = ScreenItems.Item("Control1")
Dim coll
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
649
Set coll = ctrl.GetToolbarButtonCollection
HMIRuntime.Trace "Number of toolbar buttons:" & coll.Count & vbCrLf
Dim toolbu
For Each toolbu In coll
HMIRuntime.Trace toolbu.Name & vbCrLf
Next
End Sub
GetHitlistColumn method
Function
Returns the name or index designated column object of the hitlist of the AlarmControl as type
"ICCAxMessageColumn".
Syntax
Expression.GetHitlistColumn(ByVal vIndex As Variant)
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
VARIANT
Parameters Description
vIndex Index or name of hitlist column
Example
Use of the "Getxxx" methods in the controls is illustrated on the basis of an example relating
to a toolbar button function.
'VBS201
Dim ctrl
Set ctrl = ScreenItems.Item("Control1")
Dim toolbu
Set toolbu = ctrl.GetToolbarButton ("ShowHelp")
HMIRuntime.Trace "Name: " & toolbu.Name & vbCrLf
HMIRuntime.Trace "Index: " & toolbu.Index & vbCrLf
HMIRuntime.Trace "Hotkey: " & toolbu.HotKey & vbCrLf
End Sub
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
650
System Manual, 11/2008,