System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Syntax
Ausdruck.ShowSort()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
ShowSortDialog method
Function
Executes the "Sort dialog" key function of the AlarmControl.
Syntax
Ausdruck.ShowSortDialog()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
ShowTagSelection method
Function
Executes the "Select data connection" key function of the control.
Syntax
Ausdruck.ShowTagSelection()
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,
721
Parameters
- -
ShowTimebaseDialog method
Function
Executes the "Time base dialog" key function of the AlarmControl.
Syntax
Ausdruck.ShowTimebaseDialog()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
ShowTimeSelection method
Function
Executes the "Select time range" key function of the control.
Syntax
Ausdruck.ShowTimeSelection()
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)
722
System Manual, 11/2008,
ShowTrendSelection method
Function
Executes the "Select trends" key function of the OnlineTrendControl and
FunctionTrendControl.
Syntax
Ausdruck.ShowTrendSelection()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
-- -
StartStopUpdate method
Function
Executes the "Start" or "Stop" key function of the control.
Syntax
Ausdruck.StartStopUpdate()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Stop Method
Function
Terminates WinCC Runtime.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
723
syntax
HMIRuntime.Stop
Parameters
---
Example:
The following example terminates WinCC Runtime:
'VBS124
HMIRuntime.Stop
See also
HMIRuntime Object (Page 125)
Trace Method
Description
Displays messages in the diagnostics window.
syntax
HMIRuntime.Trace
Parameters
STRING
Example:
The following example writes a text in the diagnostics window:
'VBS103
HMIRuntime.Trace "Customized error message"
See also
HMIRuntime Object (Page 125)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
724
System Manual, 11/2008,
1.14.5.7 Methods U to Z
UnhideAlarm method
Function
Executes the "Unhide alarm" key function of the AlarmControl.
Syntax
Ausdruck.UnhideAlarm()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
UnlockAlarm method
Function
Executes the "Unlock alarm" key function of the AlarmControl.
Syntax
Ausdruck.UnlockAlarm()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Write Method
Description of Tag Object
Writes a value synchronously or asynchronously in a tag. The "LastError" property can be used
to determine whether the call was successful.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
725
If the value of the tag is set successfully, the properties of the tag object are assigned the
following values:
Property Allocation
Value Tag values set by the user (unchanged)
Name Tag name (unchanged)
QualityCode Bad Out of Service
Timestamp 0
LastError 0
ErrorDescription " "
If the value of the tag is not set successfully, the properties of the tag object are assigned the
following values:
Property Allocation
Value Tag values set by the user (unchanged)
Name Tag name (unchanged)
QualityCode Bad Out of Service
Timestamp 0
LastError Write operation error codes
ErrorDescription Error description on LastError
syntax
Expression.Write [Value],[Writemode]
Expression
Necessary. An expression which returns a tag object.
Parameters
The value to be written can be transferred directly to the method as a parameter. If the
parameter is not specified, the value in the "Value" property is used. The "Writemode" option
parameter can be used to select whether the tag value should be written synchronously or
asynchronously.
If the "Writemode" parameter is not used, writing is performed asynchronously
as its default value.
During the writing process, no information is supplied on the status of the tags.
The "Value" property contains the value which was set before or during the writing operation,
therefore is may not correspond to the real current value of the tag. If the data on the tag should
be updated, use the Read method.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
726
System Manual, 11/2008,
Parameters Description
Value (optional) The tag value is specified. The specified value
overwrites
the value in the "Value" property in the
tag object.
The tag value is not specified. The tag receives the
current value from the "Value" property of the tag
object.
Writemode (optional) 0 or empty: The tag value is written
asynchronously. 0 is the default value.
1: The tag value is written synchronously.
On asynchronous writing, it is written immediately into the tag image. The user does not receive
any feedback if the value has been written in the programmable controller, too.
In the case of synchronous writing (direct to the PLC), the writing operation actually occurs
when the PLC is ready to operate. The use receives a check-back message if the writing
operation was not successful.
Example:
Asynchronous writing
'VBS104
Dim objTag
Set objTag = HMIRuntime.Tags("Var1")
objTag.Value = 5
objTag.Write
MsgBox objTag.Value
or
'VBS105
Dim objTag
Set objTag = HMIRuntime.Tags("Var1")
objTag.Write 5
MsgBox objTag.Value
Synchronous writing
'VBS106
Dim objTag
Set objTag = HMIRuntime.Tags("Var1")
objTag.Value = 5
objTag.Write ,1
MsgBox objTag.Value
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
727
or
'VBS107
Dim objTag
Set objTag = HMIRuntime.Tags("Var1")
objTag.Write 5, 1
MsgBox objTag.Value
Description of TagSet Object
The TagSet object offers the option of writing several tags in one call.
Functionality here is mostly identical with that of a tag object. In the following, only deviations
thereof are described.
Expression
Necessary. An expression which returns an object of type "TagSet".
Parameters
In order to write different values, the "Value" property of individual tag objects must be set, and
write
must be called thereafter without the "Value" parameter. Since the write commands are
grouped into one call, it results in improved performance compared to single calls.
In a TagSet object, it is not possible to pass on a value using the "Write" method. Individual
values must be set using the "Value" property of the individual tag objects.
Example:
The following example shows how tags are included in the TagSet list, how tag values are set
and subsequently written.
'VBS173
Dim group
Set group = HMIRuntime.Tags.CreateTagSet
group.Add "Wert1"
group.Add "Wert2"
group("Wert1").Value = 3
group("Wert2").Value = 9
group.Write
If you set the optional parameter "Writemode" equal to 1, the process tags are written
synchronously (directly to AS).
group.Write 1
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
728
System Manual, 11/2008,
See also
LastError Property (Page 407)
ErrorDescription Property (Page 363)
TagSet Object (List) (Page 151)
Tag Object (Page 146)
WriteTags method
Function
Executes the "Write tags" key function of the UserArchiveControl.
Syntax
Expression.WriteTags()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
ZoomArea - Method
Function
Executes the "Zoom area" key function of the OnlineTrendControl and FunctionTrendControl.
Syntax
Ausdruck.ZoomArea()
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,
729
ZoomInOut - Method
Function
Executes the "Zoom +/-" key function of the OnlineTrendControl and FunctionTrendControl.
Syntax
Ausdruck.ZoomInOut()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
ZoomInOutTime method
Function
Executes the "Zoom time axis +/-" key function of the OnlineTrendControl.
Syntax
Ausdruck.ZoomInOutTime()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
ZoomInOutValues - Method
Function
Executes the "Zoom value axis +/-" key function of the OnlineTrendControl.
Syntax
Ausdruck.ZoomInOutValues()
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
730
System Manual, 11/2008,