System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Restrictions of VBS for Dynamization by Controls
If Controls are to be dynamized with, the following conditions must be fulfilled:
Methods
The "ByRef" declaration may only be implemented as a "Variant" (ByRef xxx as Variant)
The "ByVal" declaration may only be implemented with tag types (ByVal xxx as Long)
Properties
The "ByRef" declaration may only be implemented as a "Variant" (ByRef xxx as Variant)
The "ByVal" declaration may only be implemented with tag types (ByVal xxx as Long)
Events
The "ByRef" declaration is not permitted.
The "ByVal" declaration may only be implemented as a "Variant" (ByVal xxx as Variant)
Arrays
If arrays are used, they must be declared with (ByRef xxx As Variant).
In order that arrays can be transferred in variants, variant tag must also be inserted as an
intermediate tag according to the following scheme:
'VBS151
Dim arrayPoints(200)
Dim vArrayCoercion 'Variant for array Coercion
' Make the VBS Array compatibile with the OLE Automation
vArrayCoercion = (arrayPoints)
objTrendControl.DataXY = vArrayCoercion ' this array will occur in the control
Use of Controls from External Suppliers
If a non-WinCC control is used, it is possible that the properties provided by the control have
the same names as the general ScreenItem properties. In such cases, the ScreenItem
properties have priority. The "hidden" properties of an external control supplier can be
accessed
using the additional "object" property. Address the properties of an external control
supplier as follows:
Control.object.type
If you use the following form, the properties of the ScreenItem object are used in the case of
identical names:
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
231
Control.type
Double parameter
When using a Control which is not an internal WinCC control, it is possible that the event
prototypes
contain a parameter with the name "Item". In this case, the name of the parameter
is renamed according to "ObjectItem" in the VBS prototype submitted. If this name already
exists, the name is differentiated by numbers being appended.
WinCC controls available
● HMI Symbol Library 1.4.1
● WinCC AlarmControl
● WinCC Alarm Control (before WinCC V7)
● WinCC Digital/Analog Clock
● WinCC FunctionTrendControl
● WinCC Function Trend Control (before WinCC V7)
● WinCC Gauge Control
● WinCC Media Control
● WinCC OnlineTableControl
● WinCC Online Table Control (before WinCC V7)
● WinCC OnlineTrendControl
● WinCC Online Trend Control (before WinCC V7)
● WinCC Push Button Control
● WinCC RulerControl
● WinCC Slider Control
● WinCC UserArchiveControl
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
232
System Manual, 11/2008,
See also
HMI Symbol Library 1.4.1 (Page 233)
WinCC Slider Control (Page 259)
WinCC Push Button Control (Page 253)
WinCC Online Trend Control (before WinCC V7) (Page 271)
WinCC Online Table Control (before WinCC V7) (Page 269)
WinCC Gauge Control (Page 243)
WinCC Function Trend Control (before WinCC V7) (Page 267)
WinCC Digital/Analog Clock (Page 239)
WinCC Alarm Control (before WinCC V7) (Page 265)
WinCC UserArchiveControl (Page 263)
WinCC RulerControl (Page 257)
WinCC OnlineTrendControl (Page 250)
WinCC OnlineTableControl (Page 247)
WinCC FunctionTrendControl (Page 241)
WinCC AlarmControl (Page 236)
HMI Symbol Library 1.4.1
Description
Object Type of ScreenItem Object. Represents the graphic object "HMI Symbol Library"
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
233
Type Identifier in VBS
HMISymbolLibrary
Usage
In the following example, the object with the name "Control1" is moved 20 pixels to the right:
'VBS64
Dim objControl
Set objControl = ScreenItems("Control1")
objControl.Left = objControl.Left +20
Properties
This object type has the following properties:
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
234
System Manual, 11/2008,
See also
Left Property (Page 423)
Activate Method (Page 639)
Properties (Page 276)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Controls (Page 230)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
Stretch Property (Page 529)
Rotation Property (Page 492)
Picture Property (Page 478)
Parent Property (Page 471)
ObjectName Property (Page 455)
Object Property (Page 455)
Layer Object (Page 127)
Height Property (Page 391)
ForeColor Property (Page 383)
Flip Property (Page 377)
Enabled Property (Page 360)
Cursor Property (Page 348)
BlinkSpeed Property (Page 308)
BlinkMode Property (Page 307)
BlinkColor Property (Page 307)
BackStyle Property (Page 299)
BackColor Property (Page 295)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
235
WinCC AlarmControl
Description
Object Type of ScreenItem Object. Represents the graphic object "WinCC AlarmControl" as
of WinCC V7.0.
Type Identifier in VBS
HMIAlarmControl
Usage
In the following example, the object with the name "Control1" is moved 10 pixels to the right:
'VBS54
Dim objControl
Set objControl = ScreenItems("Control1")
objControl.Left = objControl.Left 10
Available Methods in VBS
Activate GetOperatorMessage MoveToNextLine ShowHitList
ActivateDynamic
GetOperatorMessageColle
ction
MoveToNextPage ShowInfoText
AttachDB GetStatusbarElement MoveToPreviousLine ShowLockDialog
CopyRows GetStatusbarElementColle
ction
MoveToPreviousPage ShowLockList
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
236
System Manual, 11/2008,
DeactivateDyna
mic
GetToolbarButton Print ShowLongTermArchiveList
DetachDB GetToolbarButtonCollectio
n
QuitHorn ShowMessageList
Export HideAlarm QuitSelected ShowPropertyDialog
GetHitlistColumn
LockAlarm QuitVisible ShowSelectionDialog
GetHitlistColumn
Collection
LoopInAlarm ShowComment ShowShortTermArchiveList
GetMessageBloc
k
MoveToFirstLine ShowDisplayOptionsDialog ShowSortDialog
GetMessageBloc
kCollection
MoveToFirstPage ShowEmergencyQuitDialog ShowTimebaseDialog
GetMessageCol
umn
MoveToLastLine ShowHelp UnhideAlarm
GetMessageCol
umnCollection
MoveToLastPage ShowHideList UnlockAlarm
Available Properties in VBS
Activate HorizontalGridLines OperatorMessageSourceTyp
e3
StatusbarElementWidth
AllServer IconSpace OperatorMessageSourceTyp
e4
StatusbarShowTooltips
ApplyProjectSettings LineColor (Page 426) OperatorMessageSourceTyp
e5
StatusbarUseBackColor
AutoCompleteColumns LineWidth (Page 428) OperatorMessageSourceTyp
e6
StatusbarVisible
AutoCompleteRows LongTermArchiveConsistenc
y
OperatorMessageSourceTyp
e7
TableColor
AutoScroll MessageBlockAlign OperatorMessageSourceTyp
e8
TableColor2
AutoSelectionColors MessageBlockAutoPrecision
s
OperatorMessageSourceTyp
e9
TableForeColor
AutoSelectionRectColor MessageBlockCaption PageMode TableForeColor2
BackColor MessageBlockDateFormat PageModeMessageNumber TimeBase
BorderColor MessageBlockExponentialFo
rmat
PrintJobName TitleColor
BorderWidth MessageBlockFlashOn RowScrollbar TitleCut
Caption MessageBlockHideText RowTitleAlign TitleDarkShadowColor
CellCut MessageBlockHideTitleText RowTitles TitleForeColor
CellSpaceBottom MessageBlockIndex RTPersistence TitleGridLineColor
CellSpaceLeft MessageBlockLeadingZeros RTPersistencePasswordLev
el
TitleLightShadowColor
CellSpaceRight MessageBlockLength RTPersistenceType TitleSort
CellSpaceTop MessageBlockPrecisions SelectedCellColor TitleStyle
Closeable MessageBlockSelected SelectedCellForeColor ToolbarAlignment
ColumnResize MessageBlockShowDate SelectedRowColor ToolbarBackColor
ColumnTitleAlign MessageBlockShowIcon SelectedRowForeColor ToolbarButtonActive
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
237
ColumnTitles MessageBlockShowTitleIcon SelectedTitleColor ToolbarButtonAdd
DefaultMsgFilterSQL MessageBlockTextId SelectedTitleForeColor ToolbarButtonBeginGroup
DefaultSort MessageColumnAdd SelectionColoring ToolbarButtonClick
DefaultSort2 MessageColumnIndex SelectionRect ToolbarButtonEnabled
DefaultSort2Column MessageColumnRemove SelectionRectColor ToolbarButtonHotKey
DisplayOptions MessageColumnRepos SelectionRectWidth ToolbarButtonId
DoubleClickAction MessageColumnSort SelectionType ToolbarButtonIndex
ExportDirectoryChangeable MessageColumnSortIndex ServerNames ToolbarButtonLocked
ExportDirectoryname MessageColumnVisible ShowSortButton ToolbarButtonName
ExportFileExtension MessageListType ShowSortIcon ToolbarButtonPasswordLeve
l
ExportFilename Moveable ShowSortIndex ToolbarButtonRemove
ExportFilenameChangeable MsgFilterSQL ShowTitle ToolbarButtonRename
ExportParameters OperatorMessageNumber Sizeable ToolbarButtonRepos
ExportSelection OperatorMessageSelected SkinName ToolbarButtonTooltipText
ExportShowDialog OperatorMessageSource1 SortSequence ToolbarButtonVisible
Font OperatorMessageSource10 StatusbarBackColor ToolbarShowTooltips
GridLineColor OperatorMessageSource2 StatusbarElementAdd ToolbarUseBackColor
GridLineWidth OperatorMessageSource3 StatusbarElementAutoSize ToolbarUseHotKeys
HitlistColumnAdd OperatorMessageSource4 StatusbarElementIconId ToolbarVisible
HitlistColumnIndex OperatorMessageSource5 StatusbarElementId UseMessageColor
HitlistColumnRemove OperatorMessageSource6 StatusbarElementIndex UseSelectedTitleColor
HitlistColumnRepos OperatorMessageSource7 StatusbarElementName UseTableColor2
HitlistColumnSort OperatorMessageSource8 StatusbarElementRemove VerticalGridLines
HitlistColumnSortIndex OperatorMessageSource9 StatusbarElementRename
HitlistColumnVisible OperatorMessageSourceTyp
e1
StatusbarElementRepos
HitListDefaultSort OperatorMessageSourceTyp
e10
StatusbarElementText
HitListMaxSourceItems OperatorMessageSourceTyp
e2
StatusbarElementTooltipText
HitListMaxSourceItemsWarn StatusbarElementVisible
HitListRelTime
HitListRelTimeFactor
HitListRelTimeFactorType
See also
Controls (Page 230)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
238
System Manual, 11/2008,
WinCC Digital/Analog Clock
Description
Object Type of ScreenItem Object. Represents the graphic object "WinCC Digital/Analog
Clock"
Type Identifier in VBS
HMIClock
Usage
In the following example, the object with the name "Control1" is moved 11 pixels to the right:
'VBS55
Dim objControl
Set objControl = ScreenItems("Control1")
objControl.Left = objControl.Left +11
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
239
See also
Parent Property (Page 471)
Activate Method (Page 639)
Properties (Page 276)
ScreenItems Object (List) (Page 138)
ScreenItem Object (Page 134)
Controls (Page 230)
Width Property (Page 626)
Visible Property (Page 624)
Type Property (Page 596)
Top Property (Page 575)
Ticks Property (Page 536)
TicksColor Property (Page 536)
SquareExtent Property (Page 523)
SecondNeedleWidth Property (Page 503)
SecondNeedleHeight Property (Page 503)
Picture Property (Page 478)
ObjectName Property (Page 455)
Object Property (Page 455)
MinuteNeedleWidth Property (Page 450)
MinuteNeedleHeight Property (Page 450)
LocaleID Property (Page 429)
Left Property (Page 423)
Layer Object (Page 127)
HourNeedleWidth Property (Page 398)
HourNeedleHeight Property (Page 398)
Height Property (Page 391)
Handtype Property (Page 391)
HandFillColor Property (Page 390)
ForeColor Property (Page 383)
Font Property (Page 379)
FocusRect Property (Page 378)
Enabled Property (Page 360)
BackStyle Property (Page 299)
BackColor Property (Page 295)
Analog Property (Page 286)
VBS for Creating Procedures and Actions
1.14 VBS Reference
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
240
System Manual, 11/2008,