System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
CreateCustomizedObject Method
Description
Creates a customized object from the objects selected in the specified picture. You then have
to configure the customized object in the "Configuration Dialog".
For further information on this topic please refer to "Customized Objects" in this documentation
and "Customized Object" in the WinCC documentation.
syntax
Expression.
CreateCustomizedObject()
Expression
Necessary. An expression or element which returns an object of the "Selection" type.
Parameters
--
Example:
In the following example two objects are inserted at different positions in the current picture
and a customized object is then created:
Sub CreateCustomizedObject()
'VBA140
Dim objCircle As HMICircle
Dim objRectangle As HMIRectangle
Dim objCustObject As HMICustomizedObject
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject("sCircle", "HMICircle")
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject("sRectangle", "HMIRectangle")
With objCircle
.Top = 40
.Left = 40
.Selected = True
End With
With objRectangle
.Top = 80
.Left = 80
.Selected = True
End With
MsgBox "Objects selected!"
Set objCustObject = ActiveDocument.Selection.CreateCustomizedObject
objCustObject.ObjectName = "myCustomizedObject"
End Sub
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1741
See also
Selection Object (Listing) (Page 1949)
CustomizedObject Object (Page 1839)
VBA Reference (Page 1664)
Customized Objects (Page 1626)
CreateDynamic Method
Description
Makes the specified property dynamic.
syntax
Expression.
CreateDynamic(DynamicType, [SourceCode])
Expression
Necessary. An expression or element which returns an object of the "Property" type.
Parameters
You only need use the "SourceCode" parameter if you want to make the specified property
dynamic with the aid of the Dynamic dialog.
In all other types of dynamics you can omit the parameter.
Parameter (Data Type) Description
DynamicType (HMIDynamicCreationType) Defines the type of dynamics:
● hmiDynamicCreationTypeVariableDirect:
Dynamics with a tag
● hmiDynamicCreationTypeVariableIndirect:
Dynamics with a tag In this type of dynamics
you specify only the name of the tag whose
value will be used for dynamic purposes.
● hmiDynamicCreationTypeScript: Dynamics
with a script (C, VB).
● hmiDynamicCreationTypeDynamicDialog:
Dynamizing with the dynamic dialog box:
SourceCode (String) Defines the function or tag that will be used for
dynamic purposes.
Also specify the tag name in single quote marks:
"Tag name"
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1742
System Manual, 11/2008,
Example:
In this example a circle property "Top" will be made dynamic with the aid of the tag
"NewDynamic":
Sub AddDynamicAsVariableDirectToProperty()
'VBA141
Dim objVariableTrigger As HMIVariableTrigger
Dim objCircle As HMICircle
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject("MyCircle", "HMICircle")
'Make property "Top" dynamic:
Set objVariableTrigger = objCircle.Top.CreateDynamic(hmiDynamicCreationTypeVariableDirect,
"NewDynamic")
'
'Define cycle-time
With objVariableTrigger
.CycleType = hmiCycleType_2s
End With
End Sub
See also
Property Object (Page 1932)
DeleteDynamic Method (Page 1747)
VBA Reference (Page 1664)
CreateGroup Method
Description
Creates a group object from the objects selected in the specified picture.
For further information on this topic please refer to "Group Objects" in this documentation and
"Group Object" in the WinCC documentation.
syntax
Expression.
CreateGroup()
Expression
Necessary. An expression or element which returns an object of the "Selection" type.
Parameters
--
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1743
Example:
In the following example two objects are inserted at different positions in the current picture
and a group object is then created:
Sub CreateGroup()
'VBA142
Dim objCircle As HMICircle
Dim objRectangle As HMIRectangle
Dim objGroup As HMIGroup
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject("sCircle", "HMICircle")
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject("sRectangle", "HMIRectangle")
With objCircle
.Top = 40
.Left = 40
.Selected = True
End With
With objRectangle
.Top = 80
.Left = 80
.Selected = True
End With
MsgBox "Objects selected!"
Set objGroup = ActiveDocument.Selection.CreateGroup
objGroup.ObjectName = "myGroup"
End Sub
See also
Selection Object (Listing) (Page 1949)
Group Object (Page 1873)
VBA Reference (Page 1664)
Group Objects (Page 1618)
4.4.6.2 D-M
GetDeclutterObjectSize method
Description
Reads the limits displaying and hiding objects (decluttering) in the specified picture.
Syntax
Expression.
GetDeclutterObjectSize(Min, Max)
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1744
System Manual, 11/2008,
Expression
Required. An expression or element which returns an object of the "Document" type.
Parameter
Parameter (data type) Description
Min (Long) Lower size range in pixels.
Max (Long) Upper size range in pixels.
Example
In the following example, the decluttering limits of the active picture are read and output:
Sub ReadSettingsOfPicture()
'VBA848
Dim objectsize_min As Long, objectsize_max As Long
ActiveDocument.GetDeclutterObjectSize objectsize_min, objectsize_max
MsgBox objectsize_min & " " & objectsize_max
End Sub
Delete Method
Description
Deletes the specified object and removes it from the listing.
syntax
Expression.
Delete()
Expression
Necessary. An expression or element which returns objects of the following types.
● Assignment
● FolderItem
● LanguageText
● Menu
● MenuItem
● Object
● Toolbar
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1745
● ToolbarItem
● VariableTrigger
● View
Parameters
--
Example:
In the following example the first object in the active picture will be deleted. For this example
to work, you must have created at least one object in the active picture:
Sub ObjectDelete()
'VBA143
ActiveDocument.HMIObjects(1).Delete
End Sub
See also
LanguageText Object (Page 1892)
View Object (Page 1991)
VariableTrigger Object (Page 1989)
ToolbarItem Object (Page 1970)
FolderItem Object (Page 1867)
HMIObject Object (Page 1882)
MenuItem Object (Page 1906)
Menu Object (Page 1903)
VBA Reference (Page 1664)
DeleteAll Method
Description
Deletes all selected objects in the specified picture and removes them from the "Selection"
and "HMIObjects" listings.
syntax
Expression.
DeleteAll()
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1746
System Manual, 11/2008,
Expression
Necessary. An expression or element which returns an object of the "Selection" type.
Parameters
--
Example:
In the following example two objects are inserted at different positions in the current picture
and then selected and deleted:
Sub DeleteAllSelectedObjects()
'VBA145
Dim objCircle As HMICircle
Dim objRectangle As HMIRectangle
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject("sCircle", "HMICircle")
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject("sRectangle", "HMIRectangle")
With objCircle
.Top = 40
.Left = 40
.Selected = True
End With
With objRectangle
.Top = 80
.Left = 80
.Selected = True
End With
MsgBox "Objects selected!"
ActiveDocument.Selection.DeleteAll
End Sub
See also
Selection Object (Listing) (Page 1949)
VBA Reference (Page 1664)
DeleteDynamic Method
Description
Removes the dynamic characteristic from the specified property.
syntax
Expression.
DeleteDynamic
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1747
Expression
Necessary. An expression or element which returns an object of the "Property" type.
Parameters
--
Example:
In the following example the dynamic characteristic created with the aid of the CreateDynamic
Method will be
Sub DeleteDynamicFromObjectMeinKreis()
'VBA146
Dim objCircle As HMICircle
Set objCircle = ActiveDocument.HMIObjects("MyCircle")
objCircle.Top.DeleteDynamic
End Sub
See also
Property Object (Page 1932)
CreateDynamic Method (Page 1742)
VBA Reference (Page 1664)
DeselectAll Method
Description
Deselects all selected objects in the specified picture and removes them from the Selection
listing.
syntax
Expression.
DeselectAll()
Expression
Necessary. An expression or element which returns an object of the "Selection" type.
Parameters
--
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1748
System Manual, 11/2008,
Example:
In the following example two objects are inserted at different positions in the current picture
and selected. All selected objects are then deselected:
Sub SelectObjectsAndDeselectThemAgain()
'VBA147
Dim objCircle As HMICircle
Dim objRectangle As HMIRectangle
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject("sCircle", "HMICircle")
Set objRectangle = ActiveDocument.HMIObjects.AddHMIObject("sRectangle", "HMIRectangle")
With objCircle
.Top = 40
.Left = 40
.Selected = True
End With
With objRectangle
.Top = 80
.Left = 80
.Selected = True
End With
MsgBox "Objects created and selected!"
ActiveDocument.Selection.DeselectAll
MsgBox "Objects deselected!"
End Sub
See also
Selection Object (Listing) (Page 1949)
VBA Reference (Page 1664)
Destroy Method
Description
Destroys the specified customized object. The objects remain intact.
syntax
Expression.
Destroy()
Expression
An expression or element which returns objects of the "CustomizedObject" types.
Parameters
--
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1749
Example:
An example showing how to use the Destroy Method can be found in this documentation under
the heading "Editing a Customized Object with VBA".
See also
CustomizedObject Object (Page 1839)
Destroy Method (Page 1749)
Delete Method (Page 1745)
CreateCustomizedObject Method (Page 1741)
How to Edit a Customized Object with VBA (Page 1628)
DuplicateSelection Method
Description
Duplicates the objects selected in the specified picture. The objects created in this way are
added
to the HMIObjects listing. The names of new objects are numbered consecutively with
each duplication.
For instance if you duplicate an object called "Circle", the duplicate object is called "Circle1".
If you duplicate the object called "Circle" once more, the resulting object is called "Circle2" and
so on.
syntax
Expression.
DuplicateSelection()
Expression
Necessary. An expression or element which returns an object of the "Selection" type.
Parameters
--
Example:
In the following example two objects are inserted at different positions in the current picture
and selected. They are then duplicated:
Sub DuplicateSelectedObjects()
'VBA149
Dim objCircle As HMICircle
Dim objRectangle As HMIRectangle
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1750
System Manual, 11/2008,