System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
See also
Layer Object (Page 127)
Activate Method (Page 639)
Properties (Page 276)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
ToolTipText Property (Page 574)
RotationAngle Property (Page 493)
ReferenceRotationTop Property (Page 490)
ReferenceRotationLeft Property (Page 490)
PointCount Property (Page 482)
PasswordLevel Property (Page 472)
Parent Property (Page 471)
ObjectName Property (Page 455)
Left Property (Page 423)
Index Property (Page 400)
Height Property (Page 391)
FlashRateBorderColor Property (Page 376)
FlashBorderColor Property (Page 373)
Enabled Property (Page 360)
BorderWidth Property (Page 315)
BorderStyle Property (Page 314)
BorderFlashColorOn Property (Page 314)
BorderFlashColorOff Property (Page 314)
BorderEndStyle Property (Page 314)
BorderColor Property (Page 313)
BorderBackColor Property (Page 312)
ActualPointTop Property (Page 280)
ActualPointLeft Property (Page 280)
Layer Property (Page 408)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
171
Rectangle
Description
Object Type of ScreenItem Object. Represents the graphic object "Rectangle"
Type Identifier in VBS
HMIRectangle
Usage
In the following example, the object with the name "Rectangle1" is moved 10 pixels to the right:
'VBS26
Dim objRectangle
Set objRectangle = ScreenItems("Rectangle1")
objRectangle.Left = objRectangle.Left + 10
Notes on Error Handling
The rectangle and rounded rectangle are mapped to an "HMIRectangle" type in the object
model.
Since the two objects have different properties, the availability of the property (dynamic
type compilation in Runtime) should be queried via an exception measure. The exception
measure is activated for the corresponding procedure by the following instruction:
On Error Resume Next
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
172
System Manual, 11/2008,
The instruction causes the VBScript engine to initiate the follow-on command in the case of a
Runtime error.
The error code can subsequently be checked using the Err object. In order to deactivate the
handling of Runtime errors in scripts, use the following command:
On Error Goto 0
Handling errors always relates to the procedure layer. If a script in a procedure causes an
error,
VBScript checks whether an error handling measure is implemented in this layer. If not,
control is transferred one layer up (to the calling procedure). If there is no error handling
measure here either, the control is transferred yet another layer up. This continues until either
the top module level is reached or the code for Runtime error handling is located. If the
activation of the Runtime error handling fails, the control is transferred to the top level on the
internal VBScript Runtime error handing. This opens an error dialog and stops the script.
The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures).
When the error handling measure is use, it can basically be determined whether the user is
actually using the required implementation type.
In addition, it can be ensured that there is no termination of execution due to a faulty access
to the object.
Examples of error handling
Sub OnClick(ByVal Item)
'VBS27
Dim objScreenItem
'
'Activation of errorhandling:
On Error Resume Next
For Each objScreenItem In ScreenItems
If "HMIRectangle" = objScreenItem.Type Then
'
'=== Property "RoundCornerHeight" only available for RoundRectangle
objScreenItem.RoundCornerHeight = objScreenItem.RoundCornerHeight * 2
If 0 <> Err.Number Then
HMIRuntime.Trace objScreenItem.Name & ": no RoundedRectangle" & vbCrLf
'
'Delete error message
Err.Clear
End If
End If
Next
On Error Goto 0 'Deactivation of errorhandling
End Sub
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
173
See also
Properties (Page 276)
BorderFlashColorOn Property (Page 314)
Activate Method (Page 639)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
ToolTipText Property (Page 574)
PasswordLevel Property (Page 472)
Parent Property (Page 471)
ObjectName Property (Page 455)
Left Property (Page 423)
Layer Object (Page 127)
Height Property (Page 391)
FlashRateBorderColor Property (Page 376)
FlashRateBackColor Property (Page 376)
FlashBorderColor Property (Page 373)
FlashBackColor Property (Page 373)
FillStyle Property (Page 369)
FillingIndex Property (Page 369)
Filling Property (Page 368)
FillColor Property (Page 368)
Enabled Property (Page 360)
BorderWidth Property (Page 315)
BorderStyle Property (Page 314)
BorderFlashColorOff Property (Page 314)
BorderColor Property (Page 313)
BorderBackColor Property (Page 312)
BackFlashColorOn Property (Page 297)
BackFlashColorOff Property (Page 297)
BackColor Property (Page 295)
Layer Property (Page 408)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
174
System Manual, 11/2008,
Rounded rectangle
Description
Object Type of ScreenItem Object. Represents the graphic object "Rounded Rectangle".
Type Identifier in VBS
HMIRoundRectangle
Usage
In the following example, the object with the name "RoundedRectangle1" is moved 10 pixels
to the right:
'VBS28
Dim objRoundedRectangle
Set objRoundedRectangle = ScreenItems("RoundedRectangle1")
objRoundedRectangle.Left = objRoundedRectangle.Left + 10
Notes on Error Handling
The rectangle and rounded rectangle are mapped to an "HMIRectangle" type in the object
model.
Since the two objects have different properties, the availability of the property (dynamic
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
175
type compilation in Runtime) should be queried via an exception measure. The exception
measure is activated for the corresponding procedure by the following instruction:
On Error Resume Next
The instruction causes the VBScript engine to initiate the follow-on command in the case of a
Runtime error.
The error code can subsequently be checked using the Err object. In order to deactivate the
handling of Runtime errors in scripts, use the following command:
On Error Goto 0
Handling errors always relates to the procedure layer. If a script in a procedure causes an
error,
VBScript checks whether an error handling measure is implemented in this layer. If not,
control is transferred one layer up (to the calling procedure). If there is no error handling
measure here either, the control is transferred yet another layer up. This continues until either
the top module level is reached or the code for Runtime error handling is located. If the
activation of the Runtime error handling fails, the control is transferred to the top level on the
internal VBScript Runtime error handing. This opens an error dialog and stops the script.
The "On Error Resume Next" command can be installed on all layers (i.e. also in procedures).
When the error handling measure is use, it can basically be determined whether the user is
actually using the required implementation type.
In addition, it can be ensured that there is no termination of execution due to a faulty access
to the object.
Examples of error handling
Sub OnClick(ByVal Item)
'VBS29
Dim objScreenItem
On Error Resume Next 'Activation of errorhandling
For Each objScreenItem In ScreenItems
If "HMIRectangle" = objScreenItem.Type Then
'
'=== Property "RoundCornerHeight" available only for RoundRectangle
objScreenItem.RoundCornerHeight = objScreenItem.RoundCornerHeight * 2
If 0 <> Err.Number Then
HMIRuntime.Trace objScreenItem.ObjectName & ": no RoundedRectangle" & vbCrLf
Err.Clear 'Delete errormessage
End If
End If
Next
On Error Goto 0 'Deactivation of errorhandling
End Sub
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
176
System Manual, 11/2008,
See also
FlashBackColor Property (Page 373)
Activate Method (Page 639)
Properties (Page 276)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
ToolTipText Property (Page 574)
RoundCornerWidth Property (Page 494)
RoundCornerHeight Property (Page 493)
PasswordLevel Property (Page 472)
Parent Property (Page 471)
ObjectName Property (Page 455)
Left Property (Page 423)
Layer Object (Page 127)
Height Property (Page 391)
FlashRateBorderColor Property (Page 376)
FlashRateBackColor Property (Page 376)
FlashBorderColor Property (Page 373)
FillStyle Property (Page 369)
FillingIndex Property (Page 369)
Filling Property (Page 368)
FillColor Property (Page 368)
Enabled Property (Page 360)
BorderWidth Property (Page 315)
BorderStyle Property (Page 314)
BorderFlashColorOn Property (Page 314)
BorderFlashColorOff Property (Page 314)
BorderColor Property (Page 313)
BorderBackColor Property (Page 312)
BackFlashColorOn Property (Page 297)
BackFlashColorOff Property (Page 297)
BackColor Property (Page 295)
Layer Property (Page 408)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
177
Static text
Description
Object Type of ScreenItem Object. Represents the graphic object "Static Text"
Type Identifier in VBS
HMITextField
Usage
In the following example, the object with the name "StaticText1" is moved 10 pixels to the right:
'VBS30
Dim objStaticText
Set objStaticText = ScreenItems("StaticText1")
objStaticText.Left = objStaticText.Left + 10
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
178
System Manual, 11/2008,
See also
ObjectName Property (Page 455)
BorderFlashColorOn Property (Page 314)
Activate Method (Page 639)
Properties (Page 276)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
ToolTipText Property (Page 574)
Text list (Page 210)
PasswordLevel Property (Page 472)
Parent Property (Page 471)
Orientation Property (Page 468)
Left Property (Page 423)
Layer Object (Page 127)
Height Property (Page 391)
ForeFlashColorOn Property (Page 384)
ForeFlashColorOff Property (Page 383)
ForeColor Property (Page 383)
FontUnderline Property (Page 382)
FontSize Property (Page 382)
FontName Property (Page 381)
FontItalic Property (Page 380)
FontBold Property (Page 380)
FlashRateForeColor Property (Page 377)
FlashRateBorderColor Property (Page 376)
FlashRateBackColor Property (Page 376)
FlashForeColor Property (Page 374)
FlashBorderColor Property (Page 373)
FlashBackColor Property (Page 373)
FillStyle Property (Page 369)
FillingIndex Property (Page 369)
Filling Property (Page 368)
FillColor Property (Page 368)
Enabled Property (Page 360)
BorderWidth Property (Page 315)
BorderStyle Property (Page 314)
BorderFlashColorOff Property (Page 314)
BorderColor Property (Page 313)
BorderBackColor Property (Page 312)
BackFlashColorOn Property (Page 297)
BackFlashColorOff Property (Page 297)
BackColor Property (Page 295)
AlignmentTop Property (Page 284)
AlignmentLeft Property (Page 283)
AdaptBorder Property (Page 280)
Layer Property (Page 408)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
179
Connector
Description
Object Type of ScreenItem Object. Represents the graphic object "Connector"
Type Identifier in VBS
HMIConnector
Usage
In the following example, the object with the name "Connector1" is moved 10 pixels to the right:
'VBS31
Dim objConnector
Set objConnector = ScreenItems("Connector1")
objConnector.Left = objConnector.Left + 10
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
180
System Manual, 11/2008,