zenon manual Programming Interfaces v.8.20 © 2020 Ing. Punzenberger COPA-DATA GmbH All rights reserved. Distribution and/or reproduction of this document or parts thereof in any form are permitted solely with the written permission of the company COPA-DATA. Technical data is only used for product description and are not guaranteed properties in the legal sense. Subject to change, technical or otherwise. Contents 1 Welcome to COPA-DATA help ............................................................................................................... 6 2 Programming Interfaces ........................................................................................................................... 6 3 Add-Ins ......................................................................................................................................................... 9 3.1 Prior knowledge ............................................................................................................................................. 11 3.2 Terminology ..................................................................................................................................................... 11 3.3 Limitations ........................................................................................................................................................ 12 3.4 Create add-in ................................................................................................................................................... 13 3.4.1 Basics .......................................................................................................................................................................... 14 3.4.2 Types of extensions .............................................................................................................................................. 18 3.4.3 Content of add-in packages ............................................................................................................................. 20 3.4.4 Microsoft Visual Studio ....................................................................................................................................... 21 3.4.5 SharpDevelop ......................................................................................................................................................... 28 3.4.6 Source code administration .............................................................................................................................. 31 3.4.7 Add-in analysis and packaging utility (AddInUtility)............................................................................... 32 3.4.8 Action in the event of reloading ..................................................................................................................... 33 3.4.9 Isolation .................................................................................................................................................................... 33 3.5 Use of add-ins in Editor and Runtime .................................................................................................... 33 3.5.1 Activate add-ins in zenon .................................................................................................................................. 36 3.5.2 Action during installation .................................................................................................................................. 36 3.5.3 Add-ins node in the Project Manager .......................................................................................................... 36 3.5.4 Use in the zenon Editor ...................................................................................................................................... 38 3.5.5 Use in zenon Runtime ......................................................................................................................................... 42 3.5.6 Troubleshooting .................................................................................................................................................... 45 3.6 zenon functions .............................................................................................................................................. 45 3.6.1 Display dialog "Manage Runtime services" ................................................................................................ 46 3.6.2 Execute Project Wizard Extension .................................................................................................................. 48 3.7 Switch/conversion from VSTA ................................................................................................................... 50 4 VSTA ............................................................................................................................................................ 52 4.1 Basics .................................................................................................................................................................. 54 4.1.1 Setting up the VSTA environment .................................................................................................................. 54 4.1.2 Access to the object model in zenon ............................................................................................................ 55 4.1.3 Functions in zenon ............................................................................................................................................... 57 4.1.4 Debugging a VSTA add-in ................................................................................................................................. 59 4.1.5 Events in VSTA ........................................................................................................................................................ 59 4.1.6 Creating a backup of VSTA projects .............................................................................................................. 60 4.2 Creating a VSTA project .............................................................................................................................. 60 4.2.1 VSTA projects in the editor ............................................................................................................................... 61 4.2.2 VSTA projects in Runtime .................................................................................................................................. 61 4.2.3 Developing wizards in VSTA ............................................................................................................................. 62 4.3 Examples ........................................................................................................................................................... 63 4.3.1 Creating variables in the zenon editor ......................................................................................................... 63 4.3.2 Writing project information in the zenon output window ................................................................... 66 4.3.3 Reading in of variables in zenon via regular expressions ..................................................................... 68 4.3.4 Conversion of colors between .NET and zenon ........................................................................................ 71 5 Macro List ................................................................................................................................................... 76 5.1 VBA toolbar and context menu detail view ......................................................................................... 77 5.2 VBA on 64-bit systems ................................................................................................................................. 79 5.3 Basics .................................................................................................................................................................. 80 5.3.1 Object PROPERTIES .............................................................................................................................................. 80 5.3.2 Object METHODS .................................................................................................................................................. 80 5.3.3 Object EVENTS ....................................................................................................................................................... 81 5.3.4 VBA object structure in zenon ......................................................................................................................... 81 5.3.5 How to use VBA macros ..................................................................................................................................... 83 5.3.6 How to insert an ActiveX element in zenon? ............................................................................................. 84 5.3.7 Access from an external program .................................................................................................................. 86 5.3.8 Functionality of online variables ..................................................................................................................... 87 5.3.9 List of status bits ...................................................................................................................................................