System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
WindowPositionMode property
Description
Defines the position and scaling of the picture window on the screen. The property is only
effective if the "Independent window" attribute is set to "Yes".
Standard The picture window is positioned in its original size in the configured position
on the screen.
Center The picture window is positioned in its original size, centered on the screen.
Maximize The picture window is scaled to the size of the screen.
Example
WindowsStyle property
Description
Defines whether the object is displayed in the Windows style of WinCC version 6.2. It can only
be selected if "WinCC Classic" is chosen as the current design.
yes Shows the object using the Windows style from WinCC version 6.2.
No Shows the object not using the Windows style from WinCC version 6.2.
Example
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2411
WindowState Property
Description
Returns the status of the window containing the specified application. READ access.
WindowState Assigned Value
Maximized 0
Minimized 1
Custom sized 2
Example:
In the following example the window status of the Graphics Designer is output:
Sub ShowWindowState()
'VBA798
Dim strState As String
Select Case Application.WindowState
Case 0
strState = "The application-window is maximized"
Case 1
strState = "The applicationwindow is minimized"
Case 2
strState = "The application-window has a userdefined size"
End Select
MsgBox strState
End Sub
See also
Application Object (Page 1814)
ZeroPoint Property
Description
Defines or returns the position of the zero point on the bar in the case of the BarGraph object.
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" must be set to "True".
VBA for Automated Configuration
4.4 The object model of the Graphics Designer
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2412
System Manual, 11/2008,
Example:
The "BarGraphConfiguration()" procedure configures In this example the zero point is located
halfway up the bar height:
Sub BarGraphConfiguration()
'VBA799
Dim objBarGraph As HMIBarGraph
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject("Bar1", "HMIBarGraph")
With objBarGraph
.Scaling = True
.ScalingType = 2
.ZeroPoint = 50
.ZeroPointValue = 0
End With
End Sub
See also
ZeroPointValue Property (Page 2413)
ScalingType Property (Page 2279)
Scaling Property (Page 2278)
BarGraph Object (Page 1819)
ZeroPointValue Property
Description
Defines or returns the absolute value for the zero point.
Example:
The "BarGraphConfiguration()" procedure configures In this example the absolute value of the
zero point will be set to "0".
Sub BarGraphConfiguration()
'VBA800
Dim objBarGraph As HMIBarGraph
Set objBarGraph = ActiveDocument.HMIObjects.AddHMIObject("Bar1", "HMIBarGraph")
With objBarGraph
.Scaling = True
.ScalingType = 2
.ZeroPointValue = 0
End With
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,
2413
See also
ZeroPoint Property (Page 2412)
ScalingType Property (Page 2279)
Scaling Property (Page 2278)
BarGraph Object (Page 1819)
3DBarGraph Object (Page 1805)
Zoom Property
Description
Defines or returns the zoom factor.
Example:
In this example a copy of the active picture is created and the zoom factor is set to 50%:
Sub CreateViewFromActiveDocument()
'VBA801
Dim objView As HMIView
Set objView = ActiveDocument.Views.Add
objView.Zoom = 50
End Sub
See also
View Object (Page 1991)
PictureWindow Object (Page 1919)
4.5 AddIns
4.5.1 AddIns
Introduction
An AddIn is a code which cannot be viewed and is stored as a DLL. Addins can make new
functions available by registering the DLL concerned in the operating system and loading
To you as a user, the advantage of addins is that they provide functions which are tailor made
for the associated application. For example if you working on different computers during
configuration
and frequently use VBA macros, you can combine these VBA macros in one or
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2414
System Manual, 11/2008,
more addins. When you change to a different computer you need only copy the addin and you
can then access the customary functions on the new workstation.
As a developer, you can use the Graphics Designer program library in a development
environment to create MS Visual Studio 6.0 addins, for example, and protect your code from
intrusion.
Addins in the Graphics Designer
In the Graphics Designer you can use all the addins that have been developed for the Graphics
Designer and registered in the operating system of the computer you are using for
configuration.
You can automatically load an addin when you start the Graphics Designer if you frequently
need the functions the addins contain.
When you no longer need the functions of an addin, you can unload it again at any time.
See also
Loading an Addin in the Graphics Designer (Page 2417)
Example: Creating Add Ins (Page 2418)
Linking Add Ins (Page 2415)
4.5.2 Linking Add Ins
Requirements
An addin must be registered in the operating system. To register a new addin, double click on
the appropriate DLL file.
Note
For the registration to wok on a double-click, the DLL files must be linked to the application
RegSvr32.exe.
Introduction
In the Graphics Designer use the Addin Manager to define the way addins that can be used
in the Graphics Designer will behave on loading.
To start the Addin Manager, go to the Graphics Designer and select the command "Macros"
> "AddIn Manager":
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2415
Automatically Loading an Addin
If the addin contains new functions that you always need in the Graphics Designer, you can
load the addin automatically when you open the Graphics Designer.
To do this go to the Addin Manager, select the addin and enable the "Load on Startup"
checkbox.
Note
Depending how the addin is programmed, the function contained in the addin can also be
entered in the menu "Tools" > "Macros" > "AddIns". You can then start the function just by
clicking on it.
Manually Loading or Unloading an Addin
You can also load an addin manually if you need its functions for particular purposes only (such
as test routines).
To load or unload an addin manually, go to the Addin Manager, select the addin and enable
the "Loaded/Unloaded" checkbox.
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2416
System Manual, 11/2008,
See also
Loading an Addin in the Graphics Designer (Page 2417)
Example: Creating Add Ins (Page 2418)
AddIns (Page 2414)
4.5.3 Loading an Addin in the Graphics Designer
Requirements
An addin must be registered in the operating system. To register a new addin, double click on
the appropriate DLL file.
Note
For the registration to wok on a double-click, the DLL files must be linked to the application
RegSvr32.exe.
Procedure
1. Start the Graphics Designer and open the project to which you want to link the addin.
2. To call the Addin Manager, select the menu command "Tools" > "AddIn Manager".
The Addin Manager opens. The "Available Add-Ins" list shows all the addins that are
available, together with their current load status:
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2417
3. For each addin define whether it is to be loaded and if so when. To do this select the addin
concerned and enable the appropriate checkbox under "Load Behavior".
4. To unload an addin, select the addin concerned and disable the "Load/Unload" checkbox
under "Load Behavior".
5. Click OK.
Result
Depending how the addin is programmed, the function contained in the addin is either listed
in the "Tools" > "AddIns" menu or reacts to an event handler in the Graphics Designer.
If the addin is started by means of an event handler (e.g. Started Event), the "On Startup"
checkbox should be enabled for the addin.
See also
Linking Add Ins (Page 2415)
AddIns (Page 2414)
4.5.4 Example: Creating Add Ins
4.5.4.1 Example: Creating Add Ins
Introduction
In order to create Addins, this documentation contains an example for Visual Basic 6.0, which
creates a runable Addin for use in the Graphic Designer.
Requirements
MS Visual Studio 6.0 must be installed on the configuration computer.
You should have programming experience if you wish to use the sample code as a basis for
developing addins of your own.
Example: Program Template for Visual Basic 6.0
Use the event handler "AddInInstance_OnConnection" to generate an instance of the Graphics
Designer. In order for the addin to be able to access the Graphics Designer, it is mandatory
to declare the application.
See also
Example: Creating an Add In with Visual Basic 6.0 (Page 2419)
Linking Add Ins (Page 2415)
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2418
System Manual, 11/2008,
4.5.4.2 Example: Creating an Add In with Visual Basic 6.0
Introduction
The program code in this example produces a file called "MyAddIn.DLL". So that the addin will
work
in Graphics Designer, you must enable the "Load on Startup" checkbox for this addin in
the Addin Manager of Graphics Designer. For this purpose you can also use the
"LoadOnStartup" function in the addin.
When you open Graphics Designer the addin generates a user-defined menu. You can also
use the "Tools" > "AddIns" menu to call the function contained in the addin.
Requirements
So that you can create an executable addin from the sample code, "MS Visual Studio 6.0"
must You must also have referenced "WinCC Graphics Designer 1.0 Type Library" in "MS
Visual Studio 6.0":
Procedure
1. Open "MS Visual Studio 6.0" and create a new project. To create a project, go to the "New
Project" dialog, select the "AddIn" entry and click on OK.
2. In Project Explorer, open the "Designer" folder and double click the entry called "Connect".
The "Connect (AddIn Designer)" dialog opens.
3. Under "Application", select the entry for "Graphics Designer" and select the "Initial Behavior
on Loading" for the addin. Close the "Connect (AddIn Designer)" dialog.
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
2419
4. In Project Explorer, open the "Designer" folder and use the pop-up menu to select the
command "Display Code" for the "Connect" entry.
VBA for Automated Configuration
4.5 AddIns
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
2420
System Manual, 11/2008,