System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
WinCC Online Trend Control (before WinCC V7)
Description
Object Type of ScreenItem Object. Represents the graphic object "WinCC Online Trend
Control"
Type Identifier in VBS
HMITrendView
Usage
In the following example, the object with the name "Control1" is moved 16 pixels to the right:
'VBS60
Dim objControl
Set objControl = ScreenItems("Control1")
objControl.Left = objControl.Left +16
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
271
See also
Properties (Page 276)
TimeAxis Property (Page 537)
LowerLimitColor Property (Page 434)
Caption Property (Page 320)
Activate Method (Page 639)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Controls (Page 230)
Width Property (Page 626)
Visible Property (Page 624)
UpperLimitValue Property (Page 604)
UpperLimit Property (Page 603)
UpperLimitColor Property (Page 604)
Type Property (Page 596)
Top Property (Page 575)
ToolbarHotKeys Property (Page 572)
Toolbar Property (Page 562)
ToolbarButtons Property (Page 571)
ToolbarAlignment Property (Page 563)
Titleline Property (Page 560)
TimeZone Property (Page 558)
TimeRangeFactor Property (Page 556)
TimeRange Property (Page 555)
TimeRangeBase Property (Page 556)
TimeOverlap Property (Page 554)
TimeOverlapColor Property (Page 555)
TimeJump Property (Page 553)
TimeJumpColor Property (Page 554)
TimeAxisFormat Property (Page 539)
TagName Property (Page 531)
Statusbar Property (Page 524)
ShowRulerImmediately Property (Page 512)
ServerData Property (Page 509)
RulerPrecisions Property (Page 496)
Replacement Property (Page 491)
ReplacementColor Property (Page 491)
RelayCurves Property (Page 490)
ProviderClsid Property (Page 486)
PrintJob Property (Page 484)
Precisions Property (Page 483)
PersistentRTPermission Property (Page 475)
PersistentRT Property (Page 474)
PersistentRTCSPermission Property (Page 475)
PersistentRTCS Property (Page 474)
Parent Property (Page 471)
Online Property (Page 459)
ObjectName Property (Page 455)
Object Property (Page 455)
NumItems Property (Page 454)
MeasurePoints Property (Page 441)
LowerLimitValue Property (Page 434)
LowerLimit Property (Page 433)
LoadDataImmediately Property (Page 429)
Left Property (Page 423)
Layer Object (Page 127)
Label Property (Page 405)
ItemVisible Property (Page 404)
Index Property (Page 400)
Height Property (Page 391)
GridLineValue Property (Page 390)
GridLines Property (Page 388)
GraphDirection Property (Page 387)
Font Property (Page 379)
FineGridValue Property (Page 371)
FineGrid Property (Page 371)
EndValue Property (Page 362)
EndTime Property (Page 362)
Enabled Property (Page 360)
CurveForm Property (Page 349)
CommonY Property (Page 345)
CommonX Property (Page 345)
Command Property (Page 344)
Color Property (Page 331)
CoarseGridValue Property (Page 329)
CoarseGrid Property (Page 328)
Closeable Property (Page 327)
BeginValue Property (Page 304)
BeginTime Property (Page 304)
BackColor Property (Page 295)
Autorange Property (Page 291)
AllowPersistence Property (Page 285)
Actualize Property (Page 279)
Activate Property (Page 277)
AdjustRuler Property (Page 282)
LineWidth Property (Page 428)
ScalingType Property (Page 499)
UseRangeSubstitutes Property (Page 606)
XAxisColor Property (Page 635)
HideTagNames Property (Page 392)
LocaleSpecificSettings Property (Page 430)
PrintBackgroundColor Property (Page 484)
ItemProviderClsid Property (Page 404)
OneY Property (Page 459)
AllowXAxisColor - Property (Page 285)
AnchorRuler Property (Page 286)
SavedTrend Property (Page 498)
SelectedTrend Property (Page 505)
ShowSpanNames Property (Page 514)
DefaultPrecision Property (Page 353)
DefaultRulerPrecision Property (Page 353)
LowerLimitTagName Property (Page 434)
UpperLimitTagName Property (Page 604)
UseOnlineTags Property (Page 606)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
272
System Manual, 11/2008,
1.14.3.7 Customized object
Description
Object Type of ScreenItem Object. Represents the graphic object "Customized Object"
Type Identifier in VBS
HMIScreenModule
Application
Customized properties in a customized object must be accessed in VBS via the attribute name.
Intellisense is only applicable to the customized object as a whole.
The attribute name is to be found under Properties of the properties placed outside (right-click
Property) and can be modified there.
In the following example, the object with the name "CustomizedObject1" is moved 10 pixels
to the right:
'VBS65
Dim objCustomObject
Set objCustomObject = ScreenItems("CustomizedObject1")
objCustomObject.Left = objCustomObject.Left + 10
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
273
See also
Activate Method (Page 639)
Properties (Page 276)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Object Types of the ScreenItem Object (Page 152)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
ToolTipText Property (Page 574)
Parent Property (Page 471)
ObjectName Property (Page 455)
Left Property (Page 423)
Layer Object (Page 127)
Height Property (Page 391)
Enabled Property (Page 360)
1.14.3.8 Group
Description
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
274
System Manual, 11/2008,
Object Type of ScreenItem Object. Represents the graphic object "Group"
Type Identifier in VBS
HMIGroup
Usage
In the following example, the object with the name "Group1" is moved 10 pixels to the right:
'VBS66
Dim objGroup
Set objGroup = ScreenItems("Group1")
objGroup.Left = objGroup.Left + 10
See also
Properties (Page 276)
Activate Method (Page 639)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Object Types of the ScreenItem Object (Page 152)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
ToolTipText Property (Page 574)
Parent Property (Page 471)
ObjectName Property (Page 455)
Left Property (Page 423)
Layer Object (Page 127)
Height Property (Page 391)
Enabled Property (Page 360)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
275
1.14.4 Properties
1.14.4.1 Properties
Overview
The properties of the individual objects can be used to modify specific graphic objects and
tags in Runtime , e.g. activating an operating element per mouse click or triggering a color
change by modifying a tag value.
Properties on graphic objects can be addressed via the following syntax:
'VBS191
Dim obj
Set obj = ScreenItems("object1")
obj.property = Value
In the following example, the object with the name "Control1" is moved 10 pixels to the right:
'VBS192
Dim obj
Set obj = ScreenItems("control1")
obj.Left = obj.Left + 10
1.14.4.2 A
Aa - Ad
AccessPath Property
Description
Displays the storage path (with hierarchy information) of a screen object (picture). The property
corresponds to the full access code on the Screens Collections.
STRING (read only)
Example:
In the following example, the path of the picture "ScreenWindow1" is issued:
'VBS67
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
276
System Manual, 11/2008,
Dim objScreen
Set objScreen = HMIRuntime.Screens("ScreenWindow1")
MsgBox objScreen.AccessPath
See also
ScreenItem Object (Page 134)
Screens Object (List) (Page 143)
Activate Property
Description
The data to be displayed is only requested from the archive server when this attribute is set.
In
order to reduce the picture opening times, this attribute should not be set and the value only
dynamically changed when necessary.
Write/Read access
To differentiate between the "Activate" property form the "Activate" method, the property is
accessed via "Object".
Example:
Dim ctrl
Set ctrl = ScreenItems("Control")
ctrl.Object.activate = true
See also
WinCC Online Trend Control (before WinCC V7) (Page 271)
WinCC Online Table Control (before WinCC V7) (Page 269)
WinCC Alarm Control (before WinCC V7) (Page 265)
ScreenItem Object (Page 134)
Activate property
Activate
The data to be displayed in the message window are only requested from the message server
if you set this attribute. Instead of setting this attribute, it is advisable to change the value
dynamically in order to reduce picture activation times.
The attribute can be assigned dynamic properties by means of the name Activate .
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
277
ActiveProject Property
Description
Returns an object of type "Project".
See also
Path Property (Page 473)
Name Property (Page 452)
Ellipse segment (Page 158)
HMIRuntime Object (Page 125)
ActiveScreen Property
Description
Supplies a reference to the picture which contains the object with the current focus.
Usage
"ActiveScreen"
is used in Runtime to address the properties of the picture which contains the
currently focussed object.
Example:
The following example assigns the name of the current picture to the tag "strScrName" and
outputs it in a message:
'VBS68
Dim strScrName
strScrName = HMIRuntime.ActiveScreen.Objectname
MsgBox strScrName
See also
Screen Object (Page 140)
HMIRuntime Object (Page 125)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
278
System Manual, 11/2008,
ActiveScreenItem Property
Description
Supplies a reference to the object currently in focus.
Usage
"ActiveScreenItem"
is used in Runtime in order to address the properties of the object currently
in focus.
Example:
The following example displays the name of the object in the "ScreenWindow1" picture which
has the focus:
'VBS69
Dim objScreen
Set objScreen = HMIRuntime.Screens("ScreenWindow1")
MsgBox objScreen.ActiveScreenItem.ObjectName
See also
ScreenItem Object (Page 134)
HMIRuntime Object (Page 125)
Actualize Property
Description
The "Index" property references a column pair or a trend. "Actualize" defines whether a static
or dynamic representation should be used for this column pair/trend.
● 0: Static display
● -1: Dynamic display
See also
WinCC Online Table Control (before WinCC V7) (Page 269)
WinCC Online Trend Control (before WinCC V7) (Page 271)
ScreenItem Object (Page 134)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
279
ActualPointLeft Property
Description
Defines or returns the x-coordinate of the current corner point in relation to the original picture
(top left). Each corner point is identified by an index which is derived from the number
("PointCount") of corner point available.
A change of the value can affect the properties "Width" (object width) and "Left" (x-coordinate
of the object position).
See also
Polyline (Page 170)
Polygon (Page 168)
ScreenItem Object (Page 134)
ActualPointTop Property
Description
Defines or returns the y-coordinate of the current corner point in relation to the original picture
(top left). Each corner point is identified by an index which is derived from the number
("PointCount") of corner point available.
A change of the value can affect the properties "Height" (object height) and "Top" (y-coordinate
of the position).
See also
Polyline (Page 170)
Polygon (Page 168)
ScreenItem Object (Page 134)
AdaptBorder Property
Description
TRUE, when the border should be dynamically adjusted to the size of the text. BOOLEAN write-
read access.
For text list and I/O field: Read only access.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
280
System Manual, 11/2008,