System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Value Description Description
0 left The X axis selected is displayed on left side of the trend.
1 right The X axis selected is displayed on right side of the trend.
The Y axis attribute can be assigned dynamic properties by means of the name YAxisAlign.
X/YAxisAutoPrecisions property
Decimal places automatic - X/YAxisAutoPrecisions
Enables automatic setting of the decimal precision.
Value Description
TRUE The number of decimal places is set automatically. The value in the "Decimal places"
field is disabled.
FALSE The value in the "Decimal places" field is enabled.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisAutoPrecisions
.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisAutoPrecisions.
X/YAxisAutoRange property
Value range automatic - X/YAxisAutoRange
Enables automatic calculation of the value range of the axis selected.
Value Description
TRUE The range of values is calculated automatically.
FALSE The range of values is calculated based in the values configured in the "from" and "to" fields.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisAutoRange.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisAutoRange.
X/YAxisBeginValue property
Value range from - X/YAxisBeginValue
Specifies the lower range of values of the axis selected. You can configure the value if the
"Automatic" option is disabled.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisBeginValue.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
631
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisBeginValue.
X/YAxisColor property
Color XY axis - X/YAxisColor
Specifies the color of the axis selected. Open the "Color selection" dialog by clicking the button.
The setting is only active if the "Use trend color" field is disabled.
The X axis attribute can be assigned dynamic properties by means of the name XAxisColor.
The Y axis attribute can be assigned dynamic properties by means of the name YAxisColor.
X/YAxisEndValue property
Value range to - X/YAxisEndValue
Specifies the upper range of values of the axis selected. You can configure the value if the
"Automatic" option is disabled.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisEndValue.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisEndValue.
X/YAxisExponentialFormat property
Exponential notation - X/YAxisExponentialFormat
Enables the exponential notation for visualization of a selected axis.
Value Description
TRUE The values are displayed with exponential notation.
FALSE The values are displayed with decimal notation.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisExponentialFormat.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisExponentialFormat.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
632
System Manual, 11/2008,
X/YAxisInTrendColor property
Use trend color - X/YAxisInTrendColor
Enables the display of an axis selected in the trend color. The color of the first trend is activated
if
several trends are displayed in the trend window. Define the order of trends on the "Trends"
tab.
Value Description
TRUE The axis selected is displayed in the trend color. The setting in the "Color" field is disabled.
FALSE The axis selected is displayed using the color set in the "Color" field.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisInTrendColor.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisInTrendColor.
X/YAxisLabel property
Label - X/YAxisLabel
Defines the label text for a selected axis.
The X axis attribute can be assigned dynamic properties by means of the name XAxisLabel.
The Y axis attribute can be assigned dynamic properties by means of the name YAxisLabel.
X/YAxisName property
Object name - X/YAxisName
Specifies the name of a selected axis.
Attribute "XAxisName" can be assigned dynamic properties for the X axis by means of
XAxisRename attribute.
Attribute "YAxisName" can be assigned dynamic properties for the Y axis by means of
YAxisRename attribute.
X/YAxisPrecisions property
Decimal places - X/YAxisPrecisions
Specifies the decimal precision for displaying the axis selected. You can enter the value if the
"Automatic" option is disabled.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisPrecisions.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
633
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisPrecisions.
X/YAxisRemove property
Remove - X/YAxisRemove
Removes the selected axis from the list.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisRemove .
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisRemove .
X/YAxisRepos property
Up/Down - X/YAxisRepos
Changes the sorting order of the axes. "Up" and "Down" move the axis selected up or down
in the list.
The list order determines the axis position in the trend window. The axis output position is
moved
away from the trend if the axis is moved further up in the list and the orientation is the
same.
The X axis attribute can be assigned dynamic properties by means of the name XAxisRepos .
The Y axis attribute can be assigned dynamic properties by means of the name YAxisRepos .
X/YAxisScalingType property
Scaling - X/YAxisScalingType
Defines the scaling mode for a selected axis.
The following settings are available:
Value Description
0 Linear
1 Logarithmic
2 Logarithmically negated
The X axis attribute can be assigned dynamic properties by means of the name
XAxisScalingType.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisScalingType.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
634
System Manual, 11/2008,
X/YAxisTrendWindow property
Trend window - X/YAxisTrendWindow
Specifies the trend window for a selected axis. Define the available trend windows in the "Trend
window" tab.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisTrendWindow.
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisTrendWindow.
X/YAxisVisible property
X/Y axes - X/YAxisVisible
The list shows all axes you created.
Activate the axes to be displayed in the trend windows in the list.
Click an axis entry in the list to adapt the properties and to assign the axis to a trend window.
The X axis attribute can be assigned dynamic properties by means of the name
XAxisVisible .
The Y axis attribute can be assigned dynamic properties by means of the name
YAxisVisible .
XAxisColor Property
Description
Use this attribute to define the color for the common X-axis. The color is defined as an RGB
value. LONG write-read access.
XAxisIndex property
XAxisIndex
References a configured X axis. Using this attribute you can assign the values of other
attributes to a specific X axis.
Values between 0 and "XAxisCount" minus 1 are valid for "Index". Attribute "XAxisCount"
defines the number of configurable button functions.
The "XAxisIndex" attribute can be assigned dynamic properties by means of attribute
XAxisRepos.
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
635
XAxisRename property
XAxisRename
Renames the X axis which is referenced by means of "XAxisIndex" attribute.
The attribute can be assigned dynamic properties by means of the name XAxisRename.
"XAxisRename" also sets a dynamic attribute "XAxisName".
YAxisIndex property
YAxisIndex
References a configured Y axis. Using this attribute you can assign the values of other
attributes to a specific Y axis.
Values between 0 and "YAxisCount" minus 1 are valid for "Index". Attribute "YAxisCount"
defines the number of configured Y axes.
The "YAxisIndex" attribute can be assigned dynamic properties by means of attribute
YAxisRepos.
YAxisRename property
YAxisRename
Renames the Y axis which is referenced by means of "YAxisIndex" attribute.
The attribute can be assigned dynamic properties by means of the name YAxisRename.
"YAxisRename" also sets a dynamic attribute "YAxisName".
ZeroPoint Property
Description
Defines or returns the position of the zero point of the bar graph.
Specify the value as a %age of the total bar height. The zero point can also be outside of the
range represented.
The "ScalingType" property must be set to "2" and "Scaling" to TRUE.
See also
ScreenItem Object (Page 134)
Bar (Page 188)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
636
System Manual, 11/2008,
ZeroPointValue Property
Description
Defines the value of the zero point of the scale indicator.
Defines or returns the absolute value for the zero point.
See also
Bar (Page 188)
3D Bar (Page 182)
ScreenItem Object (Page 134)
Zoom Property
Description
Sets the zoom factor within a picture or picture window or reads it out.
If the indicated zoom factor is smaller than the minimum value, the zoom factor is automatically
set to the minimum value. If the indicated zoom factor is larger than the minimum value, the
zoom factor is automatically set to the maximum value.
The minimum value of the zoom factor is at 2%, the maximum value at 800%.
With the Screen Object the zoom factor is indicated as a numeric value and with a picture
window object, it is indicated in percent.
Example:
The following example doubles the zoom factor of the current picture:
'VBS97
HMIRuntime.ActiveScreen.Zoom = HMIRuntime.ActiveScreen.Zoom * 2
See also
Picture Window (Page 191)
Screen Object (Page 140)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
637
1.14.5 Methods
1.14.5.1 Methods
Overview
Methods, which are applied to individual objects, can be used to read out tag values for further
processing or displaying diagnostics messages in Runtime.
Available Methods in VBS
Activate GetStatusbarElement MoveToNextLine ShowLockDialog
ActivateDynami
c
GetStatusbarElementCollection MoveToNextPage ShowLockList
Add GetTimeAxis MoveToPrevious ShowLongTermArchiveList
AttachDB GetTimeAxisCollection MoveToPreviousLine ShowMessageList
CalculateStatist
ic
GetTimeColumn MoveToPreviousPage ShowPercentageAxis
CopyRows GetTimeColumnCollection NextColumn ShowPropertyDialog
CreateTagSet GetToolbarButton NextTrend ShowSelectArchive
CutRows GetToolbarButtonCollection OneToOneView ShowSelection
DeactivateDyna
mic
GetTrend PasteRows ShowSelectionDialog
DeleteRows GetTrendCollection PreviousColumn ShowSelectTimeBase
DetachDB GetTrendWindow PreviousTrend ShowShortTermArchiveList
Edit GetTrendWindowCollection Print ShowSort
Export GetValueAxis QuitHorn ShowSortDialog
GetColumn GetValueAxisCollection QuitSelected ShowTagSelection
GetColumnColl
ection
GetValueColumn QuitVisible ShowTimebaseDialog
GetHitlistColum
n
GetValueColumnCollection Read ShowTimeSelection
GetHitlistColum
nCollection
GetXAxis ReadTags ShowTrendSelection
GetMessageBl
ock
GetXAxisCollection Refresh StartStopUpdate
GetMessageBl
ockCollection
GetYAxis Remove Stop
GetMessageCo
lumn
GetYAxisCollection RemoveAll Trace
GetMessageCo
lumnCollection
HideAlarm Restore UnhideAlarm
GetOperatorMe
ssage
Item Method SelectedStatisticArea UnlockAlarm
GetOperatorMe
ssageCollection
LockAlarm ServerExport Write
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
638
System Manual, 11/2008,
GetRulerBlock LoopInAlarm ServerImport WriteTags
GetRulerBlock
Collection
MoveAxis ShowColumnSelection ZoomArea
GetRulerColum
n
MoveToFirst ShowComment ZoomInOut
GetRulerColum
nCollection
MoveToFirstLine ShowDisplayOptionsDialog ZoomInOutTime
GetRulerData MoveToFirstPage ShowEmergencyQuitDialog ZoomInOutValues
GetStatisticAre
aColumn
MoveToLast ShowHelp ZoomInOutX
GetStatisticAre
aColumnCollect
ion
MoveToLastLine ShowHideList ZoomInOutY
GetStatisticRes
ultColumn
MoveToLastPage ShowHitList ZoomMove
GetStatisticRes
ultColumnColle
ction
MoveToNext ShowInfoText
1.14.5.2 Methods A to E
Activate Method
Function
Activates the specified picture and picture element, respectively.
Note
Focus assignments should not be configured during a ButtonDown event. Since the focus is
specifically requested during the ButtonDown event, invalid states may occur.
Syntax
Expression.Activate
Expression
Necessary. An expression which returns an object of type "Screen" or "ScreenItem".
Parameters
- -
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
639
Examples
The following example shows the use for type "Screen":
'VBS98
Dim objScreen
MsgBox HMIRuntime.ActiveScreen.ObjectName 'Output of active screen
Set objScreen = HMIRuntime.Screens("ScreenWindow1")
objScreen.Activate 'Activate "ScreenWindow1"
MsgBox HMIRuntime.ActiveScreen.ObjectName 'New output of active screen
The following example shows the use for type "ScreenItem":
'VBS158
MsgBox HMIRuntime.ActiveScreen.ActiveScreenItem.ObjectName 'Output of active screen item
HMIRuntime.ActiveScreen.ScreenItems("IOField1").Activate
MsgBox HMIRuntime.ActiveScreen.ActiveScreenItem.ObjectName 'New output of active screen
item
See also
ScreenItem Object (Page 134)
Screen Object (Page 140)
ActivateDynamic method
Function
Dynamically activates a trigger for the defined property and with the defined cycle during
runtime. Every time the trigger is activated a different activation cycle can be used.
Syntax
Expression.ActivateDynamic (ByVAl bstrPropertyName As String, ByVal
bstrCycleName As String)
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)
640
System Manual, 11/2008,