System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
See also
Button Object (Page 1824)
TextList Object (Page 1964)
StatusDisplay Object (Page 1959)
StaticText Object (Page 1956)
Slider object (Page 1952)
RoundRectangle Object (Page 1945)
RoundButton Object (Page 1942)
Rectangle Object (Page 1939)
PolyLine Object (Page 1928)
Polygon Object (Page 1925)
PieSegment Object (Page 1922)
PictureWindow Object (Page 1919)
OptionGroup Object (Page 1916)
Line Object (Page 1897)
IOField Object (Page 1886)
EllipseSegment Object (Page 1859)
EllipseArc Object (Page 1856)
Ellipse Object (Page 1853)
CircularArc Object (Page 1831)
Circle Object (Page 1828)
CheckBox Object (Page 1827)
BarGraph Object (Page 1819)
ApplicationWindow Object (Page 1817)
Item Method (Page 1772)
VBA Reference (Page 1664)
Parent Property (Page 2241)
Count Property (Page 2082)
DefaultHMIObjects Property (Page 2089)
Application Property (Page 2008)
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1881
HMIObject Object
Description
Represents an object from the Object Palette of the Graphics Designer. The HMIObject object
is an element of the following listings:
● HMIObjects: Contains all objects of a picture.
● Selection: Contains all selected objects of a picture.
● HMIDefaultObjects: Contains the default property values of all standard, Windows, and
smart objects.
This object contains the object properties that apply to all standard, smart and Windows objects
(incl. Width, Height, Top and Left).
VBA Object Name
HMIObject
Usage
Use HMIObjects(Index), for instance, to return an individual HMIObject object. "For Index you
can use either the index number or the name of the object. In the following example the name
of the first object in the active picture is output:
Sub ShowFirstObjectOfCollection()
'VBA268
Dim strName As String
strName = ActiveDocument.HMIObjects(1).ObjectName
MsgBox strName
End Sub
Use the Delete method to remove an object from the HMIObjects listing. In the following
example the first object in the active picture will be removed:
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1882
System Manual, 11/2008,
Sub DeleteObject()
'VBA269
ActiveDocument.HMIObjects(1).Delete
End Sub
See also
Name Property (Page 2228)
Selection Object (Listing) (Page 1949)
HMIObjects Object (Listing) (Page 1884)
HMIDefaultObjects Object (Listing) (Page 1878)
Delete Method (Page 1745)
VBA Reference (Page 1664)
Default objects, Smart objects, Windows objects and Tube objects (Page 1609)
Editing Objects with VBA (Page 1606)
Width Property (Page 2408)
Visible Property (Page 2405)
Type Property (Page 2315)
Top Property (Page 2311)
ToolTipText Property (Page 2310)
TabOrderAlpha Property (Page 2301)
TabOrderSwitch Property (Page 2299)
Selected Property (Page 2285)
Properties Property (Page 2264)
PasswordLevel Property (Page 2244)
Parent Property (Page 2241)
Operation Property (Page 2237)
Left Property (Page 2192)
LDTooltipTexts Property (Page 2190)
Layer Property (Page 2160)
Height Property (Page 2139)
GroupParent Property (Page 2138)
Events Property (Page 2099)
Application Property (Page 2008)
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1883
HMIObjects Object (Listing)
Description
A listing of the HMIObject objects that represent all the objects in the picture.
VBA Object Name
HMIObjects
Note
Die Reihenfolge der HMI-Objekte in der HMIObjects-Auflistung kann sich durch Hinzufügen
und/oder Löschen von HMI-Objekten ändern.
The sequence of listing can also change if HMI objects are processed in the current listing.
This
behavior can occur if the Layers property is modified and/or if the methods "SendToBack"
and "BringToFront" are used.
Usage
Use the HMIObjects property to return the HMIObjects listing. In the following example all the
object names in the active picture are output:
Sub ShowObjectsOfDocument()
'VBA270
Dim colObjects As HMIObjects
Dim objObject As HMIObject
Set colObjects = ActiveDocument.HMIObjects
For Each objObject In colObjects
MsgBox objObject.ObjectName
Next objObject
End Sub
Use the AddHMIObject method to create a new object in the picture. In the following example
a circle will be inserted into the active picture:
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1884
System Manual, 11/2008,
Sub AddCircle()
'VBA271
Dim objCircle As HMICircle
Set objCircle = ActiveDocument.HMIObjects.AddHMIObject("Circle_1", "HMICircle")
End Sub
Use the Find method to search for one or more objects in the picture. In the following example,
objects of the "HMICircle" type will be searched for in the active picture:
Sub FindObjectsByType()
'VBA272
Dim colSearchResults As HMICollection
Dim objMember As HMIObject
Dim iResult As Integer
Dim strName As String
Set colSearchResults = ActiveDocument.HMIObjects.Find(ObjectType:="HMICircle")
For Each objMember In colSearchResults
iResult = colSearchResults.Count
strName = objMember.ObjectName
MsgBox "Found: " & CStr(iResult) & vbCrLf & "Objectname: " & strName
Next objMember
End Sub
See also
Count Property (Page 2082)
HMIDefaultObjects Object (Listing) (Page 1878)
Selection Object (Listing) (Page 1949)
Item Method (Page 1772)
Find Method (Page 1755)
AddOLEObject Method (Page 1722)
AddHMIObject Method (Page 1719)
AddActiveXControl Method (Page 1714)
How to edit Default objects, Smart objects, Windows objects and Tube objects (Page 1610)
VBA Reference (Page 1664)
Default objects, Smart objects, Windows objects and Tube objects (Page 1609)
Editing Objects with VBA (Page 1606)
Parent Property (Page 2241)
Application Property (Page 2008)
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1885
IOField Object
Description
Represents the "I/O Field" object. The IOField object is an element of the following listings:
● Objects: Contains all objects of a picture.
● Selection: Contains all selected objects of a picture.
● HMIDefaultObjects: Contains the default property values of all standard, Windows, and
smart objects.
VBA Object Name
HMIIOField
Usage
Use the Add method to create a new "I/O Field" object in a picture:
Sub AddIOField()
'VBA273
Dim objIOField As HMIIOField
Set objIOField = ActiveDocument.HMIObjects.AddHMIObject("IO-Field", "HMIIOField")
End Sub
Use "HMIObjects"(Index)" to return an object from the HMIObjects listing, where Index in this
case identifies the object by name:
Sub EditIOField()
'VBA274
Dim objIOField As HMIIOField
Set objIOField = ActiveDocument.HMIObjects("IO-Field")
objIOField.BorderColor = RGB(255, 0, 0)
End Sub
Use "Selection"(Index) to return an object from the Selection listing:
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1886
System Manual, 11/2008,
Sub ShowNameOfFirstSelectedObject()
'VBA275
'Select all objects in the picture:
ActiveDocument.Selection.SelectAll
'Get the name from the first object of the selection:
MsgBox ActiveDocument.Selection(1).ObjectName
End Sub
Use the "HMIDefaultObjects(Index)" to return an object from the HMIDefaultObjects Listing:
Sub EditDefaultPropertiesOfIOField()
'VBA276
Dim objIOField As HMIIOField
Set objIOField = Application.DefaultHMIObjects("HMIIOField")
objIOField.BorderColor = RGB(255, 255, 0)
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,
1887
See also
LimitMin Property (Page 2197)
ClearOnNew Property (Page 2064)
Selection Object (Listing) (Page 1949)
HMIObjects Object (Listing) (Page 1884)
HMIDefaultObjects Object (Listing) (Page 1878)
AddHMIObject Method (Page 1719)
VBA Reference (Page 1664)
Editing Objects with VBA (Page 1606)
Width Property (Page 2408)
Visible Property (Page 2405)
Top Property (Page 2311)
ToolTipText Property (Page 2310)
PasswordLevel Property (Page 2244)
OutputValue Property (Page 2241)
OutputFormat Property (Page 2240)
Orientation Property (Page 2239)
OperationReport Property (Page 2238)
OperationMessage Property (Page 2238)
Operation Property (Page 2237)
Name Property (Page 2228)
LimitMax Property (Page 2197)
Left Property (Page 2192)
Layer Property (Page 2160)
HiddenInput Property (Page 2141)
Height Property (Page 2139)
ForeFlashColorOn Property (Page 2133)
ForeFlashColorOff Property (Page 2132)
ForeColor Property (Page 2132)
FontUnderline Property (Page 2131)
FontSize Property (Page 2130)
FontName Property (Page 2129)
FontItalic Property (Page 2128)
FontBold Property (Page 2126)
FlashRateForeColor Property (Page 2123)
FlashRateBorderColor Property (Page 2120)
FlashRateBackColor Property (Page 2119)
FlashForeColor Property (Page 2114)
FlashBorderColor Property (Page 2112)
FlashBackColor Property (Page 2111)
FillStyle Property (Page 2108)
FillColor Property (Page 2104)
EditAtOnce Property (Page 2096)
DataFormat Property (Page 2089)
CursorControl Property (Page 2084)
ClearOnError Property (Page 2064)
BoxType Property (Page 2049)
BorderWidth Property (Page 2045)
BorderStyle Property (Page 2043)
BorderFlashColorOn Property (Page 2042)
BorderFlashColorOff Property (Page 2040)
BorderColor Property (Page 2036)
BorderBackColor Property (Page 2035)
BackFlashColorOn Property (Page 2022)
BackFlashColorOff Property (Page 2021)
BackColor Property (Page 2017)
AssumeOnFull Property (Page 2010)
AssumeOnExit Property (Page 2010)
AlignmentTop Property (Page 2005)
AlignmentLeft Property (Page 2004)
AdaptBorder Property (Page 1999)
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1888
System Manual, 11/2008,
4.4.7.3 L-Q
LanguageFont Object
Description
Contains the font settings for the project language. The LanguageFont object is an element of
the LanguageFonts listing.
VBA Object Name
HMILanguageFont
Usage
Use LDFonts(Index) to return an individual LanguageFont object. In the following example a
Button object will be created and the name of the first configured font will be output:
Sub ShowFirstObjectOfCollection()
'VBA277
Dim strName As String
Dim objButton As HMIButton
Set objButton = ActiveDocument.HMIObjects.AddHMIObject("Button", "HMIButton")
strName = objButton.LDFonts(1).Family
MsgBox strName
End Sub
Object properties
The LanguageFont object possesses the following properties:
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1889
See also
LanguageFonts Object (Listing) (Page 1890)
VBA Reference (Page 1664)
Underlined Property (Page 2324)
Size Property (Page 2291)
Parent Property (Page 2241)
LanguageID Property (Page 2158)
Italic Property (Page 2151)
FontFamily Property (Page 2127)
Bold Property (Page 2034)
Application Property (Page 2008)
LanguageFonts Object (Listing)
Description
A listing of the LanguageFont objects that represent all the language-dependent fonts in an
object.
VBA Object Name
HMILanguageFonts
Usage
Use the LDFonts property to return the LanguageFonts listing. In the following example the
language identifiers of the configured fonts will be output:
Sub ShowLanguageFont()
'VBA278
Dim colLanguageFonts As HMILanguageFonts
Dim objLanguageFont As HMILanguageFont
Dim objButton As HMIButton
Dim iMax As Integer
Set objButton = ActiveDocument.HMIObjects.AddHMIObject("myButton", "HMIButton")
Set colLanguageFonts = objButton.LDFonts
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1890
System Manual, 11/2008,