System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)

Подождите немного. Документ загружается.

Menu bar (1) and toolbars (2)

All the commands required to create procedures and actions are provided in the menu bar and

toolbars.

The toolbars can be displayed and hidden using the "View" > "Toolbars" command and can

be moved to any position within the editor.

Navigation window (3)

In the navigation window you manage your procedures, modules and actions. In addition you

can

find here code templates which you can insert by drag&drop into your action or procedure.

A procedure can be called in another procedure or action by dragging them from the navigation

window and dropping them at the relevant point in the code.

The display in the navigation window is always updated during the saving of the edited

document. If you change a file, this will be displayed by a * behind the file name.

The procedures contained in a module are displayed in the navigation window underneath the

module file. The Actions tab control also displays the trigger and procedures configured for an

action, if necessary those directly defined in an action module.

The navigation window can still be used to:

● Create subdirectories for structuring the scripts.

● Move, copy, paste, delete and rename modules and directories directly.

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

The display in the navigation window can be individually configured with the "View" >

"Workplace"

menu commands. It is possible to select whether all file types, only script files or

only syntactically correct files should be displayed. The navigation window can be shown or

hidden with the "View" > "Workplace" > "Display" menu commands.

Editing window (4)

You write and edit your actions in the editing window. Each procedures or action will be opened

in its own editing window. Several editing windows can be open at the same time.

The user is supported by in the editing window by Highlight Syntax and Intellisense. All general

editor functions (e.g. Undo/Redo, Find/Replace, Copy, Paste, Cut, Font Settings, Printer

Settings) remain available.

Output window (5)

Error messages are displayed in the output window following the syntax check. Double click

on the corresponding error line to access the related point in the code.

Status bar (6)

The status bar contains information on the currently selected functionality or hints on

programming.

Note

If information on individual editor commands or icons is required, select the "?" menu icon.

> "What's This?". Then click the mouse button on the corresponding icon/command. This

provides fast, direct help on all the operating elements in the editors. Press "ESC" to exit

"What's This?" help mode.

See also

Deleting Actions or Procedures (Page 38)

Working with the Toolbars (Page 36)

Working in an Editing Window (Page 32)

1.8.3 Working in an Editing Window

Introduction

Procedures and actions are edited in the editing window.

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Declaration Areas in Actions (Graphics Designer only)

If you create actions in the Action Editor of Graphics Designer, you can display the declaration

area of the action in the editing window using the button .

The declaration area can also be used to make general settings to be used globally for the

current picture, e.g.:

● Tag Definitions

● Procedures which you only want to use in this picture

Note

Do not create any directly executable codes in the declaration area!

Please note that when creating a tag, it must not contain a value (Value = VT_EMPTY).

Initialize the tags after declaration with the corresponding value.

When making definitions in the declaration area, pay attention to the structure of the Script

files, as described under "Structure of VBScript files".

"Option explicit" in Actions

When creating a new action, the "Option explicit" instruction is automatically set and cannot

be deleted in the declaration area (Graphics Designer) or entered in the first line of an action

(Global Script). The instruction is necessary as it prevents errors caused by the incorrect

notation of tags without declaration. The instruction requires that tags are always defined in

your code with the "Dim" instruction.

Note

Do not use the "Option explicit" instruction in the code because it may cause Runtime errors.

User Support in the Editing Window

The following functions are available to support working in the editing window.

Color coding and indentation in the editing window

Certain parts of the code have the following default colors:

Color Description Example:

blue Key words

Functions

Sub, End Sub, Next

green Comments ' is a comment

red Strings (character strings and

digits)

"Object1"

dark blue Preprocessor statements --

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Color Description Example:

bold black Constants

vbTrue, vbFalse

black Other codes --

The color coding in the editing window can be customized by means of the editor settings.

Select

the "Tools" > "Options" menu commands and the "Script Editor Options" dialog to define

the settings.

In order to organize the codes clearly, they can be structured by indentations. The "Script Editor

Options" dialog can also be used to define the tabulator distance and Automatic Indent while

writing.

Intellisense and Highlight Syntax

During text entry, context-sensitive lists appear containing the properties, methods, and objects

possible at the current code position. If you insert an element from the list, the required syntax

is also indicated automatically.

Note

Full intellisense for all objects can only be utilized in the Graphics Designer if the list is

accessed

using the object name and the result is assigned to a tag. Otherwise, only a list of

standard properties is offered.

Example of full intellisense:

Dim Tag

Set Variable = ScreenItems ("Kreis1")

Tag.

If picture window limits are exceeded during addressing, it is once again only the standard

properties which are offered since the picture of the picture window is not loaded.

Highlight Syntax can be activated and deactivated in the "Script Editor Options" dialog. The

dialog can be called in using the "Tools" > "Options" menu commands.

General VBS Functions

Use the "Function List" context menu command in the editing window to display a list of general

VBS functions.

Lists of Objects, Properties and Methods

Using the context menu in the editing window you can view a list of the possible objects by

calling the "Object List" command in Graphics Designer. Global Script only provides the

HMIRuntime object in this list because there is no direct access to the objects of Graphics

Designer.

Use the "Properties/Methods" context menu command to call in a list of possible properties

and methods.

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

The same lists can be called in with the key combination <CTRL + SPACEBAR> but according

to the context of the script.

Code Templates

In the Code templates tab in the Navigation window of the Editor, you will find a selection of

frequently

used instructions, e.g. for loops and conditional instructions. The templates can be

inserted in the procedure codes by means of drag&drop.

If you insert a code template into your code, it is important to note that, for example, conditions

in the templates are identified by "_XYZ_". You must replace these placeholders with the

appropriate information.

Selection Dialogs

If WinCC tags or objects are used in the code, the following selection dialogs are available for

use:

●

Opens a tag selection dialog returns the selected tag name as the return value.

●

Opens a tag selection dialog and returns the tag name with an associated reference.

●

Opens a picture/object browser in which a picture/object can be selected whose name

is then used for the return value.

● Opens a picture selection dialog for pictures and returns the picture name, with the server

prefix if necessary.

Bookmarks

Bookmarks can be set in the code via the icons in the toolbar in order to find certain parts in

the codes more easily.

●

Sets a bookmark in the line where the cursor is currently located.

●

Deletes all bookmarks in the active editing window.

●

Jumps ahead to the next bookmark in the code.

●

Jumps back to the last bookmark in the code.

See also

Structure of VBScript Files (Page 97)

Global Script Editor (Page 30)

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

1.8.4 Working with the Toolbars

Purpose

In their default position, the toolbars are located below the menu bar, at the top of the VBS

editor. The buttons arranged on the toolbars enable quick, easy access to the functions

provided in Global Script and the action editor in Graphics Designer.

Global Script/Graphics Designer provide the following toolbars:

"Standard" Toolbar

Button Function Key combination

Creates a new project module (Global Script only) <ALT+F1>

Creates a new standard module (Global Script only) <ALT+F2>

Creates a new global action (Global Script only) <ALT+F3>

Opens an existing action or existing module (Global Script

only)

<CTRL+O>

Saves the content of the active editing window. This function

is only available, when an editing window is open. After

saving the display in the navigation window is refreshed.

(Global Script only)

<CTRL+S>

Cuts the selected text and copies it to the clipboard. This

function is only available, when text is selected.

<CTRL+X>

Copies the selected text to the clipboard. This function is only

available, when text is selected.

<CTRL+C>

Pastes the contents of the clipboard at the location of the

cursor. This function is only available, when the clipboard is

not empty.

<CTRL+V>

Prints the contents of the active editing window as project

documentation. This function is only available, when an

editing window is open.

<CTRL+P>

"Editor" Toolbar Content

Button Function Key combination

Indents the line, in which the cursor is located, one position

to the right.

Indents the line, in which the cursor is located, one position

to the left.

Marks the lines selected by the mouse as comments. If no

lines

have been selected by the mouse, the line in which the

cursor is located is marked as a comment.

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Button Function Key combination

Removes the comment marking from the lines selected by

the

mouse. If no lines have been selected by the mouse, the

comment marking in the line in which the cursor is located is

removed.

Sets a bookmarks in the current line. Actuating again

removed the bookmark from the current line.

<CTRL+F9>

Removes all bookmarks from the current code in the editing

window.

<CTRL+SHIFT+F9>

Moves the cursor one bookmark further. <F9>

Moves the cursor one bookmark back. <SHIFT+F9>

Opens the "Find" dialog for text search in the code. <CTRL+F>

Opens the "Replace" dialog for search and replace in the

code.

<CTRL+H>

Repeats the search process. <F3>

Opens the "Script editor options" dialog. --

Undoes the last of a maximum of 30 editor actions. This

function is only available, when an editor action has been

executed.

<CTRL+Z>

Redoes the last editor action that was undone. This function

is only available, when an editor action has been undone.

<CTRL+Y>

Content of the "Edit" Toolbar

Button Function Key combination

Workplace

Selects the file in the navigation window to which

the

current editing window belongs (Global Script

only).

Displays all the files in the navigation window

(Global Script only).

Only displays the Script files in the navigation

window (Global Script only).

Only displays the syntactically correct files in the

navigation window (Global Script only).

Script

Executes a Syntax Check in the code of the

current editing window.

<F7>

WinCC Objects

Opens the "Info/Trigger" dialog. <CTRL+T>

Displays the trigger name.

Opens a tag selection dialog returns the selected

tag name as the return value.

<CTRL+U>

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

Button Function Key combination

Opens a tag selection dialog and returns the tag

name with an associated reference.

<CTRL+W>

Opens a picture/object browser in which a picture/

object can be selected whose name is then used

for the return value.

<CTRL+Q>

Opens a picture selection dialog for pictures and

returns

the picture name, with the server prefix if

necessary.

<CTRL+B>

Additional Buttons in Graphics Designer

In addition to the buttons provided by Global Script, the action editor in Graphics Designer also

has the following buttons:

●

Displaying the declaration area (<CTRL+E>)

●

Hiding the declaration area (<CTRL+A>)

See also

Global Script Editor (Page 30)

1.8.5 Deleting Actions or Procedures

Introduction

If an action, procedure or a module is deleted in a script editor, the code and corresponding

file are deleted in the project directory.

Be careful only to delete procedures which are no longer used in other procedures or actions.

If an action attempts to call in a procedure which no longer exists, the action is stopped in

Runtime at the fault point. A non-existing reference in the code is not detected by the syntax

check.

Note

Procedures can only be deleted within a module by deleting the code, not in the editor's

navigation window.

Procedure

1. Open Global Script.

2. Select the action or module to be deleted in the navigation window.

VBS for Creating Procedures and Actions

1.8 VBScript Editors

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

3. Select the "Delete" command from the context menu.

4. To delete a procedure: Open the relevant module and delete the corresponding code in

the editing window.

See also

Actions (Page 21)

Modules and Procedures (Page 18)

Global Script Editor (Page 30)

1.9 Creating and Editing Procedures

1.9.1 Creating and Editing Procedures

Introduction

Projects and standard procedures can be programmed in WinCC using VBS:

● Project procedures can only be retrieved in the current project. Since procedures are stored

in the project directory, they are automatically copied when a project is copied.

● Standard procedures can be called in by all computers linked to a project. When a project

is copied onto another computer, the standard procedures must be copied into the

corresponding directory on the target computer manually.

The copied procedures are directly available for use in Runtime. The become visible in the

editor when the view is updated.

Apart from the procedures programmed by yourself, general VBS functions can also be used

(e.g. Abs, Array,... Year). These general VBS functions can be invoked in the code using the

"Function List" command from the context menu.

In addition, WinCC provides the most popular instructions as code templates (e.g. If...Then,

When...While). The code templates can be moved from the navigation window's Code

Templates tab control directly into your code via drag&drop.

If you insert a code template into your code, it is important to note that, for example, conditions

in the templates are identified by "_XYZ_". You must replace these placeholders with the

appropriate information.

Using Procedures

Procedures are used for the central creation and maintenance of codes which are to be

implemented

at several point in the configuration. Codes are written and saved in a procedure

and the procedure is called in with the current parameters in actions or other procedures

instead of repeatedly entering the same code.

Procedures are created for repeated functionalities, e.g.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,

● Calculations with different starting values (procedure with return value)

● Checking tag values (procedure with return value)

● Executing tasks (procedure with return value)

This is linked to the following advantages:

● The code is only programmed once.

● Modifications are only made at one point, namely in the procedure, not in each action.

● The action code is shorter and, thus, remains clearer.

Related procedures should be stored in modules in WinCC.

Procedures are loaded in Runtime when the calling action is executed.

If a procedure (module) used in a picture is modified, the modification is applied the next time

the

picture is loaded. This means that a picture currently displayed only works with the modified

procedure after the picture has been reloaded.

If you change a standard procedure into a project procedure, and vice versa, you must save

the pictures again which use this procedure.

VBS for Creating Procedures and Actions

1.9 Creating and Editing Procedures

MDM - WinCC: Scripting (VBS, ANSI-C, VBA)

System Manual, 11/2008,