c# pdf viewer component : Reorder pages in pdf file software SDK dll winforms windows wpf web forms WinCCInformationSystemScripting_en-US1-part1202

VBS for Creating Procedures and Actions
1
1.1
VBS for creating procedures and actions
Contents
WinCC provides the possibility of dynamizing the Runtime environment using the Visual Basic 
Script. It is possible to use VBS to program global actions and procedures as well as 
dynamizing graphic objects and triggering actions in Runtime.
This chapter will show you
● How to work with VBScript editors
● How to create and edit procedures
● How to create and edit actions
● How to activate VBScripts in Runtime
● How to execute diagnostics on scripts in Runtime
● The object model of graphic Runtime system
● Detailed examples on using VBScript
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
11
Reorder pages in pdf file - re-order PDF pages in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Customizing Page Order of PDF Document in C# Project
pdf move pages; how to move pages around in pdf file
Reorder pages in pdf file - VB.NET PDF Page Move Library: re-order PDF pages in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Sort PDF Document Pages Using VB.NET Demo Code
pdf reorder pages; rearrange pdf pages in reader
1.2
Using Visual Basic Script in WinCC
Introduction
In addition to the C script, WinCC also provides the VBScript program language as a 
programming interface in order to make the WinCC Runtime environment dynamic. 
Target Group of the Documentation
This documentation is aimed at project engineers with experience of Visual Basic or WinCC 
Scriptings (C) used to date.
Application Options
VBScript (VBS) provides access to tags and objects of the graphical Runtime system at 
Runtime and can execute picture-independent functions:
● Tags: Tag values can be read and written in order, for example, to specify tag values for 
the PLC by clicking the mouse when positioned on a button.
● Objects: Object properties can be made dynamic using actions and actions can be triggered 
by events influencing objects.
● Picture-independent Actions: Picture-independent actions can be triggered cyclically or 
according to tag values, e.g. for the daily transfer of values into an Excel table.
VBS can be used at the following points in WinCC: 
● In the Global Script Editor: This is used to configure picture-independent actions and 
procedures. The procedures can be used in picture-dependent and picture-independent 
actions. Several procedures are compiled in a topic-related module.
● In Graphics Designer: Picture-dependent actions can be configured with which the 
properties of graphic objects can be made dynamic or caused to respond to events in 
Runtime.
● In user-defined menus and toolbars: Here you configure procedures called in Runtime using 
the menu and toolbars.
Note
Updating Changed Configuration in Runtime
A changed VB script that is connected with "Menus and toolbars" is only updated after 
Runtime is restarted.
If you change the properties of "Menus and toolbars" in Runtime, the changes are only 
applied in the following cases:
● After a picture change, if the configuration change does not affect the basic picture.
● When you load another configuration file and reload the modified configuration file.
VBS for Creating Procedures and Actions
1.2 Using Visual Basic Script in WinCC
WinCC: Scripting (VBS, ANSI-C, VBA)
12
System Manual, 02/2013, A5E32315920-AA
C# TIFF: How to Reorder, Rearrange & Sort TIFF Pages Using C# Code
C# TIFF - Sort TIFF File Pages Order in C#.NET. Reorder, Rearrange and Sort TIFF Document Pages in C#.NET Application. C# TIFF Page Sorting Overview.
move pages in a pdf file; reorder pdf pages in preview
C# PDF Page Rotate Library: rotate PDF page permanently in C#.net
C# .NET, add new PDF page, delete certain PDF page, reorder existing PDF pages and split may choose to only rotate a single page of PDF file or all
change page order pdf acrobat; switch page order pdf
Registered Tags in Menus and Toolbars
The registered tags in the scripts of "Menus and toolbars" remain registered when you unselect 
the picture. If you read indirectly from a process mapping the tags are registered and 
unregistered again when you unselect the picture. However, registered tags in the scripts of 
"Menus and toolbars" remain registered when you unselect the picture.
Application Scenarios
VBS can be used in Runtime, for example:
● to configure setpoint value specification for tags for the operation of a graphic object in 
order to define a value for the PLC by clicking a mouse, for example.
● to configure switching the Runtime language for the operation of a graphic object.
● to configure the change of color, e.g. cyclically (flashing) or to display statuses (motor on).
Apart from the specific WinCC applications, the general functionality of VBS can also be used 
to customize the Windows environment, e.g.:
● to transfer data to another application (e.g. Excel).
● to start external applications from WinCC.
● to create files and folders.
The automation objects in your environment are available with which to customize the Windows 
environment.
Note
All the objects supplied with the Windows Script Host (WSH) from Microsoft can be integrated 
in the environment using the standard VBS method CreateObject. However, there is no direct 
access to the WSH object itself using VBS from WinCC.
There is no guarantee nor WinCC support for the VBS functionality with regard to its 
adaptation to the Windows environment. 
Limits to Other Programming Languages in WinCC
VBS and C
VBScript can be used in WinCC parallel to C-Script, but do not mix the script types:
● VBScripts and C-scripts can be configured within a picture and project.
● C-scripts cannot be invoked in VBScripts and vice versa.
● VBS provides internal interfaces to tags and picture objects while the C environment 
enables access to other WinCC subsystems (e.g. the report system).
VBS and VBA
VBA is used in WinCC Configuration during the configuration in order to adapt Graphics 
Designer to your individual requirements and to simplify and automate configuration. VBA 
programs only run in the WinCC configuration environment.
VBS for Creating Procedures and Actions
1.2 Using Visual Basic Script in WinCC
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
13
VB.NET PowerPoint: Sort and Reorder PowerPoint Slides by Using VB.
Sort and Reorder PowerPoint Slides Range with VB amount of robust PPT slides/pages editing methods powerful & profession imaging controls, PDF document, image
pdf reorder pages online; how to move pages in pdf converter professional
VB.NET TIFF: Modify TIFF File by Adding, Deleting & Sort TIFF
Users can use it to reorder TIFF pages in ''' &ltsummary> ''' Sort TIFF document pages in designed powerful & profession imaging controls, PDF document, image
reorder pages of pdf; reorder pdf page
As opposed to VBA, VB scripts only run in WinCC Runtime and, from there, enable access to 
graphic objects and tags. Objects and pictures can be neither created nor modified on a 
permanent basis in VBS, as opposed to VBA.
The main language-related differences between VBA and VBS are e.g.:
● VBS was developed for use in Internet, VBA for the automation of software applications.
● The data type of VBS tags is always VARIANT. VBA, on the other hand, differentiates the 
individual data types such as INT, DOUBLE, STRING, etc.
● Certain language constructs from VBA have been removed from or added to VBS.
● Errors are handled differently in VBS compared to VBA.
A complete list of the differences between VBA and VBS is provided in the Appendix in "Basic 
Principles of VBScript".
Procedures, Modules and Actions
VBS in WinCC allows the use of procedures, modules and actions to make the Runtime 
environment dynamic:
● Procedures: Codes are stored in procedures which are then used at several points in the 
configuration. Retrieve the code or another procedure in an action by invoking the 
procedure name. Procedures can be created in WinCC with or without return values. 
Procedures do not have their own trigger, they are always retrieved by an action.
● Modules: It is advantageous to compile related procedures to units in modules. Create 
modules for procedures, for example, which must be used in a specific picture or belong 
to a specific topic, such as auxiliary mathematical functions or database access functions.
● Actions: Actions are always activated by a trigger, namely a triggering event. Actions are 
configured in graphic object properties, in events which occur on a graphic object or globally 
in a project. Codes used several times can be called, in the form of procedures, in actions.
VBS for Creating Procedures and Actions
1.2 Using Visual Basic Script in WinCC
WinCC: Scripting (VBS, ANSI-C, VBA)
14
System Manual, 02/2013, A5E32315920-AA
C# PDF: C# Code to Process PDF Document Page Using C#.NET PDF
delete or remove certain page from PDF document file. C# PDF Page Processing: Sort PDF Pages - online C#.NET tutorial page for how to reorder, sort, reorganize
move pdf pages; how to move pages around in a pdf document
Read PDF in Web Image Viewer| Online Tutorials
for image viewing to read, edit, create or write PDF documents from file or stream in Extract images from PDF documents; Add, reorder pages in PDF
rearrange pdf pages in preview; how to move pages in pdf acrobat
1.3
Modules and Procedures
Introduction
Procedures are used to make code, created only once, available at several points in a project. 
Instead of entering the code several times, simply call in the corresponding procedure. The 
code is clearer and easier to maintain.
Related procedures should be stored in modules. When a certain procedure is retrieved via 
an action in Runtime, the module that contains that procedure is loaded. Observe the following 
when structuring the modules and procedures: 
● The more modules that must be loaded when a picture is called in, the worse the 
performance in Runtime.
● The larger a module, the more procedures are contained and, thus, the longer the loading 
time for the module.
Organize the modules sensibly, e.g. a module with procedures for a specific system part/
picture. 
Another type of structuring of procedures in modules is the functional structuring, e.g. a module 
containing mathematical functions. Use this structure, for example, for modules which should 
be used globally for projects. The following example illustrates a module containing 
mathematical functions derived from the standard functions:
VBS for Creating Procedures and Actions
1.3 Modules and Procedures
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
15
VB.NET TIFF: VB.NET Sample Code to Process & Manage TIFF Page
certain TIFF page, and sort & reorder TIFF pages in Process TIFF Pages Independently in VB.NET Code. powerful & profession imaging controls, PDF document, image
move pages in pdf online; how to rearrange pdf pages
C# Word: How to Create Word Document Viewer in C#.NET Imaging
in C#.NET; Offer mature Word file page manipulation functions (add, delete & reorder pages) in document viewer; Rich options to add
pdf rearrange pages online; reorder pages in pdf preview
Procedure Features
The procedures in WinCC have the following properties:
● They are created and modified by the user.
● They can be protected against modification and viewing by means of a password.
● They do not have a trigger.
● They are stored in a module.
WinCC does not provide predefined procedures, but does provide code templates and 
Intellisense, for example, to simplify programming. Procedures differ according to module 
assignment in:
● Standard procedures apply globally to projects located on the computer on which they were 
created.
● Project procedures can only be used within the project in which they were created.
VBS for Creating Procedures and Actions
1.3 Modules and Procedures
WinCC: Scripting (VBS, ANSI-C, VBA)
16
System Manual, 02/2013, A5E32315920-AA
Module Features
A module is a file in which one or procedures is stored. The modules in WinCC have the 
following properties:
● They can be protected against modification and viewing by means of a password.
● The have the file extension *.bmo.
Modules differ according to the validity of their procedures in:
● Standard Modules: Contain procedures which are globally available to the project. Standard 
modules are stored in the WinCC file system under: <WinCC-Installationsverzeichnis>
\ApLib\ScriptLibStd\<Modulname>.bmo
● Project Modules: Contain project-specific procedures. Project modules are stored in the 
WinCC file system under: <Projektverzeichnis>\ScriptLib\<Modulname>.bmo. Since the 
project modules are stored in the project directory, they are copied when the WinCC project 
is copied.
Note
If WinCC must be reinstalled and the standard procedures and modules need to be used 
again, save the module files prior to the reinstallation in a different directory and copy them 
in the relevant WinCC directory after the reinstallation has been completed. Otherwise, 
the standard modules in the WinCC installation directory are deleted during the installation 
routine.
Using Procedures and Modules
Procedures are used in:
● Actions (in Graphics Designer and Global Script)
● Other procedures (in Global Script)
● User-defined menus and toolbars
Procedures are structured in modules.
See also
Creating and Editing Procedures (Page 37)
VBScript Editors (Page 26)
Basic Principles of VBScript (Page 822)
Actions (Page 18)
Using Visual Basic Script in WinCC (Page 12)
VBS for Creating Procedures and Actions
1.3 Modules and Procedures
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
17
1.4
Actions
Introduction
An action is always started by a trigger. An action, for example, is triggered in Runtime when 
an object is operated by a mouse click, a certain time has occurred or a tag has been modified.
Action Features
Actions are defined once in Global Script and then available independent of the picture. Global 
Script actions are only valid in the project in which they were defined. Actions linked to a graphic 
object are only valid in the picture in which they were defined.
Note
VBS does not currently allow the creation of computer-specific actions. 
The following applies for clients in a multi-user system: All global actions configured on a 
server are also executed on a client when a project is opened. 
The following applies to clients in a distributed system: If actions should be used on a client 
computer, copy all the action files in the corresponding project directory on the client.
Actions have the following properties:
● Actions are created and modified by the user.
● Actions in Global Script can be protected against modification and viewing by means of a 
password.
● Actions have at least one trigger.
● Actions in Global Script have the file extension *.bac.
● Global Script actions are stored in the WinCC file system under: <Projektverzeichnis>
\ScriptAct\Aktionsname.bac
Action Trigger
Triggers are required to execute actions in Runtime. A trigger is linked to an action thus forming 
the triggering event which calls the action. Actions without triggers will not be carried out.
The following trigger types are available in WinCC:
● Timer: Acyclic or cyclic trigger, e.g. for calling a picture or every hour.
● Tags: Change of value
● Event: Modification of object properties (e.g. change of color) or event on an object (e.g. 
mouse click).
VBS for Creating Procedures and Actions
1.4 Actions
WinCC: Scripting (VBS, ANSI-C, VBA)
18
System Manual, 02/2013, A5E32315920-AA
Processing of Actions in Runtime
In Graphics Designer
Two actions of the same type can be executed simultaneously in Runtime. In order, for 
example, that cyclic actions are not hindered by an action executed by a mouse click, event 
triggered actions and cyclic/tag triggered actions in Graphics Designer are executed 
independently of each other.
Note
Please note that synchronization between both action types in WinCC may only be executed 
by the DataSet object or by internal WinCC tags. As a result of the separate processing, no 
common data area exists between event triggered and cyclic/tag triggered actions.
If processing cyclic actions in pictures, for example, is prevented by a high system load or 
another action, the action is started once at the next opportunity. Cycles which are not executed 
are not retained in a queue but rejected.
After a change of picture, scripts still running are automatically stopped 1 minute after the 
change of picture.
Scripts which are still running when Runtime is terminated are stopped after 5 seconds.
In Global Script
Picture-independent actions from Global Script are executed in Runtime in succession after 
being triggered. If an action is triggered while another action is in progress, the second action 
is retained in a queue until it can be executed.
Note
Please note that synchronization between actions in Global Script and in Graphics Designer 
may only be executed by the DataSet object or by internal WinCC tags. There is no common 
data area between the actions in Graphics Designer and in Global Script.
Using the Actions
Actions can be used as follows:
● In Global Script The global actions defined here run picture-independent in Runtime.  
● In Graphics Designer: The actions defined here only run in the configured picture. An action 
is configured in Graphics Designer on an object property or an event on a graphic object.
See also
Creating and Editing Actions (Page 53)
Basic Principles of VBScript (Page 822)
Modules and Procedures (Page 15)
Using Visual Basic Script in WinCC (Page 12)
VBS for Creating Procedures and Actions
1.4 Actions
WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 02/2013, A5E32315920-AA
19
1.5
Multiple Use of Procedures and Actions
Introduction
An action configured with VBS in WinCC is always valid for the project in which it was defined. 
Procedures have the following areas of application:
● Standard procedures apply globally to projects located on the computer on which they were 
created.
● Project procedures can only be used in the project in which they were created. If a project 
is copied, the project procedures (modules) are copied together with the project.
Multiple Use of Procedures and Actions
If actions or procedures/modules are to be used in other projects or on other computers, it is 
possible either to:
● use the "Save As" function to store the action or module in a different project directory or, 
for example, on a disk.
● to copy the action or module file in Windows Explorer and paste it in the corresponding 
project or standard directory on the target computer.
The properties and trigger configured are retained during copying. Copied modules are directly 
available in Runtime. Copied actions are executed in Runtime after they have been opened 
and stored once.
Note
Tags used in an action or procedure must also be available on the target computer. If the tag 
is not available, the action or procedure is not executed.
Procedures which are called in an action must be available on the target computer. If the 
procedure is not available, a Runtime error occurs during Runtime.
Storing Procedures
If procedures need to be copied in other project directories in order to be able to use then in 
other projects or different computers, observe the storage path of the procedures in the WinCC 
file system:
● Standard procedures: <WinCC-Installationsverzeichnis>\ApLib\ScriptLibStd
\Modulname.bmo
● Project procedures: <Projektverzeichnis>\ScriptLib\Modulname.bmo
Note
Since procedures are always stored in modules, always copy the module (*.bmo) in which 
the procedure is contained. 
VBS for Creating Procedures and Actions
1.5 Multiple Use of Procedures and Actions
WinCC: Scripting (VBS, ANSI-C, VBA)
20
System Manual, 02/2013, A5E32315920-AA
Documents you may be interested
Documents you may be interested