System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Editing function Mouse command (left mouse button)
Extended selection <SHIFT> + mouse-click
Set cursor Click
Move selected text Drag and drop
Duplicate selected text <CTRL>+drag and drop
Other editing functions:
● By double-clicking a compiler error message, the editor jumps to the corresponding line in
the code.
● Right-clicking calls up a shortcut menu.
With the following actions, the selected text is replaced by the result of the action:
● Input of character(s) through the keyboard
● Pasting of text from the clipboard
● Insertion of a function call by means of parameter assignment
2.11.3 Working with the Toolbars
Purpose
The toolbars are located in their default position below the menu bar, at the top of the Global
Script window. The toolbar buttons allow for fast and easy execution to a number of Global
Script functions.
There are two toolbars available:
The standard toolbar
The editing toolbar
Contents
The standard toolbar contains buttons for the following functions:
Button Function Key combination
Creates a new action. <ALT+A> or
<CTRL+N>
Creates a new standard function. <ALT+S> or
<CTRL+N>
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
781
Button Function Key combination
Creates a new project function. <ALT+P> or
<CTRL+N>
Creates a new header file. <CTRL+H>
Opens an existing action or function. <CTRL+O>
Saves the content of the active edit window. This function
is only available, if an edit window is open.
<CTRL+S>
Cuts the selected text and copies it to the clipboard. This
function is only available, if text has been selected.
<CTRL+X>
Copies the selected text to the clipboard. This function is
only available, if text has been selected.
<CTRL+C>
Pastes the contents of the clipboard at the location of the
cursor. This function is only available, if the clipboard is
not empty.
<CTRL+V>
Undoes the last maximum 30 editor actions. This function
is only available, if an editor action has been performed.
<CTRL+Z>
Redoes the last editor action that was undone. This
function is only available, if an editor action has been
undone.
<CTRL+A>
Prints the contents of the active edit window as project
documentation. This function is only available, if an edit
window is open.
<CTRL+P>
Activates the direct help (What's this?). <SHIFT+F1>
Generates a new header. <CTRL+G>
Allows you to set the font. <CTRL+F>
Note
The key combination <CTRL+N> is only available, if at least one edit window is open. If the
active edit window contains a function and <CTRL+N> is pressed, a new project function is
created. If the active edit window contains an action, this key combination creates a new
global action.
The editing toolbar contains buttons for the following functions:
Button Function Key combination
Enables you to add information about functions and, in the
case of an action, to setup a trigger. This function is only
available, if an edit window is open.
<CTRL+I>
Compiles the code in the active edit window. This function
is only available, if an edit window is open.
<SHIFT+F8>
Opens the tag dialog. This function is only available, if an
edit window is open.
<CTRL+R>
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
782
System Manual, 11/2008,
Button Function Key combination
Opens a dialog for the selection of a picture. The name of
the
selected picture is inserted at the position of the cursor
in the edit window. This function is only available, if an edit
window is open.
<CTRL+W>
Imports an action. This function is only available, if there
is an action in the active window.
<CTRL+M>
Exports the action from the active edit window. This
function
is only available, if there is an action in the active
window.
<CTRL+T>
Properties
Both toolbars can be shown or hidden.
They can be pinned below the menu bar.
When they are not pinned down, they can be dragged with the mouse to any position on the
screen.
See also
How to Set Different Views (Page 783)
2.11.4 How to Set Different Views
Introduction
In this context, views are considered to be different combinations of elements visible in the
Global
Script editor, such as the output window, status bar and toolbars. These elements can
be individually displayed or hidden.
By default, all elements are visible.
Procedure
1. Opens the "View" menu in the Global Script menu bar.
2. Activate or deactivate the display of the desired elements e.g. the toolbars. If "show" is
chosen, a check mark is displayed in front of the name.
Note
When Global Script restarted, the editor reverts to the default settings and all elements are
again visible.
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
783
2.11.5 How to Set the Font Style
Introduction
The font style is composed of the settings "Font", "Style" and "Size".
The style selected is active in all edit windows.
Procedure
1.
Click the button in the standard toolbar to open the dialog for setting the font style.
2. Make the desired settings.
3. Confirm your settings by clicking "OK".
Alternative procedure
You can also open the dialog for the font style settings in the following manner:
Select the "Options" menu in the Global Scripts menu bar and select "Font", or use the
corresponding key combination.
Note
The settings are automatically saved and are not reset when WinCC is restarted.
2.11.6 How to Use "Save As..."
Introduction
If a function or action is created, Global Script saves the corresponding file in a predefined
path with a default file name, e.g. "new_function_1.fct" for functions and "gsccs1.pas" for
actions. Since these default file names are not particularly useful, use "Save As ..." to save
the
function or action under a different - more meaningful - file name. The file with the default
file name is retained.
With "Save As ...", only the file name is changed, the function or action name remains
unchanged.
Global Script expects that the function or action is saved in a project directory. If this is not
the case, a message is displayed, but the file is saved nonetheless.
Requirement
"Save As..." is only available, if at least one edit window is open. It saves the content of the
active edit window.
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
784
System Manual, 11/2008,
Procedure
1. In the Global Script menu bar, open the "File" menu.
2. Select "Save As...".
3. Enter the new file name.
4. Close the dialog by clicking the "Save" button.
See also
How to Delete Actions or Project and Standard Functions (Page 785)
2.11.7 How to Delete Actions or Project and Standard Functions
Introduction
Actions or project and standard functions can be deleted during configuration or in Runtime.
Global Script deletes the entry in the navigation window as well as the associated file.
If a deleted function is called by an action, the action is terminated upon calling the function.
If a Global Script diagnostic window is open at this time, a message is displayed. The
termination
of the action is logged in the "WinCC_Sys_xx.log" diagnostic file (xx = consecutive
number). This diagnostic file is located in the "Diagnostics" subdirectory of the WinCC
installation directory.
Procedure
1. In the Global Script navigation window, call up the shortcut menu for the function or action
to be deleted.
2. Select "Delete".
3. Confirm the command by clicking "Yes".
Alternative operation
Instead of using the shortcut menu, you can also delete the selected function or action by using
the <DELETE> key.
Note
If a function is deleted, the entry in the respective header file is deleted as well.
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
785
2.11.8 How to Generate a New Header
Introduction
The header must be generated again in the following cases:
● After you have copied project functions from a different project to the "library" directory in
your project path.
● After you have copied standard functions from another PC to the "aplib" directory (or
subdirectory).
When the header is generated again, the functions that have been copied are entered into the
corresponding header files and are then available to you to use in your project.
Requirement
This function is only available, if all edit windows are closed.
Procedure
1.
Click the button in the standard toolbar.
Alternative operation
Alternatively, you can start a generation process as follows:
Open the "Options" menu and select "Regenerate Header" or use the corresponding key
combination.
Note
Once the regeneration is finished, the contents of the navigation window are updated.
If WinCC is in Runtime, the Runtime system is not influenced by the regeneration of the
header.
2.11.9 How to Compile All Functions
Introduction
After all manual changes have been made to the header files, all functions must be recompiled.
All project, standard and internal functions are compiled automatically.
The results of the individual compilations are displayed in the output window as follows:
If necessary, the compiler outputs warnings and error messages for each compiled function.
In the next line, the path and file name of the compiled function as well as the summary
message from the compiler are displayed.
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
786
System Manual, 11/2008,
If functions are called in other functions, errors might occur and error messages might be
displayed. The reason for this is that the called functions have not yet been compiled. These
functions must then be compiled individually.
Requirement
This function is only available, if all edit windows are closed.
Procedure
1. Open the "Options" menu.
2. Select "Compile All Functions".
Alternative operation
You can compile all functions using the key combination <ALT+U>.
Note
In a multi-user project, the "Compile All Functions" function is not available. The reason for
this is that it is no longer possible to allocate the functions in such projects.
2.11.10 How to Search in Files
Introduction
All files of the group selected in the navigation window are searched for the specified search
term.
The result of the search is displayed in the output window as follows:
For each found search term, a line is displayed in the output window. This line contains the
line number of the line in the code in which the search term was found, plus the path and file
name as well as the line of code itself.
Standard and project functions as well as actions can be opened by double-clicking the search
results.
The cursor is positioned at the start of the line in which the search term was found. In
the case of internal functions, the function containing the search term is shown in the navigation
window and selected.
Procedure
1. Open the shortcut menu for the group to be searched in the Global Script navigation window.
2. Select "Find in Files".
3. In the dialog, enter the search term to be found.
4. Click "Find" to start the search. The result of the search is displayed in the output window.
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
787
2.11.11 Printing Functions and Actions
2.11.11.1 Printing Functions and Actions
Introduction
Actions or project or standard functions can be printed using specified system layouts.
This is however only possible, if the function or action to be printed is displayed in the edit
window. The content of the active edit window is printed.
The printout can be examined on the screen in page view.
The printing process can be controlled by a number of print parameters.
The following system layouts are used:
● @gsc_pfc.rpl for project functions
● @gsc_sfc.rpl for standard functions
● @gsc_act.rpl for actions
See also
How to Print the Project Documentation (Page 789)
How to Open Page View (Page 789)
How to Set the Print Parameters (Page 788)
2.11.11.2 How to Set the Print Parameters
Introduction
You can modify the printout as follows:
● By specifying a layout that differs from the standard layout
● By selecting a page range
● By selecting a printer selection
● By printing to file
Requirement
At least one edit window must be open.
Procedure
1. In the Global Script menu bar, open the "File" menu.
2. Select "Project Documentation Setup..."
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
788
System Manual, 11/2008,
3. In the subsequent dialog, adjust the desired settings.
4. Apply the settings by clicking "OK".
Note
The settings are automatically saved and are not reset when WinCC is restarted.
2.11.11.3 How to Open Page View
Introduction
Before you begin printing a function or action, it is sometimes an advantage to first see a
preview of the printout on the screen (in page view).
The content of the active edit window is displayed in page view.
Procedure
1. In the Global Script menu bar, open the "File" menu.
2. Select "Project Documentation Setup...".
2.11.11.4 How to Print the Project Documentation
Introduction
You can output the contents of the active edit window to a printer or to a file. The selected print
parameter settings are applied.
Procedure
1. In the Global Script menu bar, open the "File" menu.
2. Select "Print Project Documentation".
ANSI-C for Creating Functions and Actions
2.11 The Global Script Editor
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
789
2.12 Creating and Editing Functions
2.12.1 Creating and Editing Functions
Introduction
The system distinguishes between project, standard and internal functions. WinCC is delivered
with a broad selection of standard and internal functions. Furthermore, you can create your
own
project and standard functions or modify standard functions. Please remember, however,
that the standard functions included with WinCC are overwritten when WinCC is reinstalled so
any modifications are lost.
Internal functions cannot be created or edited.
Using Functions
If the same calculation must be performed - with different starting values - in several actions,
it would be to your advantage to program a function to perform this calculation. Subsequently
you can simply call this function with the current parameters in the actions.
This approach has a number of 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 clearer.
ANSI-C for Creating Functions and Actions
2.12 Creating and Editing Functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
790
System Manual, 11/2008,