SIEMENSVBS for Creating Proceduresand ActionsANSI-C for CreatingFunctions and Actions2VBA for AutomatedSIMATIC HMIConfiguration3WinCC V7.4WinCC:Scripting (VBS,ANSI-C,VBA)System ManualPrint of the Online Help02/2016Legal informationThis manual contains notices you have to observe in order to ensure your personal safety,as well as to preventdamage to property.The notices referring to your personal safety are highlighted in the manual by a safety alertsymbol,notices referring only to property damage have no safety alert symbol.These notices shown below aregraded according to the degree of danger.DANGERindicates that death or severe personal injury will result if proper precautions are not taken.WARNINGindicates that death or severe personal injury may result if proper precautions are not taken.CAUTIONindicates that minor personal injury can result if proper precautions are not taken.NOTICEindicates that property damage can result if proper precautions are not taken.If more than one degree of danger is present,the warning notice representing the highest degree of danger will beused.A notice warning of injury to persons with a safety alert symbol may also include a warning relating to propertydamageThe product/system described in this documentation may be operated only by personnel qualified for the specifictaskin accordance with the relevant documentation,in particular its warning notices and safety instructions.Qualifiedpersonnel are those who,based on their training and experience,are capable of identifying risks and avoidingpotential hazards when working with these products/systems.Proper use of Siemens productsNote the following:WARNINGSiemens products may only be used for the applications described in the catalog and in the relevant technicaldocumentation.If products and components from other manufacturers are used,these must be recommended orapproved by Siemens.Proper transport,storage,installation,assembly,commissioning,operation andmaintenance are required to ensure that the products operate safely and without any problems.The permissibleambient conditions must be complied with.The information in the relevant documentation must be observed.TrademarksAll names identified by are registered trademarks of Siemens AG.The remaining trademarks in this publicationmay be trademarks whose use by third parties for their own purposes could violate the rights of the owner.Disclaimer of LiabilityWe have reviewed the contents of this publication to ensure consistency with the hardware and software described.Since variance cannot be precluded entirely,we cannot guarantee full consistency.However,the information inthis publication is reviewed regularly and any necessary corrections are included in subsequent editions.Copyright Siemens AG 2016.All rights reservedGERMANYTable of contentsVBS for Creating Procedures and Actions.11VBS for creating procedures and actions12Using Visual Basic Script in WinCC1213Modules and Procedures.....14Actions..1815Multiple Use of Procedures and Actions.16Use of CrossReference....2217Using Global Tags in VBS.241.8VBSCript Editors.VBScript Editors.261.8.2Global Script Editor......271.8.3Working in an Editing Window.1.8.4Working with the Toolbars......1.8.5Deleting Actions or Procedures.Creating and Editing Procedures.36191Creating and Editing Procedures.36Creating a New Procedure....39How to Write Procedure Codes....419.4Using Standard and Project Procedures441.9.5How to add module-related information451.9.6Protecting a Module with a Password.1.9.7Saving a Procedure...481.9.8Renaming a Procedure or Module.50Creating and Editing Actions.521101Creating and Editing Actions.52Creatina a New Action.....561.10.3How to Edit Actions........571104How to add action-related information1105Protecting an Action with a Password.62110.6Saving Actions.63110764110.71Triggers..641.10.7.2Animation trigger.........110.73How to add a trigger of the type"Timer'701.10.7.4How to add a trigger of the type "Tag"721.10.7.51.10.7.67☑How to delete a trigger.751.10.8How to Rename an Action.76How to activate global actions in Runtime781.1280WinCC:Scripting (VBS,ANSI-C.VBA)System Manual,02/20163Table of contents112.1Diagnostics.80112.2GSC Diaanostics.112.2.1GSC Diagnostics.1.12.2.2Inserting the GSC Diagnostics Window into a Picture.82112.2.3821.12.2.4GSC Diaanostics Toolbar.....83112.3GSC Runtime.84112.31GSC Runtime.112.3.2How to insert the GSC Runtime Window into a Picture.85112.3.386112.4Testing with the Debugger...87112.41Testing with the Debugger.87112.42How to Activate the Debugger.89112.4.3Principles of Debuaaina...901.12.4.4Structure of VBScript Files.112.4.5Action and Procedure Names in the Debugger941.12.4.6Selecting a Script for Editing......96112.4.7Processing Scripts Step-by-Step.971.12.4.8Setting Breakpoints.981.12.4.9Deleting Breakpoints....1.12.4.10How to Set Bookmarks in Scripts.1.12.4.11How to Determine and Modify Tag and Property Values....1.12.4.12101Executing Script Commands.........102113Printing VBScripts.1.14VBS Reference.…1051.14.1VBSReference105114.2Obiects and Lists.1071.14.2.1Objects and Lists.114.2.2Alarm obiect.....1.14.2.3114.2.4AlarmLogs Obiect.1121.14.2.5Dataltem Obiect..113114.2.6DataLogs Object...114114.2.7DataSet Obiect (List)116114.2.8HMIRuntime Object.118114.2.9114.2.10120114.2.11Layers Object (Listing)121114.212Logging Obiect.122114.2.13ProcessValue Obiect..123114.2.14ProcessValues Object (List)Project Obiect.1241.14.2.16Screenltem Obiect.114.2.17Screenltems Obiect (List)1291.14.2.181311.14.2.191.14.2.201.14.2.21Tag Object......1.14.2.22Tags Object (List).137.........................................................................481.14.2.23TagSet Object(List).1.14.3Object types of the Screenltem object.WinCC:Scripting (VBS,ANSI-C,VBA)System Manual,02/2016Table of contents114.3.1Obiect types of the Screenltem obiect.143114.3.2Standard obiects114.3.3114.3.4Windows obiects201114.3.5Tube obiects215114.3.6Controls.....218114.3.7Customized Obiect298114.3.8Group.3001.14.4Properties.301114.4.1Properties.....30302B321114.4.4362114.4.5397114.4.6407416114.4.8438L4421.14.4.104511.14.4.111.14.4.124881.14.4.135091.14.4.145121.14.4.15.5281.14.4.161.14.4.17R5471.14.4.18557114.4.195951.14.4.20671114.4.216801.14.4.22114.4.237021.14.5Methods.710114.51Methods......114.5.2Methods A to E114.5.3Get methods.7201.14.5.4Methods Hto M.114.5.5Methods N to R.114.5.6Methods S to T.797114.57Methods U to Z114.6Appendix820114.6.1Error Messages from Database Area115Examples of VBScript.8231.15.1115.2Examples in WinCC.8231.15.2.1Examples in WinCC....115.2.2Example:Accessing obiects in Graphics Designer824115.2.3Example:Defining the color of obiects...825115.2.4Example:How to Configure Language Changes.8251.15.2.5826115.2.6Example:Configuring change picture globally.826115.2.7Example:Configuring Change Picture Via PropertyWinCC:Scripting (VBS,ANSI-C.VBA)System Manual,02/2016Table of contents115.2.8Example:Configuring diagnostics output via Trace.827115.2.9Example:Writing tag values.............115.2.10Example:How to Read Tag values....8301.15.2.11Example:Writing Obiect Properties......115.2.12Example:How to Start an Action on the Server (Logging Obiect)8361.15.2.13Example:You connect or disconnect a database backup with VBS...8381.15.2.14Dynamization of Controls......841115.3General Examples.........115.31General examples for VBScript..........115.3.2Example:Configuring a Database Connection with VBS856115.3.3Example:Using the MS Automation interface...........858115.3.4Example:Starting an external application....859Basic Principles of VBScript..8611.16.1Basic Principles of VBScript.116.2VBScript Basics.....8612ANSI-C for Creating Functions and Actions......86321Creating Functions and Actions with ANSI-C.8632.2Creating Functions and Actions..2.3867Characteristics of Standard Functions.868Characteristics of Internal Functions.A.m.A.m.m.m..m.m.m.m.m.m.m.am.n.m.m.m.m.m.m.m.m.m.m.m.m8702.6Characteristics of Local Actions....27Characteristics of Global Actions.....How to Add Global Script Runtime to a Proiect's Startup List873Use of Global C-Tags......8742.10Use of DLLs in Functions and Actions.8762.11The Global Script Editor............2.11.1The Global Script Editor......8782.11.2Working in the Edit Window....8802.11.2.1Working in the Edit Window......................................................................8802.112.2Editing Functions with the Keyboard.2.11.2.3Editing Functions with the Mouse....8822.11.3Working with the Toolbars........8822.11.4How to Set Different Views..8852.11.5How to Set the Font Style.2.11.6How to Use "Save As..."How to Delete Actions or Project and Standard Functions.8872.11.8How to Generate a New Header.How to Compile All Functions8882.11.10How to Search in Files....2.11.11Printing_Functions and Actions......8902.11111Printing Functions and Actions......8902.11112How to Set the Print Parameters..8902.11.11.3How to Open Page View......8912.11.11.4How to Print the Proiect Documentation.891WinCC:Scripting (VBS,ANSI-C,VBA)System Manual,02/2016