System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
MoveToLastLine method
Function
Executes the "Last message" key function of the AlarmControl.
Syntax
Ausdruck.MoveToLastLine()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
MoveToLastPage method
Function
Executes the "Last page" key function of the AlarmControl.
Syntax
Ausdruck.MoveToLastPage()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
MoveToNext method
Function
Executes the "Next data record" key function of the control.
Syntax
Ausdruck.MoveToNext()
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
691
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
MoveToNextLine method
Function
Executes the "Next message" key function of the AlarmControl.
Syntax
Ausdruck.MoveToNextLine()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
MoveToNextPage method
Function
Executes the "Next page" key function of the AlarmControl.
Syntax
Ausdruck.MoveToNextPage()
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)
692
System Manual, 11/2008,
MoveToPrevious method
Function
Executes the "Previous data record" key function of the control.
Syntax
Ausdruck.MoveToPrevious()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
MoveToPreviousLine method
Function
Executes the "Previous message" key function of the AlarmControl.
Syntax
Ausdruck.MoveToPreviousLine()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
MoveToPreviousPage method
Function
Executes the "Previous page" key function of the AlarmControl.
syntax
Ausdruck.MoveToPreviousPage()
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
693
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
1.14.5.5 Methods N to R
NextColumn method
Function
Executes the "Next column" key function of the OnlineTableControl.
Syntax
Ausdruck.NextColumn()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
NextTrend method
Function
Executes the "Next curve" key function of the OnlineTrendControl and FunctionTrendControl.
Syntax
Ausdruck.NextTrend()
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)
694
System Manual, 11/2008,
OneToOneView method
Function
Executes the "Original view" key function of the OnlineTrendControl and FunctionTrendControl.
Syntax
Ausdruck.OneToOneView()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
VARIANT
PasteRows method
Function
Executes the "Paste Rows" key function of the UserArchiveControl.
Syntax
Expression.PasteRows()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
PreviousColumn method
Function
Executes the "Previous column" key function of the OnlineTableControl.
Syntax
Ausdruck.PreviousColumn()
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
695
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
PreviousTrend method
Function
Executes the "Previous curve" key function of the OnlineTrendControl and
FunctionTrendControl.
Syntax
Ausdruck.PreviousTrend()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Print method
Function
Executes the "Print" key function of the control.
Syntax
Ausdruck.Print()
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)
696
System Manual, 11/2008,
QuitHorn method
Function
Executes the "Acknowledge central signaling devices" key function of the AlarmControl.
Syntax
Ausdruck.QuitHorn()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
QuitSelected method
Function
Executes the "Single acknowledgment" key function of the AlarmControl.
Syntax
Ausdruck.QuitSelected()
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
QuitVisible method
Function
Executes the "Group acknowledgment" key function of the AlarmControl.
Syntax
Ausdruck.QuitVisible()
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
697
Expression
Necessary. An expression that returns an object of the "ScreenItem" type.
Parameters
- -
Read Method
Description of Tag Object
Reads out the status of a tag (tag object) shortly after the moment it was called. At the same
time,
the tag object is provided with the values read. Upon reading a tag, its value, quality code
and time stamp are determined. The "LastError" property can be used to determine whether
the call was successful.
The "Name", "ServerPrefix" and "TagPrefix" properties are not changed as a result.
If the value of the tag is read successfully, the properties of the tag object are assigned the
following values:
Property Assignment
Value Tag values
Name Tag name (unchanged)
QualityCode Quality level
Timestamp Current tag time stamp
LastError 0
ErrorDescription " "
If the value of the tag is not read successfully, the properties of the tag object are assigned
the following values:
Property Allocation
Value VT_Empty
Name Tag name (unchanged)
QualityCode Bad Out of Service
Timestamp 0
LastError Read operation error codes
ErrorDescription Error description on LastError
Note
A summary of possible Quality Codes may be found in WinCC Information System under key
word "Communication" > "Diagnostics" or "Communication" > "Quality Codes".
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
698
System Manual, 11/2008,
syntax
Expression.Read([Readmode])
Expression
Necessary. An expression which returns a tag object. The return value of the Read method is
the value of the tag read out.
Parameters
The optional "Readmode" parameter enables the distinction between two types of reading:
Parameters Description
0 The tag value is read from the process image
(cache). 0 is the default value.
1 The value of a tag is read directly from AS or
channel (direct).
If the "Readmode" parameter is omitted, the value is read from the process image by default.
The return value of the Read method is the tag value read out as VARIANT.
Reading From the Process Image
When reading from the process image, the tag is logged on and, from that moment, polled
cyclically from the PLC. The login cycle is dependent on the configured trigger. The value is
read from the tag image by WinCC. For Close Picture, the tag actions are ended again. The
call is characterized by the following:
● The value is read by WinCC from the tag image.
● The call is faster in comparison to direct reading (except with the first call: The first call
basically takes longer because the value from the PLC must be read out and logged on.)
● The duration of the call is not dependent on the bus load or AS.
Behavior in actions with a tag trigger
All of the tags contained in the tag trigger are already known with Open Picture and are
registered with the defined monitoring time. Since all tags are requested at once, the best
possible optimization can be targeted from the channel. If a tag, contained in the trigger, is
requested with Read during an action, the value already exists and is transferred directly to
the
call. If a tag is requested which is not contained in the trigger, the behavior is the same as
with a standard trigger.
Behavior in actions with a cyclic trigger
tags are registered with half of the cycle time with the first call. For every other call, the value
is present.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
699
Behavior in event-driven actions
The tag is registered in the "upon change" mode with the first call. Process tags that are
registered in the "upon change" mode correspond with a cyclic read job with a cycle time of
1s.
If an event (e.g. mouse click) requests a value asynchronously, the tag is transferred to the
tag image. The tag is requested cyclically from the AS as of this point in time and therefore
increases
the basic load. To bypass this increase in the basic load, the value can also be read
synchronously. The synchronous call causes a one-off increase in the communication load
but the tag is not transferred to the tag image.
Direct reading
In the case of direct reading, the current value is returned. The tag is not registered cyclically,
the value is requested from the AS one time only. Direct reading has the following properties:
● The value is read explicitly from the AS.
● The call takes longer compared to reading from the process image.
● The duration of the call is dependent on the bus load and AS, amongst other things.
Example:
Reading a tag directly from AS or channel
'VBS100
Dim objTag
Dim vntValue
Set objTag = HMIRuntime.Tags("Tagname")
vntValue = objTag.Read(1) 'Read direct
MsgBox vntValue
Reading a tag from the process image
'VBS101
Dim objTag
Dim vntValue
Set objTag = HMIRuntime.Tags("Tagname")
vntValue = objTag.Read 'Read from cache
MsgBox vntValue
Description of TagSet Object
The TagSet object offers the option of reading several tags in one call.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
700
System Manual, 11/2008,