WinCC V4. Manual Part 2/3 C79000-G8276-C107-01

Transcription

1 WinCC V4 Manual Part 2/3 Edition August 1997

2 WinCC, SIMATIC, SINEC, STEP are Siemens registered trademarks. All other product and system names in this manual are (registered) trademarks of their respective owners and must be treated accordingly. (The reproduction, transmission or use of this document or its contents is not permitted without express written authority. Offenders will be liable for damages. All rights, including rights created by patent grant or registration of a utility model or design, are reserved.) (We have checked the contents of this manual for agreement with the hardware and software described. Since deviations cannot be precluded entirely, we cannot guarantee full agreement. However, the data in this manual are reviewed regularly and any necessary corrections included in subsequent editions. Suggestions for improvement are welcomed.) Siemens AG All rights reserved Technical data subject to change Printed in the Federal Republic of Germany Siemens Aktiengesellschaft

3 08.97 Graphics Designer Table of Contents / Graphics Designer 1 Functionality Structure Color Palette Assigning a Standard Color Assigning a User-Defined Color Object Palette Drawing an Object Selecting an Object Changing Object Properties Moving an Object with the Mouse Sizing an Object with the Mouse Changing the Start Angle/End Angle with the Mouse Style Palette Changing the Line Style Changing the Line Weight Changing the Line End Styles Changing the Fill Pattern Alignment Palette Aligning Objects Zoom Palette Menu Bar File Menu Edit Menu View Menu Insert Align Options Menu Window Menu Help Menu Standard Toolbar Font Palette Changing the Font Changing the Font Size Changing the Font Color Changing the Line Color Status Bar Layer Bar WinCC Manual i

4 Graphics Designer Object Properties Display Object Properties Pin Pipettes for Transferring Object Properties Object List "Properties" Tab "Event" Tab Setting Dynamics with a Direct Connection Constants as Source of a Direct Connection Object Properties as Source of Direct Connections Tags as Source of Direct Connections Configuring Actions Introduction Linking Actions with Graphic Objects Making Object Properties Dynamic Setting Dynamics Using the Dynamics Dialog Adding Dynamics with the Dynamic-Wizard System Functions Miscellaneous Functions Standard Dynamics Import Functions Picture Functions User Archive Functions Example of a configured Dynamic Setting Dynamics with a C Action Setting Dynamics with a Tag Value Reacting to Events Appendix Object types and their properties Line Properties Polygon Properties Polyline Properties Ellipse Properties Circle Properties Ellipse Segment Properties Pie Segment Properties Ellipse Arc Properties Circular Arc Properties Rectangle Properties Rounded Rectangle Properties Static Text Properties Application Window Properties Picture Window Properties ii WinCC Manual

5 08.97 Graphics Designer OLE Control Properties OLE Object Properties I/O Field Properties Bar Properties Graphic Object (External Format) Properties Status Display Properties Text List Properties Button Properties Check Box Properties Option Group Properties Round Button Properties Slider Properties Group Properties Picture Properties Attributes in Alphabetical Order Output formats for I/O-Fields Assignments for Text Lists WinCC Manual iii

6 Graphics Designer iv WinCC Manual

7 08.97 Graphics Designer Preface Purpose of the Manual This manual introduces you to the functions of each software component and their operation in a reference manual format. You can find the information you need quickly by using the table of contents or the index. Naturally, the information is also available to you in the on-line help in either a context-sensitive fashion or in the on-line help contents. Total Overview and Configuration Example The "Getting Started" manual, which is part of the WinCC package, contains a total overview of WinCC and a configuration example in which the most significant functions of the individual components are followed through in a practical application. Additional Support If you have technical questions, please address them to your Siemens contact partner, located in the businesses responsible for your location. You can find the addresses in the attachment entitled Siemens Worldwide, in "S7-300 Automation System Structure in an S7-300," in catalogs, and on CompuServe (go.autforum). In addition, you may call our Hotline at (Fax 7001). You can find additional information on the Internet under the address Information about SIMATIC products Up to date information about SIMATIC products can be obtained: * from the Internet under * via fax# In addition, the SIMATIC Customer Support provides current information and downloads that can be beneficial for the utilization of SIMATIC products: * from the Internet under * via the SIMATIC Customer Support Mailbox under phone# +49 (911) * To address the mailbox, use a modem with up to V.34 (28.8 kbaud), which parameters must be set as follows: 8, N, 1, ANSI, or dial up through ISDN (x.75, 64 kbit). The SIMATIC Customer Support can be reached by phone under the number +49 (911) and by fax under the number +49 (911) Inquiries can also be made via Internet mail or mail addressed to the above mailbox. WinCC Manual v

8 Graphics Designer vi WinCC Manual

9 08.97 Graphics Designer 1 Functionality Graphics Designer is used to create process pictures. It offers the following features: Easy to use, simple interface with tool and graphic palettes Streamlined configuration with integrated object and icon libraries Open interfaces for importing graphics and supporting the OLE 2.0 interface Configurable dynamic behavior of picture objects with support from an assistant (Dynamic Wizard) Links to additional functions by means of powerful script configuration Links to graphic objects that you can create yourself 32-bit application, capable of running under Windows 95 and Windows NT WinCC Manual 1-1

10 Graphics Designer WinCC Manual

11 08.97 Graphics Designer 2 Structure Graphics Designer contains the following items: Palettes for creating and editing graphic objects: - Color Palette - Object Palette - Style Palette - Alignment Palette - Zoom Palette - Font Palette Palettes and bars for operating the Graphics Designer: - Menu Bar - Standard Palette - Status Bar - Layer Bar A dialog window for setting and changing object properties: - Object Properties Tips & Tricks When you start Graphics Designer, the "Tips & Tricks" window appears. Click on the "Help" button to see notes about configuration. Note: If you deselect the "Show tips at startup" check box, the system will not display the window any longer. You cannot undo this selection. Context Sensitive Help By switching the context sensitive help on, you receive help text about palettes, menu commands, and buttons. It also assists you in finding additional information in on-line help. WinCC Manual 2-1

12 Graphics Designer How to Get Information About the Palettes, Menu Commands, and Buttons: 1. In the Graphics Designer toolbar, click on the "Help" button. A question mark appears on the mouse pointer. 2. Click on the palette, menu command, or button about which you want information. Changing the Palette Size In order to have a better overview of the entries in the palettes, especially those in the object and style palettes, you can change the size of the palettes. How to Change the Size of the Palettes: 1. Click on the palette border, hold down the left mouse button, and drag the palette into the workspace. 2. Drag the palette to the desired size as you do with other Windows objects. 3. While holding down the left mouse button, move the palette to wherever you want it on the screen. 2.1 Color Palette Through the color palette, you can assign one of the 16 standard colors, a basic color, or a color you define yourself to the selected objects by using the mouse. For example, a mouse click within the color palette changes any of the following colors: The fill color for area objects (for example, rectangles) The line color for line objects (for example, polylines) The background color for text objects Note: The color palette can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu Assigning a Standard Color How to Assign a Standard Color to an Object: 1. Click on the object. 2. Click on one of the 16 standard colors in the color palette. 2-2 WinCC Manual

13 08.97 Graphics Designer Assigning a User-Defined Color How to Assign a User-Defined Color to an Object: 1. Click on the object. 2. Click on the icon in the color palette. 3. Click on the color you want in the "Basic Colors" or the user-defined colors. or Click on the "Define Color >>" button to create another color combination. 2.2 Object Palette Using the object palette, select an object which will be created in the first visible layer of the graphics workspace. Layer 0 is assigned to this purpose in Graphics Designer. The objects available are arranged by the following subject areas: Standard Objects which include polygon, ellipse, and rectangle Smart Objects which include OLE control, OLE object, bar, and I/O field Windows Objects which include Button and Check Box Notes: You can also access the object palette using only the keyboard by pressing "Alt + O" and then using the arrow keys. You can place the object palette anywhere in the workspace or anchor it to a border. The object palette can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu. WinCC Manual 2-3

14 Graphics Designer Standard Objects Line Polygon Polyline Ellipse Circle Ellipse Segment Pie Segment Ellipse Arc Circular Arc Rectangle Rounded Rectangle Graphic Objects are used primarily to draw system pictures. The look of the objects can by changed at run time by making them dynamic (for example, by linking them to the process). Static Text Static Text is implemented to represent text. Static means that the text is within a text object (no dynamic reference). You can change the look, location, and contents of the text box during run time. If a static text is to extend for multiple lines, a line return can be inserted via the key combinations <Shift Return> or <Ctrl m>. Smart Objects Application Window Application Windows are objects managed by the message system (Alarm Logging), the archive system (Tag Logging), the report system (Print Jobs), and also by applications (Global Scripts). In Graphics Designer, the outside properties (position, size, and other attributes) are configured and transferred to the application at run time. The application opens the application window and manages it for display and operation. 2-4 WinCC Manual

15 08.97 Graphics Designer Picture Window Picture Windows are objects that accept pictures created with the Graphics Designer. They are configured according to position, size, and their other dynamic properties. For example, one important property is a reference to the picture (picture name) to be displayed in the picture window. By changing the "Picture Name" attribute dynamically at run time, the contents of the window can be changed dynamically. OLE Control Use an OLE Control to implement Windows elements (like a button or a selection box). An OLE control has attributes which are displayed in the "Object Properties" window "Event" tab and can be edited there. OLE Object Graphics Designer offers the opportunity to insert OLE Objects in a graphic. In the CONFIGURATION mode, you can edit a few objects with the appropriate OLE application by double clicking; others are activated by double clicking. After you have made changes to a linked OLE object in an attached object box, you must update the link manually in order to display the changes. You cannot edit in the RUNTIME mode. I/O Field You can use the I/O Field as an input field, an output field, or a combined I/O field. The binary, hexadecimal, decimal, or string data formats are possible. You can also specify limit values, hidden input, or acceptance on full. Bar The Bar is assigned to the Smart Objects group. Its properties (attributes) influence its appearance and functionality. It displays values graphically relative to a high and a low limit, either as a purely graphic overview or as a combined representation of the values with a scale that you can define. Graphic Object (External Format) Use the Graphic Object (External Format) to accept a picture that was created in an external graphic format into a Graphics Designer picture. WinCC Manual 2-5

16 Graphics Designer Status Display Use the Status Display to display any number of different states of an object. You can make the display dynamic by connecting it to a tag whose value corresponds to the status. You can assign any number from 0 to (bit combination). The states can accommodate gaps (1, 2, 5, 6, etc.). It is possible to have states without assigned pictures, which can, if necessary, be removed with the Clear List command. Text List Use the text list to assign text to values. It can be used as an input list (text input --> value output), output list (value input --> text output), or combined text list. The decimal, binary, or bit data formats are possible. The "decimal" list type displays the text assigned to the output value. When you enter a text, the assigned value is transferred as an input value to the data manager. If a value range is assigned to the text, the bottom range limit is transferred. This also applies to "top open" value ranges (for example, >=100). With "bottom open" value ranges (for example, <=0), the top range limit is transferred. The "binary" list type displays a text that is assigned to a bit of the output value if that bit is set. In this case, only one bit may be set in the output value (one text is displayed). The text assigned to that bit number is output. If more than one bit is set in the output value, the text "***" is output. When you enter a text, the data manager receives the input value of the value in which exactly that bit is set whose number corresponds to the text entered. The "bit" list type displays a text that relates to the status of a defined bit in the output value. Exactly two texts can be configured. One text is configured if the bit is set, and another text if the bit is not set. When you enter a text, the appropriate bit is set or deleted in the available output value and the new value is used as the input value. The relevant bit is determined by a unique property (bit number). When you use a text list object, the configured list of text assignments is opened. In the case of the "decimal" and "binary" list types, the text that corresponds to the current output value is selected. In the case of the "bit" list type, the opposing text to the current status is selected because use of this list type normally serves to "turn" a bit and therefore make further operation unnecessary. The text list object can be connected to the text library via the Language Switch attribute. During the configuration, entered text is automatically written to the text library. In the text library, the texts to be displayed can be translated. If you switch data languages, the system will read the corresponding translations from the text library. 2-6 WinCC Manual

17 08.97 Graphics Designer 3D Bar The 3D Bar is assigned to the smart objects group. Its properties (attributes) influence its appearance and functionality. It displays values graphically relative to a high and low limit. You can configure the type of the 3D display in any way you wish. The 3D Bar is part of the Basic Process Control option package. Group Display The Group Display object provides a hierarchically concentrated display of the current states of certain message types. Although, there is no connection to the message system within WinCC. Use the group display in RUNTIME mode to execute a picture change to the picture in which the error source is displayed. This opportunity for rapid navigation to an error source is a very significant function for the user. Note: The group display cannot be configured "on line" (in RUNTIME mode) because this can lead to an incorrect display in RUNTIME mode. The Group Display is part of the Basic Process Control option package. WinCC Manual 2-7

18 Graphics Designer Windows Objects Button The Button is used to control process events (like acknowledging messages or warnings). It recognizes two states ("pressed" and "not pressed"). The link to the process is achieved by making the corresponding attributes dynamic. Check-Box The Check Box is used when you need a multiple selection. You can select one or multiple boxes in the check box by clicking on it. A very flexible link to the process can also be achieved here by making the corresponding attributes dynamic. Option Group The Option Group is similar to the check box but only allows a single selection. The process link from the option group can be created at run time by making the attribute dynamic. Round Button The Round Button is implemented like the button for operating process events. However, in contrast to that button, the round button also has a latch down setting for both the "pressed" and "not pressed" states. The process link is achieved by making the appropriate attributes dynamic. Slider The Slider is implemented as a movement regulator for controlling a process (for example, temperature control). The control range lies between the minimum and maximum values. You can establish a link to the process by making the appropriate attributes dynamic. 2-8 WinCC Manual

19 08.97 Graphics Designer Drawing an Object Before you begin All objects are drawn with the default object properties in the first visible layer of the graphic workspace. Layer 0 is assigned for this purpose in Graphics Designer. You can change all of these default settings (see "Changing Object Properties"). How to Draw an Object: 1. Select the desired object by using the mouse in the object palette. 2. In the workspace, click the mouse where you want to place the object. Then drag the cursor while pressing the mouse button until the object reaches the desired size. or Click on the workspace. The object is then displayed in a system default size. or 1. Activate the object palette with the keystroke combination "Alt + O". 2. Select the object type using the arrow keys. 3. Create the selected object with defaults by hitting the "Enter" key. How to Draw a Polygon or a Polyline: 1. Select the "Polygon" or "Polyline" icon from the object palette. 2. Click the left mouse button on the starting point. 3. Click the left mouse button on each of the other corner points. 4. By clicking the right mouse button, you can correct the part of the object you entered last. 5. End the polygon or the polyline by double clicking the left mouse button. The polygon is closed while the polyline is not. 6. If you double click on a location on the line, you can enter an additional corner point. In order to delete a corner, you must double click on the corner while pressing the "Ctrl" key. Note: If you turn on the "Grid" and the "Snap to Grid" functions, you can align the drawn objects with each other much better. After Drawing After an object is drawn, the object palette automatically changes to the "Select Object" mode. Now you can create another object or select an object which is already in the workspace and change its properties. You can change the defaults using the menu "Options" - "Settings..." in the "Options" tab. WinCC Manual 2-9

20 Graphics Designer Selecting an Object How to Select an Object: Click on the object with the mouse. How to Select Multiple Objects (Multiple Selection): Changing Object Properties Hold down the "Shift" key and click on each object with the mouse. or Hold down the mouse button and drag a frame ("lasso") around the objects you want to select. Note: If you used the "Options" - "Settings..." menu to select the "Touching" option under "Object Selection" in the "Options" tab, you can mark the objects you want by simply touching them with the lasso. With the "Surrounding" option, all of the objects to be marked must be completely enclosed by the lasso. How to Change the Object Properties: 1. Click on an object with the mouse. 2. Click the right mouse button to open the pop-up menu. 3. Click on "Properties" to display the object properties. 4. In the "Properties" tab, select the corresponding attribute to change the object property. Note: With multiple selection, all of the attributes of the selected objects are listed in the "Properties" tab. However, only attribute values that are identical in all of the objects are displayed. Setting Object Properties You can set default object properties for each object type. These defaults are used each time a new object is created. How to Set the Defaults for Object Properties: 1. Open the dialog window with the object properties by means of the button on the standard palette or the "View" - "Properties" menu and attach it to the screen with the Pin. 2. Select an object type from the object palette. The properties for the corresponding default object are displayed. 3. Change the desired object properties in the "Properties" tab in the "Static" column WinCC Manual

21 08.97 Graphics Designer 4. When you exit Graphics Designer, you can save the presettings by means of the "Options" - "Settings" menu in the "Default Objects" tab. Note: You can change some properties directly, like line and border style, or background color, by using the style or color palettes Moving an Object with the Mouse How to Move an Object with the Mouse: 1. Click on an object and hold down the left mouse button. 2. Drag the object to the desired position. Note: If the "Snap to Grid" function is enabled, the object can only be shifted according to the grid setting Sizing an Object with the Mouse How to Change the Size of an Object with the Mouse: 1. Click the mouse on the object. The object is then surrounded by a rectangle with 8 handles. Example: 2. Click on one of these handles and hold down the left mouse button. 3. Drag the object to the desired size. You can change the size of the object diagonally with one of the four corner handles. Change the size horizontally or vertically with one of the handles in the middle of the border Changing the Start Angle/End Angle with the Mouse The "Change the Start and End Angle" function relates to the objects "Ellipse Segment," "Ellipse Arc," "Pie Segment," and "Circular Arc." WinCC Manual 2-11

22 Graphics Designer How to Change the Start/End Angle of an Object with the Mouse: 1. Click on the object with the mouse. The object is then surrounded by a rectangle with 8 handles. The end points of the curved object are identified by somewhat larger handles. Example: 2. Click on one of the larger handles and hold down the mouse button. The pointer changes to a crosshair with an S (Start Angle) or an E (End Angle) attached. 3. Drag the object to the desired size. Example: You can change the size of the object diagonally with one of the four corner handles. Change the size horizontally or vertically with one of the handles in the middle of the border. 2.3 Style Palette Change the look of the selected object using the style palette. Depending on the object type, there are different types of styles available. For example: Line/Border Styles Line/Border Weights Line End Styles for line objects Fill Patterns Note: The settings that are currently selected are displayed in a bold typeface. You can also operate the style palette with the keystroke combination "Alt + S" and the arrow keys. You can place the style palette anywhere in the workspace or anchor it to a border. The style palette can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu WinCC Manual

23 08.97 Graphics Designer Changing the Line Style The look of lines and borders can be altered by changing the line properties. There are different line styles available, like dot, dash, solid, etc. You can select the type of line or border from the style palette. How to Change the Line/Border Style Using the Style Palette: 1. Click on an object with the mouse. 2. Click on in the Style Palette. or Click on the in front of your selection to open it. 3. Click on the line you want to use from the selection available. or 1. Activate the style palette using the keystroke combination "Alt + S." 2. Select the line style you want using the arrow keys. 3. Accept the setting by hitting the "Enter" key. Note: If you select the line/border styles "dash," "dot," "dash dot," and "dash dot dot," a weight of 1 pixel is always displayed regardless of the selected line weight Changing the Line Weight The look of lines and borders can be altered by changing the weight. There are different weights available. You can select the thickness of the lines or borders from the style palette. The values provided correspond to a line/border weight measured in pixels. How to Change the Line/Border Weight Using the Style Palette: 1. Click on an object with the mouse. 2. Double click on the icon in the style palette. or Click on the in front of your selection to open it. 3. Click on the weight you want to use from the selection available. or 1. Activate the style palette using the keystroke combination "Alt + S." 2. Select the line weight you want using the arrow keys. 3. Accept the setting by hitting the "Enter" key. Note: The weight can only be enlarged for the "solid" line/border style. A line weight of 1 pixel is always displayed for all other line/border styles even if you select a larger line weight. WinCC Manual 2-13

24 Graphics Designer Changing the Line End Styles The look of line ends can be altered by changing the line properties. There are different line end styles available, like none, one-sided, two-sided, and thin or thick arrows. You can select the type of line end style from the style palette. How to Change the Line End Styles Using the Style Palette: 1. Click on a line object with the mouse. 2. Double click on the icon in the style palette. or Click on the in front of your selection to open it. 3. Click on the line end style you want to use from the selection available. or 1. Activate the style palette using the keystroke combination "Alt + S." 2. Select the line end style you want using the arrow keys. 3. Accept the setting by hitting the "Enter" key. Note: The "Line End Style" property is not available for borders around surface objects Changing the Fill Pattern The look of the background surfaces of objects can be altered by changing the object properties. There are different fill patterns available, like solid, striped, transparent, etc. You can select the fill pattern from the style palette. How to Change the Fill Pattern Using the Style Palette: 1. Click on the surface object. 2. Click on the icon in the style palette. or Click on the in front of your selection to open it. 3. Click on the fill pattern you want to use from the selection available. or 1. Activate the style palette using the keystroke combination "Alt + S." 2. Select the fill pattern you want using the arrow keys. 3. Accept the setting by hitting the "Enter" key WinCC Manual

25 08.97 Graphics Designer 2.4 Alignment Palette With the alignment palette, you can perform any of the following actions: Change the absolute location of one or more objects. Change the location of the selected objects relative to each other. Unify the height and width of multiple objects. The following alignment functions are available for the selected objects: Align Objects Left (Menu Arrange - Align - Left) Align Objects Right (Menu Arrange - Align - Right) Align Objects Top (Menu Arrange - Align - Top) Align Objects Bottom (Menu Arrange - Align - Bottom) Center Objects Horizontally (Menu Arrange - Align - Center Horizontally) Center Objects Vertically (Menu Arrange - Align - Center Vertically) Space Objects Horizontally (Menu Arrange - Align - Space Horizontally) Space Objects Vertically (Menu Arrange - Align - Space Vertically) Unify the Width of the Objects (Menu Arrange - Align - Same Width) Unify the Height of the Objects (Menu Arrange - Align - Same Height) Unify the Width and Height of the Objects (Menu Arrange - Align - Same Width and Height). Note: You can place the alignment palette anywhere in the workspace or anchor it to a border. The alignment palette can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu. WinCC Manual 2-15

26 Graphics Designer Aligning Objects How to Align Objects: 1. Select the objects that you want to realign. 2. Click on the corresponding icon in the alignment palette. The objects are realigned. Note: For the functions Left, Right, Top, and Bottom, the type of selection determines, which object will be used as reference for the alignment. If the objects have been selected via a selection frame (lasso), the object located the furthest out will be used as reference. If the objects have been selected via the mouse and the Shift key, the object selected first will be used as reference for the alignment. How to Unify the Width/Height of Objects: 1. While holding down the "Shift" key, click on the objects you want to unify in your workspace. 2. Click on the appropriate icon in the alignment palette. The objects are all set to the width and/or height of the object that was selected first. The line weight, however, is not changed. Note: If you select the objects with the mouse (border), they assume the width and/or height of the object which was implemented first in this group. Note: The type of selection determines, which object will be used as reference for the alignment. If the objects have been selected via a selection frame (lasso), the object located the furthest out will be used as reference. If the objects have been selected via the mouse and the Shift key, the object selected first will be used as reference for the alignment. Note: The type of selection determines, which object will be used as reference for the alignment. If the objects have been selected via a selection frame (lasso), the object located the furthest out will be used as reference. If the objects have been selected via the mouse and the Shift key, the object selected first will be used as reference for the alignment. Note: The type of selection determines, which object will be used as reference for the alignment. If the objects have been selected via a selection frame (lasso), the object located the furthest out will be used as reference. If the objects have been selected via the mouse and the Shift key, the object selected first will be used as reference for the alignment. Note: The type of selection determines, which object will be used as reference for the alignment. If the objects have been selected via a selection frame (lasso), the object located the furthest out will be used as reference. If the objects have been selected via the mouse and the Shift key, the object selected first will be used as reference for the alignment WinCC Manual

27 08.97 Graphics Designer 2.5 Zoom Palette The zoom palette lets you use the mouse on the slider or the buttons to set the zoom factor of the active window. The current zoom factor is displayed below the slider. You can also set Zoom step-by-step using the standard toolbar functions. Notes: You can also control the zoom palette using the keystroke combination "Alt + Z" and the arrow keys. You can place the zoom palette anywhere in the workspace or anchor it to a border. The zoom palette can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu. 2.6 Menu Bar How to Set the Zoom Factor: 1. Holding down the mouse button, drag the slider to the desired zoom factor. or Click above or below the control. The zoom factor is set to the appropriate zoom level according to the position of the mouse. or Use one of the buttons to set the zoom factor to the standard sizes 8, 4, 1, ½ or ¼. 2. After you release the mouse button, the picture is displayed at the zoom factor (percentage) shown in the zoom palette. The menu bar contains all of the menu commands available in Graphics Designer. Commands which cannot be activated are shown in gray. WinCC Manual 2-17

28 Graphics Designer File Menu New... Create an empty window with the "New" command. You can draw a new picture in this window. Graphics Designer provides an empty workspace with a default name NewPdlx. The x is incremented every time a new picture is created. When you save, you can change the name. Open... Load an existing file to the workspace with the "Open..." command. The project-specific files for Graphics Designer (file name extension.pdl) are listed as defaults. For further information about the process of file selection, see the Windows 95 description or the Windows NT description. Note: With a "Multi-User System" project type, another user may already have the picture file open that you want to open. In this case, the system opens a copy of the file with write protection. If you make changes, this file must be saved under another name. Close Remove the opened file from the screen with the "Close" command. If you have not yet saved a change to the file, Graphics Designer asks if you want to save the file. If you answer with "Yes," the file is saved. If the file is a new picture, you open the "File" - "Save As..." dialog. Activate RUNTIME Use the "Activate RUNTIME" command to switch to RUNTIME mode to test the current picture. Note: If you have not saved the picture yet, a dialog window opens and requests that you do so. If you exit the save dialog by means of "Cancel," the system does not switch to RUNTIME mode. Save Save the current version of your work with the "Save" command. Use this command when a file is saved for the first time and does not have a permanent name, or when you want to save a change to the file under the same path and name. The program-specific file name extension.pdl is attached to the file name as a default. Note: With a "Multi-User System" project type, the picture file to be saved may have been opened "write protected." In this case, the "Save" function is not possible. You must save the file under another name WinCC Manual

29 08.97 Graphics Designer Save As... Save the current version of your work with the "Save As..." command. Use this command if you want to change the name or the path of the file. The dialog box is like the one for the "Save" command. For conventions and procedures about assigning a file name and path, see the Windows 95 description or the Windows NT description. The program-specific file name extension.pdl is attached to the file name as a default. Save All Save the current version of all open work windows under already existing names with the "Save All" command. If a window has not been named, the system automatically switches to the "Save As..." dialog. Print... Print the open picture to the preset printer with the "Print..." command. Print to File This routes the print output of a picture to a new file in a drive you specify instead of sending the output directly to a printer. This is useful if you want to print a picture on a printer which is not available on your system. Collate Sorts the pages by sets when you are making multiple sets of a picture. Graphics Designer prints out the first set completely before it begins printing the next set. Print Preview Use the "Print Preview" command to check the page layout in the print view before you print it out. This gives you a view of the print picture with the following Toolbar: Print Start the printout. Next/Previous View the next/previous page in the print view. Two Pages View two pages beside each other on the screen. One Page Switch from the two page view back to the single page view. Zoom In/Zoom Out Zoom the print preview display with "Zoom In"/"Zoom Out." Close Exit the print preview and return to the normal editing view of Graphics Designer. WinCC Manual 2-19

30 Graphics Designer Printer Setup... Set up the desired printer and its parameters. Properties Open a dialog box in which you can set printer-specific properties. These properties are dependent on the capabilities of the printer that is set. This means that the dialog boxes are quite different depending on the type of printer. Print Feedback Documentation... Print the current picture and all of the objects contained therein along with their properties with the "Print Feedback Documentation..." command by means of the report system in WinCC (Report Designer). Note: The feedback documentation is sent to the printer that is set in the Report Designer. You can change the print layout by means of the Report Designer. Feedback Documentation Preview Use the "Feedback Documentation Preview" command to check the page layout of the feedback documentation in the print view before you print it out. This gives you a view of the print picture with the following Toolbar: Print Start the printout. Next/Previous View the next/previous page in the print view. Two Pages View two pages beside each other on the screen. One Page Switch from the two page view back to the single page view. Zoom In/Zoom Out Zoom the print preview display with "Zoom In"/"Zoom Out." Close Exit the feedback documentation preview. Export... Export the picture which is currently in the configuration window in the "Enhanced Meta File (.EMF)" or "Windows Meta File (.WMF)" format. The program-specific file name extension.emf is attached to the file name as a default. Note: When you export a picture created with the Graphics Designer, you lose all object properties which can be made dynamic that belong to individual objects WinCC Manual

31 08.97 Graphics Designer File List The file list displays the file names of the four most recently edited pictures. This area offers you rapid access to the files without having to use the "File" - "Open..." dialog. Exit Exit the Graphics Designer. If you have not yet saved changes to open files, Graphics Designer asks if you want to save the files. If you answer with "Yes," you open the save dialog (see "Save File" or "Save File As..."). Note: You can also exit Graphics Designer implicitly by means of the Control Center. If you still have a dialog window open in Graphics Designer at that point, the system releases an appropriate message. You must then exit Graphics Designer explicitly Edit Menu Undo Take back the last command used in processing the picture (Undo). Redo Repeats the action that was undone ("Undo") previously. Cut Remove objects from the picture and place them on the Clipboard. The picture is stored on the Clipboard until a new "Cut" or "Copy" replaces it. Copy Create a copy of an object and store it on the Clipboard. The picture is stored on the Clipboard until a new "Cut" or "Copy" replaces it. Duplicate Create a copy of an object directly in the picture. Objects duplicated this way are not stored on the Clipboard. Paste Copy the contents of the Clipboard and insert them in the picture. The contents of the Clipboard do not change. Delete Remove all of the highlighted objects from the picture without overwriting the Clipboard. The objects can only be returned to the picture using the "Undo" command. Select All Highlight all of the objects in the picture. WinCC Manual 2-21

32 Graphics Designer Group Group multiple selected objects together in what is known as a group object. All objects except OLE Controls and OLE Objects may be grouped. All of the objects in a group can be selected and edited with one single mouse click. How Make a Group of Objects: 1. Holding the "Shift" key, click on all of the objects that you want to group together. or Draw a border around the desired objects using the mouse. 2. Click on "Group" in the "Edit" menu. Edit Group Objects Sample You can change the properties of all of the group elements globally or edit the properties of each individual element using the "Object Properties" window. Object properties of an object group consisting of a line, a circle, and a rectangle: 2-22 WinCC Manual

33 08.97 Graphics Designer How to Edit Objects within a Group: 1. Highlight the group of objects. 2. Display the object properties (by double clicking on the group). 3. Select a property of an individual object or a property from the whole group. 4. Edit the properties. Notes: The properties of the group consist of the default attributes of the group and the batch of attributes belonging to all of the subobjects. Each attribute is only listed once. Changing a group attribute has an effect on all of the subobjects that share the attribute. Changing the attributes "Position X" and "Position Y" in the group element does not change the same attributes in the individual elements. Each individual object retains this property in relation to the group origin. Ungroup Ungroup a group of objects so that you can edit each object individually. TAB Sequence Influence the sequence in which operable objects are triggered in RUNTIME mode. Differentiate between the following: Alpha Cursor Objects Tab Order Objects "Alpha Cursor" - "Sequence" generally relates to I/O objects. I/O objects can also contain a number in the sequence for the Tab order. "Tab Order" - "Sequence" relates to objects which are selected using the "Object Type" data area. Open the "Object Type" dialog box with the "Edit" - "TAB Sequence" - "Tab Order" - "Settings" command. Note: Operable I/O objects can possess a number in the TAB sequence for both the Alpha Cursor and the Tab Order. These are listed according to the sequence in which they were created. WinCC Manual 2-23

34 Graphics Designer How to Set the TAB Sequence of the Alpha Cursor: 1. Click on "TAB Sequence" - "Alpha Cursor" - "Sequence" in the "Edit" menu. A numbered rectangle appears in the upper left corner of each input/output object. 2. Click on these rectangles sequentially. The numbers increase correspondingly. 3. End the input by clicking on an empty space in the workspace. You can still change numbering later. You can also remove objects from the TAB sequence or reenter objects in the TAB sequence. Note: If you hold the "Shift" key and click on the object, the number is reset to 1. How to Set the TAB Sequence of the Tab Order: 1. Click on "TAB Sequence" - "Tab Order" - "Sequence" in the "Edit" menu. A numbered rectangle appears in the upper left corner of each object selected by "Edit" - "TAB Sequence" - "Tab Order" - "Settings". 2. Click on these rectangles sequentially. The numbers increase correspondingly. 3. End the input by clicking on an empty space in the workspace. You can still change numbering later. You can also remove objects from the TAB sequence or reenter objects in the TAB sequence. Note: If you hold the "Shift" key and click on the object, the number is reset to WinCC Manual

35 08.97 Graphics Designer How to Change the Selection of Object Types for the Tab Order: 1. Click on "TAB Sequence" - "Tab Order" - "Settings..." in the "Edit" menu. 2. In the dialog box, click on the object types which should be included in the TAB sequence of the Tab Order. How to Change an Existing TAB Sequence: 1. In the "Edit" menu, click on "TAB Sequence" - "Alpha Cursor" or "TAB Sequence" - "Tab Order." The TAB sequence number is inserted in the objects. 2. The first object you click on receives the number Now click sequentially on the other objects. They are numbered according to the order of their selection. Notes: If you click on an object while holding the "Shift" key, you assign the number 1 and thus start a new sequence. In order to renumber only some of the objects, hold the "Ctrl" key and click on the last object which should retain its number. Numbers above that one are reassigned to other objects when you click on those objects. How to Delete an Object from a TAB Sequence: 1. Click on "TAB Sequence" - "Alpha Cursor" or "TAB Sequence" - "Tab Order" in the "Edit" menu. The TAB sequence numbers are inserted in the objects. 2. Holding the "Shift" + "Ctrl" keys, click on the object to be deleted from the TAB sequence. The number of the object is replaced by an asterisk (*). The objects with higher numbers are automatically renumbered. WinCC Manual 2-25

36 Graphics Designer How to Reinsert an Object into the TAB Sequence: 1. Click on "TAB Sequence" - "Alpha Cursor" or "TAB Sequence" - "Tab Order" in the "Edit" menu. The TAB sequence number is inserted in the objects. 2. Holding the "Shift" + "Ctrl" keys, click on the object marked with an asterisk (*) that is to be reinserted in the TAB sequence. The asterisk (*) is replaced by the next number in the TAB sequence. Properties Transfer the properties of an object or an object group to another object using the "Properties" menu item under the "Edit" menu. You can select from two functions which can also be accessed using the standard toolbar icons: Copy Properties Assign Properties Copy Properties Copies the properties from an object (except for the object name and the properties belonging to the "Geometry" area) in order to transfer them to another object. Assign Properties After you take properties from one object with the "Properties" - "Copy" command, transfer them to a selected object with the "Properties" - "Assign" command. Only the properties (attributes) which both objects contain (like color, line weight, and border weight) are assigned View Menu Properties Opens a window where the properties of the selected object or object group are displayed. Library Opens the Graphics Designer picture library. You can store objects created in Graphics Designer as icons under any name you select in this library. Then you can paste them into other pictures if necessary. The pictures can be stored in either a global library (path is provided in the MCP.INI file) or a project-related library (\LIBRARY in project path). How to Store a Graphic Object in a Library: 1. Highlight the object or the group of objects you want to store under a name in the library. 2. In the toolbar, select the button, or click on "Library" in the "View" menu. The library window will open WinCC Manual

37 08.97 Graphics Designer Library Toolbar 3. Select whether the object should be stored in the "Global Library" or in the "Project Library." 4. Select a folder in which to store the object. 5. Using the mouse, move the object to the file list. The object receives the default name Objectx (x = 1, 2, 3...). The name remains highlighted. 6. Assign a picture-related name to the object. You can also change the name of a picture later. You can also use the pop-up commands "Copy" and "Paste" as well as the Toolbar icons or the keystroke combination "Ctrl + C" and "Ctrl + V" to move the object. Note: Pictures with tag links and actions should not be stored in the "Global Library" since this could lead to errors when they are linked to other projects. How to Paste a Graphic Object from a Library: 1. In the toolbar, select the button, or click on "Library" in the "View" menu. The library window will open. 2. Select whether you want to take the object from the "Global Library" or from the "Project Library." 3. Select the folder you want to take the object from. 4. Click on the desired object and move it to the Graphics Designer workspace. or Click on the desired object, open the pop-up menu, and click on the "Copy" command. Click on the Graphics Designer workspace, open the pop-up menu, and execute the "Paste" command. How to Change a Picture Name in the Library: 1. In the toolbar, select the button, or click on "Library" in the "View" menu. The library window will open. 2. Click on the icon for the picture to be changed. 3. Using the right mouse button, open the pop-up menu and execute the "Rename" command. The file name is highlighted. 4. Input a new name for the picture. The Library Toolbar contains some of the icons that are in the Windows Explorer Toolbar, plus "Preview." Toolbars... Turn the palettes and toolbars on and off depending on your need. WinCC Manual 2-27

38 Graphics Designer How to Display/Hide Toolbars: 1. Click on "Toolbars..." in the "View" menu. 2. In the Toolbars dialog, select or deselect palettes and toolbars by clicking on the corresponding check-boxes. This will turn them on or off. A check mark in the control box shows that the palette or toolbar is selected. You can test the effect on the screen display without exiting the dialog box by using the "Apply" button. Use the "Restore" button to recreate the last setting of the toolbars that was saved. Full Screen Enlarge the workspace to the full screen size. This hides all palettes and bars. Switch back to the normal view by pressing any given key or any mouse button. Grid... You can insert a grid into the workspace in order to make your work there more precise. If you also switch on the "Snap to Grid" function, all newly drawn objects are automatically aligned with the grid points. Note: The minimum grid space displayed on the screen is 10 pixels. If you set a smaller value (for example, 4 pixels), you can align your objects to that smaller grid value. However the screen display will show the next evennumbered multiple of that value greater than 10 pixels (in case of a setting of 4 pixels, the screen will display 12) WinCC Manual

39 08.97 Graphics Designer Zoom Change the size of the picture shown on the screen. The view can be changed according to the following increments: From 20% to 100% in increments of 10% From 100% to 400% in increments of 50% From 400% to 800% in increments of 100%. With the "Zoom" - "Zoom Area" command, you can select a segment of the screen with a lasso and enlarge the segment. Layers... Switch layers to active or inactive. This displays or hides the objects in those different layers. An object is assigned to a layer through its object properties. How to Make Layers Active/Inactive: 1. Click on "Layers..." in the "View" menu. This displays the "Settings" dialog box with the "Visible Layers" tab. 2. Click on the layers in the selection list which are to be set to active. These are then marked with a check mark in the list. or Use the "All On" button to make all of the layers active, or the "1 to 15 Off" button to deactivate layers 1 to 15. or Click on the numbers in the layer bar be set to visible or invisible. for the layers to Notes: Objects are created in the first visible layer of the graphic workspace. Layer 0 is set as the default for this in Graphics Designer. The system does not allow you to switch off all of the layers. WinCC Manual 2-29

40 Graphics Designer Language... An object can receive different inputs for different languages. Use the "Language..." command to select the language with which the object input is linked. Example: Insert Import... Import graphic objects which are stored in different formats. The system supports the WMF format (Windows Meta File) and the EMF format (Enhanced Windows Meta File) Align Rotate Rotate objects by 90 degrees each. Only certain object types can be rotated (for example, an OLE object cannot be rotated). The properties are appropriately adjusted during a rotation (for example, when a text box is rotated by 90 degrees, the text orientation changes from "horizontal" to "vertical"). Mirror Mirror objects on the horizontal or vertical middle axis of the object. Only certain object types can be mirrored (for example, an OLE object cannot be mirrored). The properties are appropriately adjusted when an object is mirrored (for example, when a text box is mirrored at the vertical middle axis, the text orientation changes from "left justify" to "right justify"). Align Determine the location of objects relative to each other. The functionality corresponds to the alignment palette WinCC Manual

41 08.97 Graphics Designer Within the Layer You can influence the location of an object with the "Within the Layer" command. The following functions are available: Place On Top Place On Bottom Move Up One Layer Move Down One Layer Place On Top Move an object to the foreground within a layer using the "Within the Layer" - "Place On Top" command. Place On Bottom Move an object to the background within a layer using the "Within the Layer" - "Place On Bottom" command. Move Up One Layer Move an object one position forward within a layer using the "Within the Layer" - "Move Up One Layer" command. How to Move an Object One Space Forward within the Layer: 1. Highlight the object you want to move one space forward. 2. Click on "Within the Layer" - "Move Up One Layer" in the "Arrange" menu. or Hit the "Plus" key. Move Down One Layer Move an object one position backward within a layer using the "Within the Layer" - "Move Down One Layer" command. How to Move an Object One Space Backward within the Layer: 1. Highlight the object you want to move one space backward. 2. Click on "Within the Layer" - "Move Down One Layer" in the "Arrange" menu. or Hit the "Minus" key. WinCC Manual 2-31

42 Graphics Designer Options Menu Update References Update existing OLE links. This command tests all links with OLE objects and updates the contents of the objects. If a link to an OLE object is no longer valid, the object is represented by an empty object with a line through it in the Graphics Designer. You also receive an appropriate error message in the status bar. How to Update OLE Links: Click on "Update References" in the "Options" menu. or Press the F5 function key. Settings... "Grid" Tab "Options" Tab "Visible Layers" Tab The "Settings..." command opens a dialog window with the following tabs: "Grid" Tab "Options" Tab "Visible Layers" Tab "Default Objects" Tab You can insert a grid into the workspace using the "Display Grid" function in order to make your work there more precise. If you also switch on the "Snap to Grid" function, all newly drawn objects are automatically aligned with the grid points. Note: The minimum grid space displayed on the screen is 10 pixels. If you set a smaller value (for example, 4 pixels), you can align your objects to that smaller grid value. However, the screen display will show the next evennumbered multiple of that value that is greater than 10 pixels (in case of a setting of 4 pixels, the screen will display 12). Determine basic program settings using the "Options" tab. Decide if you want to save the configuration settings when you exit. Decide if the objects must be completely surrounded by the lasso when they are selected or if they only have to be touched. Decide if, after an object is created in the object palette, the object type continues to be highlighted in the object palette or if it is reset. Decide if you want to use the configuration dialog. It makes it easier to configure the objects for the "I/O Field," "Bar," "Button," "Slider," and "Status Display" objects types. You can make the picture layers 0 to 15 visible or invisible in the "Visible Layers" tab. Note: The system will not allow you to switch off all the layers WinCC Manual

43 08.97 Graphics Designer "Default Objects" Tab Set the parameters for saving the presettings in the "Default Objects" tab. Decide if you want to save the presettings when exiting. Select the file in which the presetttings are to be stored. Use the button to search through the available paths and set a different path. Use the "Save Now" or "Load Now" button to save or load the presettings of the objects now Window Menu New Window Create a copy of the current picture in another window. This means you can display different segments of a picture at the same time. Cascade Display all of the windows in the workspace by overlapping them in the upper left corner. Tile Vertically Arrange the workspace so that all open windows are visible and each window has a maximum height. The width of the individual windows is determined by the number of windows. This action fills up the entire configuration window. Tile Horizontally Arrange the workspace so that all open windows are visible and each window has a maximum width. The height of the individual windows is determined by the number of windows. This action fills up the entire configuration window. Arrange Icons Arrange all of the pictures which are reduced to icons in the workspace in the left lower half of the picture. Close All Close all of the open windows. Window List Lists all of the windows which are currently open. Any number of windows can be opened. The selected window becomes the current window and is placed in the foreground of the picture. The name of the current window is marked with a check mark. WinCC Manual 2-33

44 Graphics Designer Help Menu Contents Access the On-Line Help for Graphics Designer. For the rest of the procedure, see the Windows 95 description or the Windows NT description. Find... Turn on the context-sensitive Help. For the rest of the procedure, see the Windows 95 description or the Windows NT description. Index Request the index for On-Line Help. For the rest of the procedure, see the Windows 95 description or the Windows NT description. Glossary Call up the glossary. For the rest of the procedure, see the Windows 95 description or the Windows NT description. Using Help Receive information about how to use On-Line Help. Tutorial Start the tutorial for learning how to use Graphics Designer. About Graphics Designer Receive more detailed information about the Graphics Designer program and its platform WinCC Manual

45 08.97 Graphics Designer 2.7 Standard Toolbar The standard toolbar contains buttons you can click on with the mouse in order to execute commands which are needed often. You can place the standard toolbar anywhere in the workspace or anchor it to a border. The following buttons are available: New File (Menu File - New) Open File (Menu File - Open...) Save File (Menu File - Save) Activate RUNTIME (Menu File - Activate RUNTIME) Cut (Menu Edit - Cut) Copy (Menu Edit - Copy) Paste (Menu Edit - Paste) Undo (Menu Edit - Undo) Redo (Menu Edit - Redo) Print File (Menu File - Print...) Place on Top within the Layer (Menu Arrange - Within the Layer - Place on Top) Place on Bottom within the Layer (Menu Arrange - Within the Layer - Place on Bottom) Grid On/Off (Menu View - Grid...) Snap to Grid (Menu View - Grid...) WinCC Manual 2-35

46 Graphics Designer Enlarge View (Menu View - Zoom - Zoom In) Reduce View (Menu View - Zoom - Zoom Out) Enlarge Segment (Menu View - Zoom - Area) Copy Static Properties of the Selected Object (Menu Edit - Properties) Assign Static Properties (Menu Edit - Properties) Mirror Object Vertically (Menu Arrange - Mirror - Vertically) Mirror Object Horizontally (Menu Arrange - Mirror - Horizontally) Rotate Object (Menu Arrange - Rotate) Display Object Properties (Menu View - Properties) Open Library (Menu View - Library) Turn on Context Sensitive Help (Menu? - Find). Note: You can place the standard toolbar anywhere in the workspace or anchor it to a border. The toolbar can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu WinCC Manual

47 08.97 Graphics Designer 2.8 Font Palette Quickly change the font and font color of text objects as well as the line color of standard objects with the font palette Changing the Font Change Font Change Font Size Change Font Color Change Line Color Note: You can place the font toolbar anywhere in the workspace or anchor it to a border. The font palette can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu. The currently active font is displayed in the box Changing the Font Size The font size in points (pt.) which is currently active is displayed Changing the Font Color The square in the icon always takes on the color which was selected last. This color can be directly assigned to another text object by clicking on the icon Changing the Line Color The function affects the following colors: The color of the border in area objects The line color in line objects The square in the icon takes on the color which was selected last. This color can be directly assigned to another object by clicking on the icon. WinCC Manual 2-37

48 Graphics Designer Status Bar The status bar provides you with the following information: Displays a brief help text for a selected function. Displays the language selected for the text input. Displays the name of the selected object. If multiple objects are selected, they are all displayed. Displays the X-Y position of the object. If there is no object selected, this displays the position of the cursor. Displays the X-Y expansion of the object. If there is no object selected, this display does not appear. Displays the keystroke status (for example, the Num Lock key is engaged in this case). Note: The status bar can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu Layer Bar In the layer bar, you can select which of the 16 layers (Layer 0 to Layer 15) are visible. Objects are created in the first visible layer of the graphic workspace. Layer 0 is the default setting for this in Graphics Designer. Notes: The system does not allow you to switch off all the layers. You can place the layer bar anywhere in the workspace or anchor it to a border. The layer bar can be turned on or off via the Toolbars Toolbars >procedure entry from the View menu WinCC Manual

49 08.97 Graphics Designer 2.11 Object Properties The "Object Properties" window displays all of the properties of a selected object, an object group, or the defaults for an object type. These properties can be changed or copied. Furthermore, objects can be made dynamic here by setting the appropriate attributes, and they can be linked with actions. Structure The "Object Properties" window consists of the following items: Pin to fix the window Pipettes to copy and assign properties Object List "Properties" Tab "Event" Tab You can place the object properties window anywhere in the workspace Display Object Properties Pin How to Display Object Properties: Double click on the desired object. or 1. Select the object whose properties you want to view. 2. In the "View" menu, click on "Properties." or Click on the icon on the standard toolbar. or Open the pop-up menu with the right mouse button and click on "Properties." The pin gives you the opportunity to affix the "Object Properties" window to a specific location on the screen. The window can be moved to a desired position and remains open even when other objects are being processed. Its contents conform to each object selected. How to Affix the Window: 1. Click on the pin. The view of the pin changes to. 2. Click on the title bar of the window and, holding down the left mouse button, move the bar to the desired position. 3. By clicking on the pin again, you can detach the window. WinCC Manual 2-39

50 Graphics Designer Pipettes for Transferring Object Properties How to Transfer Object Properties: 1. Double click on the object whose properties you want to transfer. This opens the "Object Properties" window. 2. Click on the pin to affix the window. 3. Click on the left pipette icon. 4. In the object list or in the workspace, select the object to which you want to transfer the copied properties. 5. Click on the right pipette icon. Note: Only object properties of matching object characteristics (for example, colors, border weights, etc.) are transferred Object List In the object list, you can select additional objects in order to process them without closing the "Object Properties" window. How to Select an Object from the Object List: 1. Click on the arrow in the object selection list to open the list. 2. Click on the desired object. The name of the active object is displayed to the left of the selection list. Note: Objects that contains at least one dynamic attribute or one configured event are highlighted in a "bold" font in the object list "Properties" Tab Define the properties of the selected object in the "Properties" tab. Subject Tree The object properties are arranged in groups in a subject tree in the left half of the "Properties" tab. When you select a group from the subject tree, the corresponding attributes are displayed in the right half of the window WinCC Manual

51 08.97 Graphics Designer The following are examples of subjects which are possible depending on the object: Geometry Colors Styles Flashing Filling Font Limits Axis Miscellaneous Output/Input Note: Subjects that contains at least one dynamic attribute are highlighted in a "bold" font in the subject tree in the "Properties" tab. Attributes You can change the attributes using either value inputs, palettes, or pop-up menus, depending on the type of attribute. You can make the attributes dynamic by using either a tag or the return value of an action. Attribute Settings The attributes are dependent on the object type and subject you select in the subject tree. Four settings are assigned to each attribute: Static (S...) for the static properties of the attribute Dynamic (D...) to make the attribute dynamic Update (U...) to set the update of the attribute Indirect (I...) in case the tag which makes the attribute dynamic is addressed indirectly A green light bulb in the "Dynamic" column shows that the attribute is dynamically linked with a "Tag." If the attribute was made dynamic using a "Dynamic Dialog," the light bulb is replaced by a red lightning bolt. If the attribute was made dynamic using a "C Action," the light bulb is replaced by a green lightning bolt. An attribute which is to be made dynamic using a "C Action" that has not been compiled yet, is marked by a yellow lightning bolt. You can learn how to make an attribute dynamic by looking under "Making an Attribute Dynamic." WinCC Manual 2-41

52 Graphics Designer Static Attribute You can set certain properties for each attribute. These properties are set in the defaults and can be changed statically as well as dynamically for each attribute. Note: With multiple selection, all of the attributes of the selected objects are listed in the "Properties" tab. However, only attribute values that are identical in all of the objects are displayed. If you change an attribute, the new attribute value is displayed regardless of whether the attribute was changed in one, multiple, or all objects. Various procedures are described in more detail in the following: How to Change an Attribute with Switchover: 1. Select the desired subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the property set in the "Static" column (for example, Object: Static Text; Subject: Font; Attribute: Text Orientation). The attribute changes, for example, Vertical / Horizontal. or Click the right mouse button on the property which is set in the "Static" column. This opens the pop-up menu. Confirm the "Edit" menu item to change the property of the attribute. How to Change an Attribute by Selecting One of Multiple Options: 1. Select the desired subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the property set in the "Static" column (for example, Object: Circle; Subject: Flashing; Attribute: Background Flash Frequency). Click on one of the options offered. Example: or Click the right mouse button on the property which is set in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item and then select the desired property for the attribute. How to Change the Value of an Attribute: 1. Select the desired subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the value displayed in the "Static" column (for example, Object: Rectangle; Subject: Geometry; Attribute: Position X). This opens the input dialog box WinCC Manual

53 08.97 Graphics Designer Example: or Click the right mouse button on the value displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which then opens the input dialog box. 3. Enter the new value for the attribute. How to Change the Text of an Attribute: 1. Select the desired subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the value displayed in the "Static" column (for example, Object: Static Text; Subject: Font; Attribute: Text). This opens the input dialog box. Example: or Click the right mouse button on the text displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which then opens the input dialog box. 3. Enter the new text for the attribute. Note: If the text input contains control characters, they are also displayed in the object properties (for example, \r\n corresponds to CR/LF). How to Change the Color of an Attribute: 1. Select the "Colors" subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the color displayed in the "Static" column (for example, Object: Ellipse; Subject: Colors; Attribute: Background Color). This opens the color palette. WinCC Manual 2-43

54 Graphics Designer Example: or Click the right mouse button on the color displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which then opens the color palette. 3 Select the new color for the attribute. or Select another color using the "Other..." button. How to Change the Pattern of an Attribute: 1. Select the "Styles" subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the pattern displayed in the "Static" column (for example, Object: Bar; Subject: Styles; Attribute: Fill Pattern). This opens the pattern palette. Example: or Click the right mouse button on the pattern displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which then opens the pattern palette. 3 Select the new pattern for the attribute WinCC Manual

55 08.97 Graphics Designer How to Change the Line Style/Border Style of an Attribute: 1. Select the "Styles" subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the line displayed in the "Static" column (for example, Object: Line; Subject: Styles; Attribute: Line Style; or Object: Rounded Rectangle; Subject: Styles; Attribute: Border Style). In both cases, this opens the selection dialog box for line style. Example: or Click the right mouse button on the line style displayed in the "Sta tic" column. This opens the pop-up menu. Select the "Edit" menu item which then opens the selection dialog box for lines. 3 Select the new line style/border style for the attribute. Note: If you select the line styles/border styles "dash," "dot," "dash dot," or "dash dot dot," a weight of 1 pixel is displayed independent of the selected line weight/border weight. How to Change the Line Weight/Border Weight of an Attribute: 1. Select the "Styles" subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the line displayed in the "Static" column (for example, Object: Line; Subject: Styles; Attribute: Line Weight; or Object: Rectangle; Subject: Styles; Attribute: Border Weight). In both cases, this opens the selection dialog box for line weights. Example: WinCC Manual 2-45

56 Graphics Designer or Click the right mouse button on the line displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which opens the line weight selection dialog box. 3. Select the new line weight/border weight for the attribute using the larger/smaller buttons. or Input the new value directly. Note: If you select the line styles/border styles "dash," "dot," "dash dot," or "dash dot dot," a weight of 1 pixel is displayed independent of the selected line weight/border weight. How to Change the Line End Style of an Attribute: 1. Select the "Styles" subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the line displayed in the "Static" column (for example, Object: Line; Subject: Styles; Attribute: Line End Styles). This opens the selection dialog box for line end styles. Example: or Click the right mouse button on the line displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which opens the line end style selection dialog box. 3. Select the new line end styles (left and right) for the attribute. How to Change the Font of an Attribute: 1. Select the "Text" subject in the subject tree. The attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the font displayed in the "Static" column (for example, Object: I/O field; Subject: Text; Attribute: Font). This opens the selection dialog box for fonts WinCC Manual

57 08.97 Graphics Designer Example: or Click the right mouse button on the font displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which opens the font selection dialog box. 3. Select the new font for the attribute. How to Change an Attribute through Picture Selection: 1. Depending on the object, select the "Picture," "Pictures" or "Status" subject in the subject tree. The corresponding attributes are displayed in the right half of the window. 2. Double click on the name of the corresponding attribute or on the property set in the "Static" column (for example, Object: Round button; Subject: Pictures; Attributes: Picture Status Off; or Object: Status display; Subject: Status; Attribute: Flash picture). or Click the right mouse button on the graphic that is displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item to open the dialog window for picture selection. 3. In both cases, the selection dialog for picture selection opens. Example: WinCC Manual 2-47

58 Graphics Designer Select the desired graphic for the attribute. or Click on the "Browse " button to use the Windows default dialog to find the graphic in another folder. Note: To delete an assigned picture, use the "Cancel Selection" button. How to Delete a Language Entry: 1. Select the "Miscellaneous" subject in the subject tree. The attributes are displayed in the right half of the window. 2. Double click on the "Configured Languages" attribute or on the language displayed in the "Static" column (for example, Object: Static Text; Subject: Miscellaneous; Attribute: Configured Languages). This opens the selection dialog box for languages. Example: or Click the right mouse button on the language displayed in the "Static" column. This opens the pop-up menu. Select the "Edit" menu item which opens the language selection dialog box. 3. Delete the language entry assigned to the object by selecting a new language WinCC Manual

59 08.97 Graphics Designer Making an Attribute You can make an attribute dynamic by linking it with a tag or an action. Dynamic How to Link an Object with an Existing Tag: 1. Click on the object. 2. Open the pop-up menu using the r ight mouse button. Select the "Properties" menu item. 3. Select the subject and the corresponding attribute from the "Properties" tab, for example "Flashing" - "Background Flash Color On." 4. Click on the light bulb with the right mouse button and select the "Tag" menu item from the pop-up menu. 5. In the tag dialog box, select the tags needed. The light bulb turns green. How to Link an Object with a New Tag: 1. Click on the object. 2. Open the pop-up menu by using the right mouse button. Select the "Properties" menu item. 3. Select the subject and the corresponding attribute from the "Properties" tab, for example "Flashing" - "Background Flash Color Off." 4. Click on the light bulb with the right mouse button and select the "Tag..." menu item from the pop-up menu. 5. In the dialog, click on the button and assign parameters to properties of the new tag in the dialog window. 6. After setting the parameters, select the tag needed from the tag dialog box. The light bulb turns green. How to Link an Object with a New Action: 1. Click on the object. 2. Open the pop-up menu by using the right mouse button. Select the "Properties" menu item. 3. Select the subject and the corresponding attribute from the "Properties" tab, for example "Flashing" - "Background Flash Frequency." 4. Click on the light bulb with the right mouse button and select the "Dynamic Dialog" or "C Action" menu item from the pop-up menu. 5. Edit the "Dynamic Value Ranges" box or configure a "C Action" A red lightning bolt (dynamic dialog) or a green lightning bolt (C action) replaces the light bulb. WinCC Manual 2-49

60 Graphics Designer Setting the Update Cycle The update cycle determines how up-to-date the object attributes are, and thus determines how current the dynamic object is. Indirect Addressing of an Attribute You can select one of the standard cycles for the dynamic TAB sequence, or you can set your own cycle time. Indirect addressing is not possible with actions. How to Set the Update Cycle: Double click on the box in the "Update" column and select the TAB sequence from the list box. or Click the right mouse button on the box in the "Update" column and select the desired TAB sequence. A string tag for making the attribute dynamic must be provided with indirect addressing. This string tag contains the name of another tag whose contents trigger the attribute change. By changing the name in the string tag, you can access different tags dynamically. Indirect addressing is marked with a check mark. How to Set Indirect Addressing of an Attribute: Double click on the box in the "Indirect" Column. or Click the right mouse button on the box in the "Indirect" column. This opens the pop-up menu. Select the way in which the attribute is to be made dynamic "Event" Tab In the "Event" tab, you define actions to be carried out by the selected object. Subject Tree Object events are divided into groups in the subject tree in the left half of the "Event" tab. If you select a group from the subject tree, the corresponding events are displayed in the right half of the window. You can link each event with a hot key that also triggers the action. You can select the following subjects depending on the object: Mouse Keyboard Miscellaneous Property Subjects with the Attributes of the Object Note: Subjects that contain at least one configured event are highlighted in a "bold" font in the "Properties" tab subject tree WinCC Manual

61 08.97 Graphics Designer Events If an event is linked to an action, the lightning bolt is green. Standard functions are available for the actions. You can select the standard functions with a dialog box. You can also program your own actions in C programming language. When you configure actions, the attributes must be accessed using their OLE automation names. If a direct connection has been configured for an event, a blue lightning bolt is displayed. A direct connection is easy to configure and performs very fast during runtime. Object Event Each object in a picture can be linked with actions. You can trigger an action with the following events: Mouse event, when the pointer is on an object: Press or release the left or right mouse button. Keystroke event: Press or release a key. Miscellaneous object events: Changing the object Events which are linked to an attribute of the object: - Changing an object attribute - Changing the status of a tag which affects an object attribute Triggering Events Notes on Runtime Behavior: Event Mouse - Mouse Click: The event is triggered by releasing the mouse key, but only if the mouse pointer is over the object when the key is pressed and released. Event Mouse - Press Left/Right: The event is triggered directly by pressing the mouse key over the object. Event Mouse - Release Left/Right: Releasing the mouse key triggers the event for the object over which the mouse pointer was located when the mouse key was pressed. Triggering events is dependent on the object you select from the subject tree. The following setting is assigned to every triggering event: Action (A...) to display an assigned action or direct connection WinCC Manual 2-51

62 Graphics Designer Selecting the Action The following two entirely different possibilities are available for further processing events: C Action A "C Action" occurs by linking an event with a function which is formulated in ANSI-C programming language and is triggered cyclically or by the event. You can find information about linking an event with a function to an action under Connecting an Event with a Function. The lightning bolt in the object properties window turns green, if the event is linked to a function. Direct Connection To establish a direct connection, select a source element (constant, dynamic object, or tag) and a target element (current dialog, object, or tag) from the Direct Connection dialog. How to configure a direct connection, is described in "Making a Direct Connection Dynamic ". The lightning bolt in the object properties window will turn blue, if a direct connection has been configured for an event. How to Link an Event with a 1. Click on the object. 2. Call up the pop-up menu with the right mouse button and select the "Properties" menu item. 3. In the "Event" tab, select the subject and the corresponding attribute, for example, "Mouse" - "Mouse Operation." 4. Call up the pop-up menu for the action dialog by clicking the right mouse button on the lightning bolt. 5. Select the "C Action" menu item. 6. Configure the "C-Function". The lightning bolt in the object properties window will turn green Setting Dynamics with a Direct Connection Configuring a direct connection for an event causes the value of the source element (source) to be transferred to the target element (target) during runtime, if this event occurs. Sources can be constants, tags, or attributes of picture objects. Targets can be tags or dynamic attributes (of objects, dialogs, or tags). Advantages of a direct connection are its easy configuration and increased performance during runtime. The appearance of the dialog for configuring a direct connection is dependent on the objects contained in the picture and on the source/target WinCC Manual

63 08.97 Graphics Designer Basic Elements Operating Element Object List Property List Direct/Indirect Tag Tag, Operating Message Description Selects a configured picture that is to be displayed during a picture change. Opens the Tag Selection dialog. Lists all objects contained in a picture. A selection can only be made, if an object is used as a source or target Lists all dynamic attributes of a selected object. A selection can only be made, if an object is used as a source or target Set the tag addressing via these option buttons. In direct addressing, the read/write access is carried out to the indicated tag. In indirect addressing, the indicated tag must be a text tag. The read/write access is carried out to the tag, which has been entered in the text tag. The option buttons can only be accessed, if a tag is used as a source or target. An operating message will be displayed if the event occurs. The check box can only be selected, if a tag is used as the source of the direct connection. Note: If an entry is incomplete, a message will be displayed. WinCC can not check, if your input is logically correct or makes sense. Assignment errors made can only be noticed in the runtime mode. How to Configure a Direct Connection: 1. Select an object. 2. Call up the pop-up menu with the right mouse button and select the "Properties" menu item. 3. In the "Event" tab, select the subject and the corresponding attribute, for example, "Mouse" - "Mouse Operation." 4. Call up the pop-up menu for the action dialog by clicking the right mouse button on the lightning bolt. 5. Select the "Direct Connection..." menu item. WinCC Manual 2-53

64 Graphics Designer In the Direct Connection dialog, select the Source type: Constant, to enter a string sequence into the text field will be converted by WinCC) or to select a picture via the button and the Select Picture dialog (digits Property, to select an object and a dynamic property Tag, to select a tag via the button and the selection dialog These actions define the source element. 7. In the Direct Connection dialog, select the Target type: Current Window, to select a dynamic property of the current dialog (the "Target" - "Object" field will be blank) Object in Picture, to select an object and a dynamic property Tag, to select a tag via the These actions define the source element. button and the selection dialog The lightning bolt in the object properties window will be blue. Note: You will be informed, if the input is incomplete. WinCC can not check, if your input is logically correct or makes sense. Assignment errors made can only be noticed in the runtime mode The object list contains the entry this object. This entry should be used, if you want to use the properties of the currently selected object as the source or the target of a direct connection. If an object is copies, its dynamics will be copied as well. The direct connection of the object that has been created by the copy procedure will therefore point to this object. The newly created object will therefore be used as the source or target of the direct connection WinCC Manual

65 08.97 Graphics Designer Constants as Source of a Direct Connection If a constant is selected as the source of a direct connection, a string chain can be entered into the text field. The following table explains the effects of the text input on various target elements: Source Target Explanation "picture1.pdl" Current Dialog / Picture Name If the event occurs, a picture change will be carried out. In the dialog, the picture named picture1.pdl will be displayed. "picture1" Button1 / Text If the event occurs, the object Button1 will be labeled Picture1. 50 Rectangle1 / Width If the event occurs, the object Rectangle1 will be displayed 50 pixels wide. 50 Tag, with direct Operating Message If the event occurs, the tag will be assigned a value of 50. Simultaneously, an operating message will be displayed. To configure a picture change, you can also use the button. This will open a dialog containing all the previously configured pictures. WinCC Manual 2-55

66 Graphics Designer Object Properties as Source of Direct Connections The following table explains the effects of various direct connections, if an object property is used as a source: Source Target Explanation Circle1 / Width Current Dialog / Width If the event occurs, the dialog width will adapt to the width of the object Circle1. Circle1 / Fill Pattern Rectangle1 / Fill Pattern If the event occurs, the fill pattern of the object Rectangle1 will adapt to the fill pattern of the object Circle1. Bar1 / Height Direct Tag If the event occurs, the height of the object Bar1 will be assigned to the tag. Note: The object list contains the entry this object. This entry should be used, if you want to use the properties of the currently selected object as the source or the target of a direct connection. If an object is copies, its dynamics will be copied as well. The direct connection of the object that has been created by the copy procedure will therefore point to this object. The newly created object will therefore be used as the source or target of the direct connection WinCC Manual

67 08.97 Graphics Designer Tags as Source of Direct Connections The following table explains the effects of various direct connections, if a tag is used as a source: Source Target Explanation Tag1, direct Circle1 / Radius If the event occurs, the radius of the object Circle1 will be changed according to the tag value. Tag1, direct Tag2, indirect with operating message If the event occurs, the tag, which has been entered in tag 2, will be assigned the value of tag 1. Additionally, an operating message will be displayed. WinCC Manual 2-57

68 Graphics Designer WinCC Manual

69 08.97 Graphics Designer 3 Configuring Actions 3.1 Introduction "Actions" are functions which are formulated in ANSI-C programming language and are executed cyclically or because of an event. Examples of events are keystrokes, changes in object properties, or changes in the value of tags. Actions may be linked with any of the following: Graphical objects Process value archives (see Volume 3, Tag Logging, Section ) User archives (see Volume 3, Tag Logging, Section ) Compressed archives (see Volume 3, Tag Logging, Section ) Archive tags (see Volume 3, Tag Logging, Section 3.4.3) Loop in Alarm functionality of the message system (Alarm Logging) The return value of a function can control a property of the object with which the action is linked. Functions and actions which may be used throughout a project or across projects are called "global scripts". They are not linked to an object. In addition to the project functions, you may use "internal functions" and default functions unique to the system, as well as all of the C standard library functions (contained in the internal functions). Note: Actions are processed interpretatively. When implementing numerous or extensive actions, you should plan for a higher system load. It is therefore better to replace extensive actions by implementing separate DLL s (Dynamic Link Libraries). WinCC Manual 3-1

70 Graphics Designer Linking Actions with Graphic Objects You may link an action with an attribute belonging to a graphic object that was created with Graphics Designer, the system s graphic editor. The function used has a return value that controls the object s attribute which is linked with it. Before you can formulate an action and link it to an object, make the following preparations:: Open a configured picture using the WinCC Control Center. You can now utilize the dynamic-wizard, which will support you in formulating your action. If you want to formulate the action yourself, the following additional steps are required: Making Object Properties Dynamic Open the box "Object Properties" for the desired object. If you wish to make the object s properties dynamic, select "Properties". If you wish to react with an action to an event in conjunction with the selected object, select "Event.". You selected the "Properties" tab in the "Object Properties" box. Now select the category of properties which contains the attribute you want to influence during run time. Example: for a rectangle, you would select the geometric properties and position X. 3-2 WinCC Manual

71 08.97 Graphics Designer Click the right mouse button on the white light bulb in the "Dynamic" column in the "Position X" row. This opens a pop-up menu with the following options for making a property dynamic: Use the Dynamic Dialog Use a C Action Use a tag value Delete a dynamic creation which is already present Setting Dynamics Using the Dynamics Dialog By clicking the right mouse button on the white light bulb in the "Object Properties" box, you opened a pop-up menu and selected "Dynamics Dialog...". This opens the "Dynamic Value Ranges" dialog box. Here you can formulate the dynamic function by using tags, functions, and arithmetic operations in an expression. The value of the expression and the status of the tags used in the expression work together to create the attribute value. You determine how this occurs by setting the following options in the box: Select the data type of the expressing result. The data type determines the ways in which the value ranges are defined. Set the value ranges and assign attribute values. Start a status evaluation of the tags used in the expression. WinCC Manual 3-3

72 Graphics Designer Finally, you must determine the trigger to be used to update the attribute value using the value of the expression. Note: If you do not set an update event and the expression does not contain any tags, the system uses the default cycle with a default cycle time as the update event. If the expression contains tags, "Tag" is used as the update event with a default cycle time. As a final step, the formula for setting dynamics is changed to an action. You have now made the selected object attribute dynamic. Note: When you copy the object whose attribute you just made dynamic in the Graphics Designer, the action that is connected to that attribute is copied along with it. At run time, the attribute value is determined according to specific Rules using the value of the formulated expression and the states of the tags used in the expression. How to Include a Tag as a Part of an Expression: Click the left mouse button on the button or, as an alternative, click the right mouse button on the "Expression/Formula" row. This opens the appropriate pop-up menu. Click the left mouse button on "Tag...". This opens the "Select Tag" box where you can select the tag you wish to use in the dynamic expression. Select the tag either by double clicking the left mouse button on the tag name, or single clicking the left mouse button on the tag name and then clicking the "OK" button. The "Select Tag" box is then closed. 3-4 WinCC Manual

73 08.97 Graphics Designer Note: A tag name can also be entered directly in the "Expression/Formula" field of the "Dynamic Value Ranges" dialog. Observe the following: Tag names must always be enclosed by single quotation marks ( ) Tag names must not contain the symbols +, -, *, or /. How to Include a Function as Part of an Expression: Click the left mouse button on the button or, as an alternative, click the right mouse button on the "Expression/Formula" row. This opens the appropriate pop-up menu. Click the left mouse button on "Function...". This opens the "Function Browser" box: Select the desired function by opening folders with the mouse. You may do this in any of the following ways: Double click the left mouse button on the function name. This opens the dialog for assigning parameters to this function. After you assign the current parameters to the function, you return to the "Dynamic Value Ranges" box. The function is entered in the "Expression/Formula" column at the insertion mark. WinCC Manual 3-5

74 Graphics Designer Mark the function and click the "OK" button. The "Function Browser" box is closed and the function and its formal parameters are inserted in the "Dynamic Value Ranges" box in the "Expression/Formula" column at the insertion mark. Click the right mouse button on the function name: This opens a pop-up menu. Select the menu item "Parameter Assignment" which will place you in the dialog for assigning parameters within this function. After assigning the current parameters to the function, you return to the "Dynamic Value Ranges" box. The function, with its current parameters, is now entered in the "Expression/Formula" row at the insertion mark. Click the right mouse button on the function name: This opens a pop-up menu. Select the menu item "Apply." The function and its formal parameters are then entered in the "Dynamic Value Ranges" box in the "Expression/Formula" box at the insertion mark. The "Function Browser" box remains open. If you marked text in the "Expression/Formula" text row, that selected text was replaced by the formula. If necessary, enter the current parameters in the set of parentheses following the function name. For assigning parameters, see Section , Making a Function Dynamic Using a C Action, "How to Assign Parameters to a Function" How to Include an Operator as Part of an Expression: Click the left mouse button on the button or, as an alternative, click the right mouse button on the "Expression/Formula" row. This opens the appropriate pop-up menu. Click the left mouse button on "Operator...". This opens a second menu in which you can select the desired operator by clicking on it with the left mouse button. This closes both menus and enters the selected operator to the right of the insertion mark in the "Expression/Formula" row. The following operators are available: Operator Description + Addition - Subtraction * Multiplication / Division Note: You can also use the keyboard to enter operators. In that case, however, use only the operators listed in the table above. Other operators will lead to errors because all of the tests executed in the generated C functions are in floating-point format. 3-6 WinCC Manual

75 08.97 Graphics Designer How to Determine the Data Type of an Expression: You can set the data type of an expression by clicking the left mouse button on the appropriate entry in the "Data Type" box. The data type of the expression determines the type of value ranges which you may need to set. How to Define a Value Range: The adjustable value range depends on the data type selected. The following data types are available: Selected Data Type "ANALOG": You can define value ranges for an expression in the "Result of the Expression/Formula" list. Set the value of the object attribute for each value range. In order to do this, you must click the left mouse button on the "Add" box or click the right mouse button on the "Result of the Expression/Formula" area and select "New..." from the open pop-up menu. The first value range, "Value Range1," is entered. In the above example, the value range reaches from the minimum value that the expression can carry to a value of 100. You can establish an additional value range in the same way. The default high limit for a value range is 100 for "Value Range1." The default increment to the high limit for the next value range is 100. You can change the values for the high limits and attributes by double clicking the left mouse button on the value to be changed (or click the right mouse button on the value and then click "Edit..."). This opens a box in which you can change the value. WinCC Manual 3-7

76 Graphics Designer Note: After a tag has been selected, the "Tag" value is entered in the "Event Name" box. The selected tag is automatically used as a trigger tag and is scanned for changes during run time at a default cycle time of two seconds. Selected Data Type "BOOL": You can define the value of an object attribute for the cases "yes/true" (value of the expression <> 0) and "no/false" (value of the expression = 0) in the "Result of the Expression/Formula" list. You cannot set other valid ranges. You can change the attribute value by double clicking the left mouse button on the value to be changed (or click the right mouse button on the value and then click "Edit..."). This opens a box in which you can change the attribute value. Note: After a tag has been selected, the "Tag" value is entered in the "Event Name" box. The selected tag is automatically used as a trigger tag and is scanned for changes during run time at a default cycle time of two seconds. Selected Data Type "BIT": You define the value of the object attribute in the "Result of the Expression/Formula" list for either case in which a selected bit of a tag is set or not set. 3-8 WinCC Manual

77 08.97 Graphics Designer You cannot set other valid ranges. You can change the attribute value by double clicking the left mouse button on the value to be changed (or click the right mouse button on the value and then click "Edit..."). This opens a box in which you can change the attribute value. Use the "Select Tags" box to select the tags that contain the bits to be scanned. Open the box by clicking on the left button button. and then clicking on the You can set the bit of the previously selected tag by clicking on the right button. This opens the "Bit Selection" box in which you can click on the desired bit to select it. Note: After a tag has been selected, the "Tag" value is entered in the "Event Name" box. The selected tag is automatically used as a trigger tag and is scanned for changes during run time at a default cycle time of two seconds. Selected Data Type "DIRECT": The value of the expression is directly assigned to the object attribute. You cannot set a value range. Note: After a tag has been selected, the "Tag" value is entered in the "Event Name" box. The selected tag is automatically used as a trigger tag and is scanned for changes during run time at a default cycle time of two seconds. WinCC Manual 3-9

78 Graphics Designer Determining the Effect of the Tag Status on an Attribute Value: If you want the tag status to influence an attribute value, you must activate the "Evaluate the Status of the Tags" box by clicking on it with the left mouse button. This expands the Dynamic Dialog window. The tag names (without quotation marks) used in the expression are located in the left part of the window under Status. Click the left mouse button on a tag name. All of the states which a tag can assume appear in the right part of the window. You can set the appropriate attribute value for each state by clicking the left mouse button on the attribute value to be changed (or click the right mouse button on the value and then click "Edit"). This opens the "Value Input" box in which you can change the value. Close the "Value Input" box by clicking on "OK." The value you entered is then accepted as the attribute value. How Value Ranges and Tag States are Evaluated: The value assigned to the attribute is established according to the following rules: Evaluation of the Status The status evaluation has the highest priority. The system checks whether one or more tags used in the expression have one or more states corresponding to the status list. If so, the status with the highest priority determines the value assignment. The priority of the states corresponds to their sequence in the status list; the first entry in the list has the highest priority. Evaluation of the Value Ranges If the status evaluation did not result in a value assignment, the value range containing the value of the expression is determined. The attribute value linked to this value range is assigned to the object attribute WinCC Manual

79 08.97 Graphics Designer How to Set the Update Event: Click the button. This opens the "Change Trigger " box. Note: The system presets the trigger event with a default entry. The default depends on the contents of your formulated expression in the "Dynamic Value Ranges" box. If the expression contains one or more tags, the default entry for the trigger event is "Tag" and all of the tags that are in the expression are transferred to the tag list. If the expression does not contain tags, the default entry for the trigger event is "Default Cycle." The entry for the cycle is set with a default value. You select an event by opening the "Event" list with the left mouse button and marking the desired event by clicking on it with the left mouse button. You can select from the following events: Tag Default Cycle Picture Cycle Window Cycle If you select "Default Cycle," "Picture Cycle," or "Window Cycle" as the event, you can assign a trigger name to the event. Input the trigger name by placing the cursor in the "Trigger Name" row using a left mouse click. If you enter the name using the keyboard, you delete an entry that was already there. WinCC Manual 3-11

80 Graphics Designer If you selected "Default Cycle" or "Tag," you may need to change the cycle time. Do this by opening the "Cycle" list with the left mouse button and marking the desired time by clicking on it with the left mouse button. You can select from the following cycle times: At change 5 min 250 ms 10 min 500 ms 1 hr 1 s User cycle 1 2 s User cycle 2 5 s User cycle 3 10 s User cycle 4 1 min User cycle 5 The "At change" entry is only available if you selected "Tag" as the event. If you selected "Tag" as the event, the contents of the "Change Trigger" box change: Here you can input one or more tags which serve as a trigger for the action when their value changes from one cycle to the next. If more than one tag is input, the action is triggered when the value of one of these tags changes from one cycle to the next WinCC Manual

81 08.97 Graphics Designer There are three ways to input tags: Using the left mouse button, place the cursor on the text line Tag Name and enter a name. The name will not be enclosed by quotation marks. Afterwards, click on the "Add" button to transfer the tag to the tag list. Right mouse button click on the Trigger Name column in the tag list. If you want to use an existing tag, select DM_Tags from the displayed pop-up menu. The Select Tag dialog will open from which you can select the desired tag. If you want to enter the tag name directly, select New from the pop-up menu. By clicking on the button, open the "Select Tag" box from which you may select the desired tag. Select the tag either by double clicking the left mouse button on the tag name, or single clicking the left mouse button on the tag name and then clicking the "OK" button. The "Select Tag" box is then closed. You then return to the "Change Trigger" box. The selected tag is now entered in the "Trigger Name" column in the tag list. The system assigns a cycle time to the entered tags in the "Default Cycle" column. This is the time span between two sequential scans of the tags for value change. If you want to change the cycle time of a tag at a later time, use the following steps: Click the right mouse button on the cycle time to be changed to open the pop-up menu. Select the new cycle time from the pop-up menu. WinCC Manual 3-13

82 Graphics Designer An alternative procedure is the following: Double click on the cycle time to be changed to open the "Update" box. Select the new cycle time from the list and click the "OK" button to close the box. Delete entered tags by marking them in the tag list and then clicking the "Remove" button. Mark a connected range of tags by marking the first tag in the range and then marking the last tag with the "Shift" key depressed. Mark individual multiple tags by marking the first tag and then marking all others with the "Ctrl" key depressed. Attention: In the case of the "Tag" trigger event, the entry "At Change" is available as a cycle. This means that the action is triggered as soon as the value of one of the tags in the tag list changes. This type of trigger causes a heavy system load. If the update event has been set, close the "Change Trigger" box by clicking on the "OK" button. How to Create an Action from the Entries: You have completed all of the entries for making the object attribute dynamic. In order for the settings to control the object attribute during the run time, you must create an action from them. Do this by clicking on the "OK" button in the "Dynamic Value Ranges" dialog box. The system then creates an action from the entries. If errors occur during this process, they are reported in the "Error Messages" box: In order to find the causes of the errors, click the "Details" button. The box is then enlarged and displays a description of the errors. If the action was generated without errors, the "Dynamic Value Ranges" box closes and you are returned to the "Object Properties" box. The white light bulb in the "Dynamic" column is now a red lightning bolt. It shows that an action created with the dynamic dialog is linked to this attribute WinCC Manual

83 08.97 Graphics Designer Notes: If you wish to test your entries in the "Dynamic Value Ranges" box for errors without creating an action, click on the "Test" button. When you click the "Test" or "OK" button, the "Result of the Expression/Formula" list of value ranges is sorted according to increasing range high limits. You may view and edit the created action by clicking the right mouse button on the red lightning bolt and opening the corresponding pop-up menu. Select "C Action..." from the pop-up menu. Attention! A box will notify you that this action was created using the "simplified script configuration," that is, with the help of the dynamic dialog. This is significant because once an action has been loaded as a "C Action," it can no longer be processed using the dynamic dialog. Note: For C-actions, tag names used in the expression are enclosed by double quotation marks ("). If a tag name contains the symbol ", the symbol \ will be placed in front of it in the C-action. Example: Motor"M"1 will be changed to Motor\"M\" Adding Dynamics with the Dynamic-Wizard The dynamic wizard allows you to add dynamics, via C-actions, to an object. If the wizard is executed, the preconfigured C-actions and trigger events are set and stored at the object properties. The preconfigured C-actions can be edited in the Events tab of the Object Properties window. The preconfigured C-action are divided into the following categories: System Functions Miscellaneous Standard Dynamics Import Functions Picture Functions User Archive Functions The different categories can be selected by clicking on the appropriate tabs with the left mouse button. WinCC Manual 3-15

84 Graphics Designer Note: The display of the dynamic wizard can be turned on or off via the "Toolbars..." entry from the "View" menu System Functions How to add Dynamics to an Object with the Dynamic Wizard: 1. In the Graphics Designer, select the object or picture to which you want to add dynamics. 2. Select the dynamic wizard via a left mouse button click on the appropriate tab of the C-action categories. 3. In the dynamic wizard, select a C-action via double click. 4. Follow the instructions in the dynamic wizard dialogs. After completing the dynamic wizard, the C-action stored at the object properties can be edited if necessary. Hardcopy Exit WinCC Runtime Exit WinCC or Windows Language Switch Exit WinCC Start another application With this function, an action for creating a hardcopy of the display can be configured. With this function, an action can be created that exits the runtime mode of WinCC. With this function, an action can be created that exits WinCC or the operating system. You can determine how the operating system is exited ( Shut down, Restart, or Log on as a different user ). With this function, an action can be created that switches the data language. With this function, an action can be created that exits WinCC. With this function, an action can be created that starts another application. In the course of the wizard, you will indicate the path and name of the application to be started Miscellaneous Functions Generate Script This function creates the framework of a wizard script. The wizard script can be edited with the program "DynWizEdit.exe" and be run with the program "Dynwiz.exe" Standard Dynamics Operational if authorized Copy Tag Value With this function, an action can be created that checks the operator authorization of an user. This function allows you to copy the value of one tag to another tag. You will be asked to indicate the source and target tag WinCC Manual

85 08.97 Graphics Designer Link a prototype to a structure Make a property dynamic Add dynamics to the prototype Set tag value Move Object Fill Object Output String Tag This function allows you to link an object property, that has been edited via Add dynamics to a prototype function, to a tag of the data type Structure Tag. This function allows you to link a object property to a tag, and make that object property dynamic via the tag value. You will be asked to indicate the object property and tag in the course of the wizard. This function allows you to add dynamics to an object property via an element of a structure tag. This function allows you to set the value of a tag. You will be asked to indicate the tag to be changed and the value. The object properties Position X" and "Position Y" can be linked to tags, which will male the position of the object dynamic. With this function, an action can be created that that makes the fill level of an object dynamic via a tag. In the course of the wizard, you can define, in addition to the tags, the upper and lower limits for the fill levels 0% and 100%. With this function, the Text attribute of an object can be linked to a text tag. This C-action is only available for objects containing the Text attribute Import Functions Import S7 S5 - Assignment List Import Messages Import S5L Only Tag This wizard allows you to read an assignment list of Step 5 or Step 7 into WinCC. Additional information can be found in "Hantzuli.doc" file on the WinCC CD-ROM. This wizard allows you to accept a COROS LS-B message list into WinCC. Additional information can be found in "Hantmigr.doc" file on the WinCC CD-ROM. This wizard allows you to accept a COROS LS-B tag list into WinCC. Additional information can be found in "Hantmigr.doc" file on the WinCC CD-ROM Picture Functions Set/Reset multiple Bits With this function, an action can be created that sets multiple bits of a tag. You will be asked to indicate the tag to be changed and the bit number by the wizard. Rücksetzen/Ausmaskieren? Display WinCC Dialog This function allows you to display any picture of the Graphics Designer in a Box picture window. Indicate the name of the picture to be displayed and set the appearance of the picture window in the course of the wizard. WinCC Manual 3-17

86 Graphics Designer Picture Change in the Window This function allows you to change the content of a window object in a Graphics Designer picture. Set/Reset Bit Display Instruction Box With this function, an action can be created that sets a bits of a tag. You will be asked to indicate the tag to be changed and the bit number by the wizard. Rücksetzen? ausmaskieren? With this function, an action can be created that displays an instruction box. You will be asked to indicate the type of instruction (information, question, or emergency box), as well as the title and text of the message, by the wizard. ohne Abbruchknopf? Single Picture ChangeWith this function, an action for a picture change can be created. You will be asked to indicate the name of the new picture to be displayed. Display Error Box With this function, an action can be created to display an error box. You will be asked to indicate the type of instruction (information, question, or emergency box), as well as the title and text of the message, by the wizard User Archive Functions Generate Archive Objects For the processing of an user archive, the wizard creates objects (buttons, I/O fields, etc.) in the selected picture. The wizard will ask you to select an user archive created in Tag Logging WinCC Manual

87 08.97 Graphics Designer Example of a configured Dynamic 1. In the Graphics Designer, create a picture with an object of the type Button. 2. Select the button. 3. Activate the dynamic wizard via a double click on the picture function Display Instruction Box. 4. In the wizard window Select Trigger, select Left mouse key as the trigger event and click on the Next button. WinCC Manual 3-19

88 Graphics Designer In the wizard window "Set options, determine the content of the title line and instruction text, as well as the appearance of the message window. Afterwards, click on the Next button. 6. In the final wizard window, click on the Finish button. The C-action generated by the wizard can be edited via the button s pop-up menu item Properties ( Events tab). 7. Save the picture. 8. Activate the project by clicking on the button in the toolbar of the Graphics Designers. 9. In runtime, if you position the mouse pointer above the button, the mouse pointer will be displayed with a green lightning bolt. If you click the left mouse button, a message window, displaying the configured texts, will open WinCC Manual

89 08.97 Graphics Designer Setting Dynamics with a C Action By clicking the right mouse button on the white light bulb in the "Object Properties" box, you open a pop-up menu and select "C Action...". The "Edit Action" box is then opened. In C programming language, you must then formulate the Function that you wish to implement in order to control object attributes. In this formulation you may use the preprogrammed C functions which the system makes available in the left half of the box. In that case, you need only undertake the Parameter Assignment. The function becomes an action when you Assign an Update Event. Note: If you do not select an update event, the system sets the default cycle with a default cycle time as the update event. Using the return value of the function, you control the attribute that is linked to the action. Within the function, you can access each attribute of every single object in each picture using the Get... and Set... functions. This means you can read and set the attribute value. The formulated function must be compiled. During compilation, errors which may have occurred are reported. If the compilation is carried out without errors, the formulation of the action is completed, and the action is linked with the attribute. A compiled C action is marked with a green lightning bolt in the "Object Properties" box. Note: After formulating the action, you can exit the "Edit Action" box and return to the "Object Properties" box without compiling the action. A box will notify you of this situation. Select "Compile Yes or No." If you decide not to compile the action, this is noted with a yellow lightning bolt in the "Dynamic" column within the "Object Properties" box. You can export actions which were compiled without errors and load them in a file. You can also import exported actions and thus link them with a new attribute. The imported action can then be edited if necessary. Note: When you copy the object whose attribute you just made dynamic in the Graphics Designer, the action that is connected to that attribute is copied along with it. WinCC Manual 3-21

90 Graphics Designer How to Formulate a C Open the "Edit Action" box: Formulate the function in the right half of the window. The first row contains the header file to be linked. The second row already contains the function name followed by parentheses containing the formal parameters, as well as the left (open) parenthesis. The last row contains the right (close) parenthesis. The parameters are: Parameter Meaning Type lpszpicturename Picture name of the active picture char pointer lpszobjectname Object name of the selected object char pointer lpszpropertyname Attribute name of the attribute with which the action is to be linked char pointer Edit the C function in this section of the window. The following edit functions are available: Function New row Delete character to the right Delete character to the left Jump to the beginning of the row Jump to the end of the row Jump to the beginning of the text Jump to the end of the text Move the insertion point Cut selected text Copy selected text Paste text from the Clipboard Keyboard Enter Delete Backspace Home End Ctrl+Home Ctrl+End with the cursor keys Ctrl+X Ctrl+C Ctrl+V 3-22 WinCC Manual

91 08.97 Graphics Designer Function Mark text Mark a word Move the insertion point Mouse with left mouse button Double click with left mouse button with left mouse button Further edit functions are: Write mode is "Insert." The selected text is replaced by the next character selected using the keyboard. Expanded selection. Select a range: Place the cursor where you wish the selection to begin, hold down the Shift key, and then place the cursor where you wish the selection to end. Expand a selection: Hold the Shift key and place the cursor at the desired end of the selection. You can place fully programmed functions within your function at the cursor location. This function replaces selected text. Open the folders in the left half of the window and select the desired function by clicking on it with the right mouse button. This opens a pop-up menu in which you select the menu item "Parameter Assignment." This opens the "Assign Parameters " dialog box where you can assign parameters to the selected function. Once the parameter assignment is successfully carried out, the selected function with its current parameters is inserted at the insertion mark. If you selected text, it is replaced by the function. Note: You can also open the "Assign Parameters" box by double clicking the left mouse button on the desired function. If you want to edit the parameter assignment yourself, select "OK" from the pop-up menu. The selected function is inserted at the cursor location as "Prototype." This means it contains a declaration of the data types and the formal parameters. If you selected text, it is replaced by the function. You can insert tag names by clicking on the button. This opens the "Select Tag" box from which you select the desired tag. You can shift the split bar right or left using the mouse. See also Volume 2, Global Script, Section 3, Standard Functions, and Volume 2, Global Script, Section 4, Internal Functions. WinCC Manual 3-23

92 Graphics Designer How to Assign Parameters to a By clicking the right mouse button on the function name in the "Edit Action" box, you opened a pop-up menu and selected the "Parameter Assignment" menu item. The "Assign Parameters " box is opened. The entries in the "Description" and "Data Type" columns are informational. You can enter parameters in the following ways: Once all of the parameters have been entered, close the "Assigning Parameters" box by clicking on the "OK" button. The selected function and its parameters are placed at the insertion mark in the "Edit Action" box. How to Input a Tag as a Parameter: In the Setting Parameters box, you opened the drop-down menu by clicking on the button and selected the Select Tag entry to open the "Select Tag" dialog: Note: The graphic displayed contains hot spots. If you click the left mouse button on a hot spot, you will receive an explanation of the hot spot. The keystroke combination <Ctrl>Tab makes all hot spots visible WinCC Manual

93 08.97 Graphics Designer Select the tag either by double clicking the left mouse button on the tag name, or single clicking the left mouse button on the tag name and then clicking the "OK" button. The "Select Tag" box is then closed. You then return to the "Assign Parameters" box and the selected tag is entered as a parameter. How to Input the Name of a Picture, an Object, or an Attribute as a Parameter: In the Setting Parameters box, you opened the drop-down menu by clicking on the button and selected the Graphic Objects entry. This opens the "Picture Browser"" dialog: The left third of the box contains a list of pictures available in the project. Click on a picture to select it. The "Object" list includes the objects that are contained in the selected picture. If you want to use the picture name as a parameter, highlight the object name of the picture in the "Objects" list by clicking on it ("NewPdl1" in the example above) and then click "OK". If you want to use the object name of an object contained in a picture as a parameter, click on the desired object name in the "Objects" list. The "Properties" list is filled with the attribute names owned by the selected object. Click on "OK". If you want to use an attribute name as a parameter, click on the desired attribute name in the "Properties" list and then on "OK". This closes the "Select Picture" box. You return to the "Assign Parameters" box and the selected name is entered as a parameter. WinCC Manual 3-25

94 Graphics Designer How to Set the Update Event: Click the button. This opens the "Change Trigger " box. Note: The system presets the trigger event with a default entry. The default depends on the contents of your formulated expression in the "Dynamic Value Ranges" box. If the expression contains one or more tags, the default entry for the trigger event is "Tag" and all of the tags that are in the expression are transferred to the tag list. If the expression does not contain tags, the default entry for the trigger event is "Default Cycle." The entry for the cycle is set with a default value. You select an event by opening the "Event" list with the left mouse button and marking the desired event by clicking on it with the left mouse button. You can select from the following events: Tag Default Cycle Picture Cycle Window Cycle If you select "Default Cycle," "Picture Cycle," or "Window Cycle" as the event, you can assign a trigger name to the event. Input the trigger name by placing the cursor in the "Trigger Name" row using a left mouse click. If you enter the name using the keyboard, you delete an entry that was already there WinCC Manual

95 08.97 Graphics Designer If you selected "Default Cycle" or "Tag," you may need to change the cycle time. Do this by opening the "Cycle" list with the left mouse button and marking the desired time by clicking on it with the left mouse button. You can select from the following cycle times: At change 5 min 250 ms 10 min 500 ms 1 hr 1 s User cycle 1 2 s User cycle 2 5 s User cycle 3 10 s User cycle 4 1 min User cycle 5 The "At change" entry is only available if you selected "Tag" as the event. If you selected "Tag" as the event, the contents of the "Change Trigger" box change: Here you can input one or more tags which serve as a trigger for the action when their value changes from one cycle to the next. If more than one tag is input, the action is triggered when the value of one of these tags changes from one cycle to the next. WinCC Manual 3-27

96 Graphics Designer There are three ways to input tags: Using the left mouse button, place the cursor on the text line Tag Name and enter a name. The name will not be enclosed by quotation marks. Afterwards, click on the "Add" button to transfer the tag to the tag list. Right mouse button click on the Trigger Name column in the tag list. If you want to use an existing tag, select DM_Tags from the displayed pop-up menu. The Select Tag dialog will open from which you can select the desired tag. If you want to enter the tag name directly, select New from the pop-up menu. By clicking on the button, open the "Select Tag" box from which you may select the desired tag. Select the tag either by double clicking the left mouse button on the tag name, or single clicking the left mouse button on the tag name and then clicking the "OK" button. The "Select Tag" box is then closed. You then return to the "Change Trigger" box. The selected tag is now entered in the "Trigger Name" column in the tag list. The system assigns a cycle time to the entered tags in the "Default Cycle" column. This is the time span between two sequential scans of the tags for value change. If you want to change the cycle time of a tag at a later time, use the following steps: Click the right mouse button on the cycle time to be changed to open the pop-up menu. Select the new cycle time from the pop-up menu WinCC Manual

97 08.97 Graphics Designer An alternative procedure is the following: Double click on the cycle time to be changed to open the "Update" box. Select the new cycle time from the list and click the "OK" button to close the box. Delete entered tags by marking them in the tag list and then clicking the "Remove" button. Mark a connected range of tags by marking the first tag in the range and then marking the last tag with the "Shift" key depressed. Mark individual multiple tags by marking the first tag and then marking all others with the "Ctrl" key depressed. If the update event has been set, close the "Change Trigger" box by clicking on the "OK" button. This returns you to the "Edit Action" box. How to Control the Attribute Value: You can use the return value of your C function to control the attribute that is linked to your action. Example: In the Graphics Designer, open the picture than contains the object whose attribute you want to make dynamic. Open the "Object Properties" box by clicking the right mouse button on the appropriate object. In this box, select the property to be made dynamic. In the following figure, this is the "Circle1" object and the "Colors" property. Click the right mouse button on the light bulb icon for the appropriate attribute that you want to make dynamic, for example, on the light bulb icon in the row with the "background color" attribute. WinCC Manual 3-29

98 Graphics Designer From the pop-up menu that opens, select "C-Action...". The "Edit Action" window opens. In the right half of the window, it already contains the completed structure of a C function. Formulate your function and set the trigger that will call your C function during run time. The function consists of the definition of both local tags xvar and result. The GetTagDWord ("var") function assigns the value of the process tags var to the local tags xvar. The if-else construct assigns the result tags result a value of CO_RED (value for the color red) if the value of the xvar tags is greater than 128, otherwise it receives the value CO_BLUE (value for the color blue). The last row ensures that the function value of the C function main receives the value of the event tags. A change of the value of the var process tags was selected as the trigger event and the value of the tags is checked every two seconds by the Control Center. How to Compile the C Click on the button in the Toolbar of the "Edit Action" box. The function is compiled. This procedure is displayed in the box s Toolbar with a "Compile Action..." message. If the function was compiled without errors, the status bar displays the message "0 Error(s), 0 Warning(s)." If errors occurred during the compilation, the message "n Error(s), m Warning(s)" appears in the status bar. The n and m characters are the number of errors or warnings WinCC Manual

99 08.97 Graphics Designer The errors and warnings appear in the lower part of the edit window, dividing the window. You can shift this split bar up and down using the mouse. After a successful compilation, close the "Edit Action" box by clicking on "OK." This returns you to the "Object Properties" box. The attribute linked to the action is marked with a green lightning bolt in the "Dynamic" column. This shows that this attribute is linked to a compiled C action. Note: If you close the box without compiling the action, you are notified of this in a dialog box. You then have the choice of compiling or returning to the "Object Properties" box without compiling. If you decide not to compile the action, it is marked with a yellow lightning bolt in the "Dynamic" column in the "Object Properties" box. How to Export an Action: Click on the button in the Toolbar. This opens the "Save As" box: Here you select the storage location and the name of the export file. The extension "act" is added by the system. Clicking the "Save" button exports the action and loads it in the file you selected. The "Save As" box is closed. WinCC Manual 3-31

100 Graphics Designer How to Import an Action: Click on the button in the Toolbar. This opens the "Open" box: Here you select the desired import file. Import files are files which were previously created by exporting an action, and which have an extension "act." Clicking the "Open" button imports the action and then closes the "Open" box. Note: The imported action completely replaces an action that was previously created Setting Dynamics with a Tag Value By clicking the right mouse button on the white light bulb in the "Object Properties" box, you opened a pop-up menu and selected "Tag...". The "Select Tag" box is then opened. Here you select the Tag that you want to use to set the dynamics of the referenced object attribute. The "Select Tag" box is closed and you return to the "Object Properties" box. The previously white light bulb is now green. It shows that a tag was used to set the dynamics in the attribute. The tag name is entered next to the green light bulb. Next, you must set the type of Addressing in the "Object Properties" box WinCC Manual

101 08.97 Graphics Designer There are two addressing methods: Direct addressing. The tag value is assigned to the attribute directly. Indirect addressing. The tag must be a string type and contain, as a value, the name of a tag whose value is assigned to the attribute. The default addressing method is direct. Finally, set the Update Cycle. The default value is 2 seconds. Through the update cycle, you determine the frequency with which the tag value updates the attribute value. This concludes setting the dynamics of the attribute. How to Select a Tag from the "Select Tag" Box: Open the "Select Tag" box. Select the tag either by double clicking the left mouse button on the tag name, or single clicking the left mouse button on the tag name and then clicking the "OK" button. The "Select Tag" box is then closed. You then return to the "Object Properties" box. The tag name is now entered in the object attribute row in the "Dynamic" column. The white light bulb is colored green. How to Select the Method of Addressing: Double click with the left mouse button on the square located in the "Indir." column in the object attribute row. Alternatively, you can open a pop-up menu by clicking the right mouse button on the appropriate square. From this pop-up menu you can select the method of addressing by clicking the right or left mouse button. With an empty square, the addressing method is set to "direct." In the case of indirect addressing, the square contains a check mark. WinCC Manual 3-33

102 Graphics Designer How to Set the Update Cycle: There are two ways to set the update cycle. Click the right mouse button on the "Object Attribute" row and the "Current" column. This opens a pop-up menu with the following preset update cycles: In addition to preset cycle times, you find: Picture Cycle Window Cycle At Change The attribute value is updated when the tag value is changed. User Cycle 1 to User Cycle 5 The times and names are presented as defaults. The times as well as the names can be changed in the WinCC Control Center under "Update Cycles." Using the left or right mouse button, select the desired update cycle from the pop-up menu. This closes the menu and enters the selected value in the "Update" column in the "Object Properties" box. You can also set the update cycle by double clicking the left mouse button to open the "Update" box. The box is located in the "Update" column on the row containing the appropriate object attribute. Open the list here by clicking the left mouse button on the list window or on the button to the right of the list window. Position the entries using the slider and select the update cycle you want by clicking on it with the left mouse button. Clicking on the "OK" button returns you to the "Object Properties" box. The update cycle is now entered WinCC Manual

103 08.97 Graphics Designer Reacting to Events You selected the "Event" tab in the "Object Properties" box and set an object like "Rectangle1." Now select the event category which contains the event for triggering the C function from the left half of the box. This category could be, for example, a "Mouse Event." Click the right mouse button on the white lightning bolt in the "Action" column, for example, on the "Press Left" row. Now the function to be formulated is triggered when the left mouse button is clicked on the "Rectangle1" object. With keystroke events, the function is executed when the event occurs and the "Rectangle1" object is selected. A pop-up menu opens in which you can select any one of the following options: Create the function or edit an existing function (C Action...) Create a direct connection Delete the function (Delete) Select "C Action..." to formulate a new function or to change an already available function. The "Edit Action" box opens. Since you have already set the event, the button is set to inactive in this box. Otherwise, you would use this button to configure the triggering event. Formulate your C function. See also Section , Setting Dynamics with a C Action Note: When you copy the object you just made dynamic in the Graphics Designer, the action that is connected to the object is copied along with it. WinCC Manual 3-35

104 Graphics Designer WinCC Manual

105 08.97 Graphics Designer 4 Appendix This chapter describes the object types (standard objects, smart objects, Windows objects,group objects, and picture objects) of the Graphics Designer with their specific properties (attributes). Then the attributes of the objects are explained (in alphabetical order). The conclusion explains the output formats of the I/O-Field and the assignments of the Text List. Note: The Smart Objects "3D Bar" and "Group Display" are parts of the "Basic Process Control" option package. They are described along with their properties and specific attributes in the WinCC Options Manual. 4.1 Object types and their properties Line Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Line" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Object Name Layer Position X Position Y Width Height Rotation Reference X Rotation Reference Y Rotation Angle Line Color Line Background Color Line Weight Line Style Line End Style Flashing Line Active Flashing Line Color Off Flashing Line Color On Line Flash Frequency Operator-Control Enable Password Display WinCC Manual 4-1

106 Graphics Designer Polygon Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Polygon" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Rotation Reference X Rotation Reference Y Rotation Angle Number of Corners Current Value X Current Value Y Index Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level 4-2 WinCC Manual

107 08.97 Graphics Designer Polyline Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Polyline" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Object Name Layer Position X Position Y Width Height Rotation Reference X Rotation Reference Y Rotation Angle Number of Corners Current Value X Current Value Y Index Line Color Line Background Color Line Weight Line Style Line End Style Flashing Line Active Flashing Line Color Off Flashing Line Color On Line Flash Frequency Operator-Control Enable Password Display WinCC Manual 4-3

108 Graphics Designer Ellipse Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Ellipse" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Radius X Radius Y Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level 4-4 WinCC Manual

109 08.97 Graphics Designer Circle Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Circle" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Radius Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level WinCC Manual 4-5

110 Graphics Designer Ellipse Segment Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Ellipse Segment" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Start Angle End Angle Radius X Radius Y Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level 4-6 WinCC Manual

111 08.97 Graphics Designer Pie Segment Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Pie Segment" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Start Angle End Angle Radius Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level WinCC Manual 4-7

112 Graphics Designer Ellipse Arc Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Ellipse Arc" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Object Name Layer Position X Position Y Width Height Start Angle End Angle Radius X Radius Y Line Color Line Background Color Line Weight Line Style Flashing Line Active Flashing Line Color Off Flashing Line Color On Line Flash Frequency Operator-Control Enable Password Display 4-8 WinCC Manual

113 08.97 Graphics Designer Circular Arc Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Circular Arc" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Object Name Layer Position X Position Y Width Height Start Angle End Angle Radius Line Color Line Background Color Line Weight Line Style Flashing Line Active Flashing Line Color Off Flashing Line Color On Line Flash Frequency Operator-Control Enable Password Display WinCC Manual 4-9

114 Graphics Designer Rectangle Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Rectangle" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level 4-10 WinCC Manual

115 08.97 Graphics Designer Rounded Rectangle Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Rounded Rectangle" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Corner Radius X Corner Radius Y Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level WinCC Manual 4-11

116 Graphics Designer Static Text Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Static Text" object is described using the following properties: Base Geometry Colors Styles Font Flashing Object Name Layer Position X Position Y Width Height Border Color Border Background Color Background Color Fill Pattern Color Font Color Border Weight Border Style Fill Pattern Text Font Font Size Bold Italic Underline Text Orientation X Alignment Y Alignment Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Flashing Text Active Flashing Text Color Off Flashing Text Color On Text Flash Frequency 4-12 WinCC Manual

117 08.97 Graphics Designer Miscellaneous Filling Operator-Control Enable Password Display Tool Tip Text Adapt Border Configured Languages Dynamic Filling Fill Level Note: If the text contains control characters, they are also displayed in the object properties window in the tab labeled "Properties" - Subject "Text" - Attribute "Text" - "Static" (for example, \r\n equals CR/LF). WinCC Manual 4-13

118 Graphics Designer Application Window Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Application Window" object is described using the following attributes: Base Geometry Miscellaneous Object Name Layer Window Contents Template Position X Position Y Window Width Window Height Display Sizable Moveable Border Title Can Be Maximized Can Be Closed Foreground 4-14 WinCC Manual

119 08.97 Graphics Designer Picture Window Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Picture Window" object is described using the following attributes: Base Geometry Miscellaneous Object Name Layer Position X Position Y Window Width Window Height Display Update Cycle Sizable Moveable Border Title Can Be Maximized Can Be Closed Foreground Scroll Bar Adapt Size Adapt Picture Picture Name Picture Offset X Picture Offset Y Scaling Factor WinCC Manual 4-15

120 Graphics Designer OLE Control Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. Only individual standard types can be made dynamic in WinCC. For this reason, WinCC OLE controls provide the attributes which are to be made dynamic as individual attributes. WinCC and OLE control internal mechanisms are used to change that kind of attribute. The "OLE Control" object is described using the following attributes: Base Geometry Miscellaneous Object Name Layer Position X Position Y Width Height Display Operator-Control Enable Server Name OLE Control Properties Notes: The properties "Position X," "Position Y," "Width," "Height," and "View" are determined by the container and are no longer separate in OLE Control. Properties like "Operator-Control Enable," "Password," and "Operator Activities Report" cannot be configured in the container since WinCC does not influence which operation the OLE control passes to its container. Structures cannot be made dynamic. The OLE control object properties must be used for configuration. If you select that kind of attribute in the WinCC object properties, it is triggered by the OLE control and displayed. The changes are accepted as long as the reporting mechanism is implemented in the OLE control WinCC Manual

121 08.97 Graphics Designer OLE Object Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "OLE Object" is described by the following attributes: Base Geometry Miscellaneous Object Name Layer Position X Position Y Width Height Display Operator-Control Enable Server Name Notes: Windows uses a registration database to manage all of the OLE tasks installed on your computer. This database contains all of the information about each OLE task, such as the file name and path of the OLE task. Each time an OLE task is installed, it is automatically registered in the database. If you move or copy an OLE task to another folder manually, it is possible for the entries in the registration database to not be current. In this case, you must process the database with the registration editor. You can receive information about using the registration database from the Help functions of the registration editor. WinCC Manual 4-17

122 Graphics Designer I/O Field Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. You can set some attributes in the configuration dialog if you select this option in the "Options" - "Settings" - "Options" menu. The "I/O Field" object is described using the following attributes: Base Geometry Colors Styles Font Flashing Object Name Layer Position X Position Y Width Height Border Color Border Background Color Background Color Fill Pattern Color Font Color Border Weight Border Style Fill Pattern Font Font Size Bold Italic Underline Text Orientation X Alignment Y Alignment Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Flashing Text Active Flashing Text Color Off Flashing Text Color On Text Flash Frequency 4-18 WinCC Manual

123 08.97 Graphics Designer Miscellaneous Limits Output/Input Operator-Control Enable Password Display Tool Tip Text Operator Activities Report Operator Input Message Adapt Border Cursor Control Immediate Input Low Limit Value High Limit Value Field Type Output Value Data Format Output Format Apply on Full Apply on Exit Clear on New Input Clear on Invalid Input Hidden Input WinCC Manual 4-19

124 Graphics Designer Bar Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. You can set some attributes in the configuration dialog if you select this option in the "Options" - "Settings" - "Options" menu. The "Bar" is described using the following attributes: Base Geometry Colors Styles Font Flashing Object Name Layer Position X Position Y Bar Width Bar Height Bar Direction Border Color Border Background Color Background Color Fill Pattern Color Bar Color Scale Color Bar Background Color Trend Color Border Weight Border Style Fill Pattern Bar Pattern Font Font Size Bold Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency 4-20 WinCC Manual

125 08.97 Graphics Designer Miscellaneous Axis Limits Operator-Control Enable Password Display Tool Tip Text Change Color Maximum Value Zero Point Value Minimum Value Hysteresis Hysteresis Range Trend Average Value Process Driver Connection Scale Alignment Long Axis Sections Label Each Only Long Axis Sections Length of Axis Section Exponent Display Bar Scaling Zero Point Axis Section Scale Marks Digits to the Left of the Decimal Point Digits to the Right of the Decimal Point Limit Marker Monitoring AL Limit AL Bar Color AL Type AL Monitoring WL Limit WL Bar Color WL Type WL Monitoring TL Limit TL Bar Color TL Type TL Monitoring RL4 Limit RL4 Bar Color RL4 Type RL4 Monitoring RL5 Limit RL5 Bar Color RL5 Type RL5 Monitoring AH Limit AH Bar Color AH Type AH WinCC Manual 4-21

126 Graphics Designer Monitoring WH Limit WH Bar Color WH Type WH Monitoring TH Limit TH Bar Color TH Type TH Monitoring RH4 Limit RH4 Bar Color RH4 Type RH4 Monitoring RH5 Limit RH5 Bar Color RH5 Type RH WinCC Manual

127 08.97 Graphics Designer Graphic Object (External Format) Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Graphic Object" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Picture Object Name Layer Position X Position Y Width Height Border Color Border Background Color Background Color Fill Pattern Color Border Weight Border Style Fill Pattern Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Tool Tip Text Dynamic Filling Fill Level Picture Picture Referenced Picture Transparent Color Picture Transparent Color On Note: The graphic files (.bmp,.dip,.emf, and.wmf) for the attribute "Picture" must be located in the GraCS folder of the project path. WinCC Manual 4-23

128 Graphics Designer Status Display Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. You can set some attributes in the configuration dialog if you select this option in the "Options" - "Settings" - "Options" menu. The "Status Display" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Status Object Name Layer Position X Position Y Width Height Border Color Border Background Color Border Weight Border Style Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Operator-Control Enable Password Display Tool Tip Text Current Status Basic Picture Basic Picture Referenced Basic Picture Transparent Color Basic Picture Transparent Color On Flash Picture Flash Picture Referenced Flash Picture Transparent Color Flash Picture Transparent Color On Flash Picture Flash Frequency Flashing Flash Picture Active 4-24 WinCC Manual

129 08.97 Graphics Designer Text List Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. You can set some of the attributes in the configuration dialog if you select the option in the "Options" - "Settings" - "Options" menu. The "Text List"" object is described using the following attributes: Base Geometry Colors Styles Font Object Name Layer Position X Position Y Width Height Border Color Border Background Color Background Color Fill Pattern Color Font Color Selection Font Color Select Text Color Selection Background Color Select Background Color Separation Line Color Separation Line Background Color Border Weight Border Style Fill Pattern Separation Line Weight Separation Line Style Font Font Size Bold Italic Underline Text Orientation X Alignment Y Alignment WinCC Manual 4-25

130 Graphics Designer Flashing Miscellaneous Output/Input Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Flashing Text Active Flashing Text Color Off Flashing Text Color On Text Flash Frequency Operator-Control Enable Password Display Tool Tip Text Operator Activities Report Operator Input Message Adapt Border Cursor Control Immediate Input Language Switch Field Type Output Value List Type Assignments Bit Number Apply on Exit Number of Visible Lines 4-26 WinCC Manual

131 08.97 Graphics Designer Button Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. You can set some attributes in the configuration dialog if you select this option in the "Options" - "Settings" - "Options" menu. The "Button" object is described using the following attributes: Base Geometry Colors Styles Font Flashing Object Name Layer Position X Position Y Width Height Border Color Border Background Color Background Color Fill Pattern Color Font Color 3D Border Color 3D Shadow Color Line Weight Line Style Fill Pattern 3D Border Weight Windows Style Text Font Font Size Bold Italic Underline Text Orientation X Alignment Y Alignment Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Flashing Text Active Flashing Text Color Off Flashing Text Color On Text Flash Frequency WinCC Manual 4-27

132 Graphics Designer Miscellaneous Filling Operator-Control Enable Password Display Tool Tip Text Configured Languages Adapt Border Hot Key Picture Status On Picture Status Off Dynamic Filling Fill Level Notes: The graphic files (.bmp) for the attributes "Picture Status On" and "Picture Status Off" must be located in the GraCS folder of the project path. If you need to use a label with more than one line on a button, use the following trick: 1. Create a "Static Text" object ( ). 2. Create the button ( ). 3. Select "Static Text" and "Button" (multiple selection) and open the "Object Properties" window ( ). 4. In the "Properties" tab, select the "Text" attribute under the "Font" area and double click on the attribute to open the "Text Input" dialog window. 5. Enter the multiple line text. Use the "Shift" + "Enter" keystroke combination to move the cursor to the beginning of the next line. 6. Close the "Text Input" dialog window. 7. Delete the "Static Text" object WinCC Manual

133 08.97 Graphics Designer Check Box Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Check Box" object is described using the following attributes: Base Geometry Colors Styles Font Flashing Object Name Layer Position X Position Y Width Height Number of Boxes Border Color Border Background Color Background Color Fill Pattern Color Font Color Border Weight Border Style Fill Pattern Box Alignment Index Text Font Font Size Bold Italic Underline Text Orientation X Alignment Y Alignment Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Flashing Text Active Flashing Text Color Off Flashing Text Color On Text Flash Frequency WinCC Manual 4-29

134 Graphics Designer Miscellaneous Filling Output/Input Operator-Control Enable Password Display Tool Tip Text Configured Languages Operator Activities Report Operator Input Message Adapt Border Dynamic Filling Fill Level Selected Boxes 4-30 WinCC Manual

135 08.97 Graphics Designer Option Group Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Option Group" object is described using the following attributes: Base Geometry Colors Styles Font Flashing Object Name Layer Position X Position Y Width Height Number of Boxes Border Color Border Background Color Background Color Fill Pattern Color Font Color Border Weight Border Style Fill Pattern Box Alignment Index Text Font Font Size Bold Italic Underline Text Orientation X Alignment Y Alignment Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Flashing Text Active Flashing Text Color Off Flashing Text Color On Text Flash Frequency WinCC Manual 4-31

136 Graphics Designer Miscellaneous Filling Output/Input Operator-Control Enable Password Display Tool Tip Text Configured Languages Operator Activities Report Operator Input Message Adapt Border Dynamic Filling Fill Level Selected Box 4-32 WinCC Manual

137 08.97 Graphics Designer Round Button Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The "Round Button" object is described using the following attributes: Base Geometry Colors Styles Flashing Miscellaneous Filling Object Name Layer Position X Position Y Width Height Radius Border Color Border Background Color Background Color Fill Pattern Color 3D Border Color 3D Shadow Color Border Weight Border Style Fill Pattern 3D Border Weight Latch Down Switch Setting Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency Operator-Control Enable Password Display Dynamic Filling Fill Level WinCC Manual 4-33

138 Graphics Designer Pictures Picture Status Off Picture Off Referenced Picture Off Transparent Color Picture Off Transparent Color On Picture Status On Picture On Referenced Picture On Transparent Color Picture On Transparent Color On Picture Status Deactivated Picture Deact. Referenced Picture Deact. Transparent Color Picture Deact. Transparent Color On Note: The graphic files (.bmp,.dip,.emf, and.wmf) for the attributes "Picture Status Off", "Picture Status On" and "Picture Status Deactivated" must be located in the GraCS folder of the project path WinCC Manual

139 08.97 Graphics Designer Slider Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. You can set some attributes in the configuration dialog if you select this option in the "Options" - "Settings" - "Options" menu. The "Slider" object is described using the following attributes: Base Geometry Colors Styles Flashing Object Name Layer Position X Position Y Width Height Alignment Border Color Border Background Color Background Color Fill Pattern Color High Limit Background Color Low Limit Background Color Button Color High Limit Color Low Limit Color Border Weight Border Style Fill Pattern Border Weight Windows Style Flashing Border Active Flashing Border Color Off Flashing Border Color On Border Flash Frequency Flashing Background Active Flashing Background Color Off Flashing Background Color On Background Flash Frequency WinCC Manual 4-35

140 Graphics Designer Miscellaneous Filling Operator-Control Enable Password Display Tool Tip Text Operator Activities Report Operator Input Message Extended Operation Maximum Value Minimum Value Operation Steps Process Driver Connection Dynamic Filling Fill Level Note: You can configure an outline for the slider ("Border Weight" and "Background Color" attributes). The size of the object remains the same and the slider is reduced appropriately. In addition, you can configure another border inside the border ("Border Weight" and "Border Color"). The border is displayed at the maximum width of the outline even if you configured a larger value WinCC Manual

141 08.97 Graphics Designer Group Properties All of the object attributes belonging to the selected object are displayed in the "Object Properties" window in the "Properties" tab. The standard attributes of the group and the combined amount of the attributes of all of the subobjects are listed. Each attribute appears only once. The following attributes are always present in a "Group Object": Base Geometry Miscellaneous User-Defined Object Name Layer Position X Position Y Width Height Operator-Control Enable Password Display Attributes from Other Subjects WinCC Manual 4-37

142 Graphics Designer Picture Properties All of the object attributes are displayed in the "Object Properties" window in the "Properties" tab. The "Picture" object is described using the following attributes: Geometry Colors Styles Miscellaneous Picture Width Picture Height Grid On Grid Width Grid Height Background Color Fill Pattern Color Grid Color Fill Pattern Operator-Control Enable Password Display Update Cycle Date of Last Change Cursor Mode 4-38 WinCC Manual

143 08.97 Graphics Designer 4.2 Attributes in Alphabetical Order The attributes (properties) of the various object types are divided into topic groups. Each object includes the topics with properties that are specific to that object type. This means that each object does not possess all of the available attributes. The following is an alphabetical listing of all of the available attributes without their object assignment. The OLE automation name is also provided under the attribute name. In addition to an explanation of the attribute, the listing also indicates whether you can make that attribute dynamic. 3D Border Color BorderColorTop Set the color for the left and top part of the 3D border. The 3D Border Color can be made dynamic with the name BorderColorTop. 3D Border Weight BackBorderWidth Set the weight of the 3D border. The 3D Border Weight attribute can be made dynamic with the name BackBorderWidth. 3D Shadow Color BorderColorBottom Set the color for the right and bottom part of the 3D border. The 3D Shadow Color attribute can be made dynamic with the name BorderColorBottom. Adapt Border AdaptBorder Select whether the border should be dynamically fitted to the text size in objects that contain text. If the contents of the box are changed dynamically, the size of the box changes. The Adapt Border attribute cannot be made dynamic. Adapt Picture AdaptPicture Set the picture size to fit the window size. The Adapt Picture attribute cannot be made dynamic. Adapt Size AdaptSize Set the window size to fit the picture size. The Adapt Size attribute cannot be made dynamic. WinCC Manual 4-39

144 Graphics Designer Alignment Alignment Direction Bar: Set the alignment of the scale (left/right or top/bottom) with a bar. With bars, bar scaling is only visible when scaling is active. The Alignment attribute can be made dynamic with the name Alignment. Slider: Set the location of the slider (horizontal/vertical) with a slider object. The Alignment attribute can be made dynamic with the name Direction. Apply on Exit AssumeOnExit Set the system to accept the input as soon as the field is exited (using the Tab key or a mouse click). This attribute is only relevant for input fields and for combined I/O fields. The Apply on Exit attribute can be made dynamic with the name AssumeOnExit. Apply on Full AssumeOnFull Set the system to automatically (without Tab or Return key) exit the input field and accept the input as soon as the input has been completed (the specified number of characters were entered). This attribute is only relevant for input fields and for combined I/O fields. The Apply on Full attribute can be made dynamic with the name AssumeOnFull. Assignments Assignments Average Value Average Set the connections between the output value and the text that is to be actually output. The assignments depend on the list type that is set. The Assignments attribute cannot be made dynamic. Set whether the last 15 values should be averaged. The Average Value attribute can be made dynamic with the name Average. Axis Section AxisSection Set the units of measurement on the axis. The size of the units depends on the "Long Axis Sections" attribute. The Axis Section attribute can be made dynamic with the name AxisSection. Background Color BackColor Set the background color of the object. The background color is only displayed when the object is at least partially filled. The Background Color attribute can be made dynamic with the name BackColor WinCC Manual

145 08.97 Graphics Designer Background Flash Frequency FlashRateBackColor Set the flash frequency for the background. You can set the frequency to slow (approximately 0.5 Hz), medium (approximately 2 Hz), and fast (approximately 8 Hz). Since flashing is implemented by means of software, the frequency is systemand hardware-dependent (number of objects, processor, memory, update cycle, and more). The Background Flash Frequency attribute can be made dynamic with the name FlashRateBackColor. Bar Background Color BackColor3 Set the color of the bar background. The Bar Background Color attribute can be made dynamic with the name BackColor3. Bar Color BackColor2 Set the color of the bar for displaying the current value. The Bar Color attribute can be made dynamic with the name BackColor2. Bar Color AH ColorAlarmHigh Set the color for the limit value of "alarm high." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color AH attribute can be made dynamic with the name ColorAlarmHigh. Bar Color AL ColorAlarmLow Set the color for the limit value for "alarm low." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color AL attribute can be made dynamic with the name ColorAlarmLow. Bar Color RH4 ColorLimitHigh4 Set the color for the high limit value of "reserve 4." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color RH4 attribute can be made dynamic with the name ColorLimitHigh4. Bar Color RH5 ColorLimitHigh5 Set the color for the high limit of "reserve 5." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color RH5 attribute can be made dynamic with the name ColorLimitHigh5. WinCC Manual 4-41

146 Graphics Designer Bar Color RL4 ColorLimitLow4 Set the color for the low limit value of "reserve 4." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color RL4 attribute can be made dynamic with the name ColorLimitLow4. Bar Color RL5 ColorLimitLow5 Set the color for the low limit value of "reserve 5." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color RL5 attribute can be made dynamic with the name ColorLimitLow5. Bar Color TH ColorToleranceHigh Set the color for the limit value of "tolerance high." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color TH attribute can be made dynamic with the name ColorToleranceHigh. Bar Color TL ColorToleranceLow Set the color for the limit value "tolerance low." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color TL attribute can be made dynamic with the name ColorToleranceLow. Bar Color WH ColorWarningHigh Set the color for the limit value of "warning high." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color WH attribute can be made dynamic with the name ColorWarningHigh. Bar Color WL ColorWarningLow Set the color for the limit value "warning low." If the monitor function for the limit value is active, the bar will take on the color specified in this attribute when the limit value is reached. The Bar Color WL attribute can be made dynamic with the name ColorWarningLow. Bar Direction Direction Set the positive bar axis. The Bar Direction attribute can be made dynamic with the name Direction WinCC Manual

147 08.97 Graphics Designer Bar Height Height Set the height of the bar in pixels. The Bar Height attribute can be made dynamic with the name Height. Bar Pattern FillStyle2 Set the fill pattern of the bar. You can select a pattern from the selection dialog box. The Bar Pattern attribute can be made dynamic with the name FillStyle2. Bar Scaling ScalingType Set the type of bar scaling (linear, logarithmic, or automatic). The bar scaling is only visible when the "Scale" attribute is active. The Bar Scaling attribute can be made dynamic with the name ScalingType. Bar Width Width Set the width of the bar in pixels. The Bar Width attribute can be made dynamic with the name Width. Basic Picture BasePicture Set the basic picture for the status display. Depending on the "Basic Picture Referenced" attribute, the entire object or only the object reference is stored. The corresponding status is selected by means of the "Current Status" attribute. The Basic Picture attribute cannot be made dynamic. Basic Picture Referenced BasePicReferenced Determine whether the assigned picture is stored in the status display object or only the corresponding object reference is stored. The Basic Picture Referenced attribute cannot be made dynamic. Basic Picture Transparent Color BasePicTransColor Determine which color of the assigned bitmap object (.bmp,.dib) should be set to "transparent". The attribute is analyzed only if the "Basic Picture Transparent Color On" attribute is activated. The Basic Picture Transparent Color attribute can be made dynamic with the name BasePicTransColor. Basic Picture Transparent Color On BasePicUseTransColor Use this attribute to specify whether the "Transparent Color" function should be used. This function is only available for bitmap objects (.bmp,.dib). The Basic Picture Transparent Color On attribute can be made dynamic with the name BasePicUseTransColor. WinCC Manual 4-43

148 Graphics Designer Bit Number BitNumber Set the number of the relevant bit in the output value. This attribute is used only with the "bit" list type. The Bit Number attribute can be made dynamic with the name BitNumber. Bold FontBold Set the text attribute Bold for the text in the object. The Bold attribute can be made dynamic with the name FontBold. Border WindowBorder Determine whether the windows should be displayed with borders. The Border attribute cannot be made dynamic. Border Background Color BorderBackColor Set the background color of the border of the object. The background color is only visible when the border is not a solid line ("Border Style" attribute). The Border Background Color attribute can be made dynamic with the name BorderBackColor. Border Color BorderColor Set the border color of the object. The Border Color attribute can be made dynamic with the name BorderColor. Border Flash Frequency FlashRateBorderColor Set the flash frequency for the border. You can set the frequency to slow (approximately 0.5 Hz), medium (approximately 2 Hz), and fast (approximately 8 Hz). Since flashing is implemented by means of software, the frequency is systemand hardware-dependent (number of objects, processor, memory, update cycle, and more). The Border Flash Frequency attribute can be made dynamic with the name FlashRateBorderColor. Border Style BorderStyle Set the style of the border of the object. If you select the border styles "dash," "dot," "dash dot," or "dash dot dot," a weight of 1 pixel is displayed independent of the selected border weight. The Border Style attribute can be made dynamic with the name BorderStyle WinCC Manual

149 08.97 Graphics Designer Border Weight BorderWidth Set the weight of the border of the object. If you select the border styles "dash," "dot," "dash dot," or "dash dot dot," a weight of 1 pixel is displayed independent of the selected border weight. The Border Weight attribute can be made dynamic with the name BorderWidth. Border Weight BackBorderWidth Set the weight of the slider border in pixels. This value contains the possibly available border weight (a value of 0 means the border is not displayed). The Border Weight attribute can be made dynamic with the name BackBorderWidth. Box Alignment BoxAlignment Set whether the boxes (for example, in the option group or check box) should be aligned left or aligned right. The Box Alignment attribute can be made dynamic with the name BoxAlignment. Button Color ButtonColor Set the color of the button or the slider. The Button Color attribute can be made dynamic with the name ButtonColor. Can Be Closed CloseButton Determine whether the window can be closed. This attribute is not analyzed unless the "Title" attribute is active. The Can Be Closed attribute cannot be made dynamic. Can Be Maximized MaximizeButton In the case of window objects, determine whether the window can be enlarged to the maximum screen size. This attribute is not analyzed unless the "Title" attribute is active. The Can Be Maximized attribute cannot be made dynamic. Change Color ColorChangeType Set whether a color change (for example, when a limit is reached) is carried out in individual segments or in the entire bar. The Change Color attribute can be made dynamic with the name ColorChangeType. WinCC Manual 4-45

150 Graphics Designer Clear on Invalid Input ClearOnError Set the field entry in the input field to be deleted automatically when there is an invalid input. This attribute is only relevant for input fields and for combined I/O fields. The Clear on Invalid Input attribute can be made dynamic with the name ClearOnError. Clear on New Input ClearOnNew Set the field entry in the input field to be deleted at startup. This attribute is only relevant for input fields and for combined I/O fields. The Clear on New Input attribute can be made dynamic with the name ClearOnNew. Configured Languages DataLanguage Set the language for the input in the text object. The Configured Languages attribute cannot be made dynamic. Corner Radius X RoundCornerWidth Set the corner radius for a rounded rectangle. This value is a percentage of half the width of the object. The Corner Radius X attribute can be made dynamic with the name RoundCornerWidth. Corner Radius Y RoundCornerHeight Set the corner radius for a rounded rectangle. This value is a percentage of half the height of the object. The Corner Radius Y attribute can be made dynamic with the name RoundCornerHeight. Current Status Index Select the status (0 to ) for the status display object type for which you want to set the associated attributes for displaying the "Basic Picture" and the "Flash Picture." The Current Status attribute can be made dynamic with the name Index. Current Value X ActualPointLeft Set the current horizontal position of the corner point for polygon and polyline object types in relation to the origin of the picture. The corner is set by the index. Changing this setting also affects the "Position X" and "Width" attributes. The Current Value X attribute can be made dynamic with the name ActualPointLeft WinCC Manual

151 08.97 Graphics Designer Current Value Y ActualPointTop Set the current vertical position of the corner point for polygon and polyline object types in relation to the origin of the picture. The corner is set by the index. Changing this setting also affects the "Position Y" and "Height" attributes. The Current Value Y attribute can be made dynamic with the name ActualPointTop. Cursor Control CursorControl Set an alpha cursor to jump to the next box in the tab sequence after exiting the current box. Use the "Cursor Mode" attribute to determine whether a tab order or an alpha cursor sequence should be active. The Cursor Control attribute can be made dynamic with the name CursorControl. Cursor Mode CursorMode Set the type of cursor (tab order or alpha cursor). The Cursor Mode attribute cannot be made dynamic. Data Format DataFormat Set the data type (binary, decimal, hexadecimal, or string) of the contents of the box. The Data Format attribute cannot be made dynamic. Date of Last Change LastChange Set the last valid change date of the picture object. The Date of Last Change attribute cannot be made dynamic. Digits to the Left of the Decimal Point LeftComma Set the number of digits to the left of the decimal point (0 to 20). The Digits to the Left of the Decimal Point attribute can be made dynamic with the name LeftComma. Digits to the Right of the Decimal Point RightComma Set the number of digits to the right of the decimal point (0 to 20). The Digits to the Right of the Decimal Point attribute can be made dynamic with the name RightComma. Display Visible This attribute determines whether the object is visible or invisible. The Display attribute can be made dynamic with the name Visible. Dynamic Filling Filling Determine whether an object with a solid border (rectangle, rounded rectangle, circle, ellipse, pie segment, ellipse segment, polygon, text, I/0 field, and others) can be filled. The Dynamic Filling attribute can be made dynamic with the name Filling. WinCC Manual 4-47

152 Graphics Designer End Angle EndAngle Set the ending point for the segment and arc object types. The input is clockwise in degrees, starting with 12 o clock. The End Angle attribute can be made dynamic with the name EndAngle. Exponent Display Exponent Specify whether the number display should be with exponents. The Exponent Display attribute can be made dynamic with the name Exponent. Extended Operation ExtendedOperation Allow the slider to be set to a new appropriate limit value (minimum value/maximum value) by clicking on the area outside of the current slider setting. The Extended Operation attribute can be made dynamic with the name ExtendedOperation. Field Type BoxType Set the field type (input, output, or combined I/O field). The Field Type attribute can be made dynamic with the name BoxType. Fill Level FillingIndex Set the percentage value (relative to the height of the object) to which an object with a solid border (rectangle, rounded rectangle, circle, ellipse, polygon, text, I/O field, and others) can be filled. The "Fill Color" is set under the "Colors" topic. The Fill Level attribute can be made dynamic with the name FillingIndex. Fill Pattern FillStyle Set the fill pattern of the object. You can select a fill pattern from the style palette or the selection dialog box. The Fill Pattern attribute can be made dynamic with the name FillStyle. Fill Pattern Color FillColor Set the fill pattern color of the object. The Fill Pattern Color attribute can be made dynamic with the name FillColor. Flash Picture FlashPicture Set the flash picture for the status display. Depending on the "Flash Picture Referenced" attribute, the entire object or only the object reference is stored. The corresponding status is selected by means of the "Current Status" attribute. The Flash Picture attribute cannot be made dynamic WinCC Manual

153 08.97 Graphics Designer Flash Picture Flash Frequency FlashRateFlashPic Set the flash frequency for the flashing picture. You can set the frequency to slow (approximately 0.5 Hz), medium (approximately 2 Hz), and fast (approximately 8 Hz). Since flashing is implemented by means of software, the frequency is systemand hardware-dependent (number of objects, processor, memory, update cycle, and more). The Flash Picture Flash Frequency attribute can be made dynamic with the name FlashRateFlashPic. Flash Picture Referenced FlashPicReferenced Determine whether the assigned picture is stored in the status display object or only the corresponding object reference is stored. The Flash Picture Referenced attribute cannot be made dynamic. Flash Picture Transparent Color FlashPicTransColor Determine which color of the assigned bitmap object (.bmp,.dib) should be set to "transparent". The attribute is analyzed only if the "Flash Picture Transparent Color On" attribute is activated. The Flash Picture Transparent Color can be made dynamic with the name FlashPicTransColor. Flash Picture Transparent Color On FlashPicUseTransColor Use this attribute to specify whether the "Transparent Color" function should be used. This function is only available for bitmap objects (.bmp,.dib). The Flash Picture Transparent Color On attribute can be made dynamic with the name FlashPicUseTransColor. Flashing Background Active FlashBackColor Activate the background flashing. The Flashing Background Active attribute can be made dynamic with the name FlashBackColor. Flashing Background Color Off BackFlashColorOff Set the background color when flashing is switched off. The Flashing Background Color Off attribute can be made dynamic with the name BackFlashColorOff. Flashing Background Color On BackFlashColorOn Set the background color when flashing is switched on. The Flashing Background Color On attribute can be made dynamic with the name BackFlashColorOn. Flashing Border Active FlashBorderColor Activate the border flashing. The Flashing Border Active attribute can be made dynamic with the name FlashBorderColor. WinCC Manual 4-49

154 Graphics Designer Flashing Border Color Off BorderFlashColorOff Set the color for the border when flashing is switched off. The Flashing Border Color Off attribute can be made dynamic with the name BorderFlashColorOff. Flashing Border Color On BorderFlashColorOn Set the color of the border when flashing is switched on. The Flashing Border Color On attribute can be made dynamic with the name BorderFlashColorOn. Flashing Flash Picture Active FlashFlashPicture Activate the flashing of the flash picture. The Flashing Flash Picture Active attribute can be made dynamic with the name FlashFlashPicture. Flashing Line Active FlashBorderColor Activate the line flashing. The Flashing Line Active attribute can be made dynamic with the name FlashBorderColor. Flashing Line Color Off BorderFlashColorOff Set the color for the line when flashing is switched off. The Flashing Line Color Off attribute can be made dynamic with the name BorderFlashColorOff. Flashing Line Color On BorderFlashColorOn Set the color for the line when flashing is switched on. The Flashing Line Color On attribute can be made dynamic with the name BorderFlashColorOn. Flashing Text Active FlashForeColor Activate the text flashing. The Flashing Text Active attribute can be made dynamic with the name FlashForeColor. Flashing Text Color Off ForeFlashColorOff Set the text color when flashing is switched off. The Flashing Text Color Off attribute can be made dynamic with the name ForeFlashColorOff. Flashing Text Color On ForeFlashColorOn Set the text color when flashing is switched on. The Flashing Text Color On attribute can be made dynamic with the name ForeFlashColorOn. Font FontName Set the type style of the text in the object. All of the fonts installed in Windows are available to you for this selection. The Font attribute can be made dynamic with the name FontName WinCC Manual

155 08.97 Graphics Designer Font Color ForeColor Set the color of the text in the object. The Font Color attribute can be made dynamic with the name ForeColor. Font Size FontSize Set the font size for the text in the object. The input is in point size (pt.), and you can enter any given value. The Font Size attribute can be made dynamic with the name FontSize. Foreground OnTop Set whether the window should always be in the foreground. When there are multiple windows in the foreground, these are to be arranged so that they do not overlap each other. If the windows would overlap, they should not be open at the same time. The Foreground attribute cannot be made dynamic. Grid Color GridColor Set the grid color for the configuration phase. The grid is only displayed during the configuration phase. The Grid Color attribute cannot be made dynamic. Grid Height GridHeight Set the grid height (in pixels) in the picture for the configuration phase. The grid is only displayed during the configuration phase. The Grid Height attribute cannot be made dynamic. Grid On Grid Set whether the grid is displayed in the picture for the configuration phase. The grid is only displayed during the configuration phase. The Grid On attribute cannot be made dynamic. Grid Width GridWidth Set the grid width (in pixels) in the picture for the configuration phase. The grid is only displayed during the configuration phase. The Grid Width attribute cannot be made dynamic. Height Height Set the height of the object in pixels. The Height attribute can be made dynamic with the name Height. Hidden Input HiddenInput Hide the input value during input. An asterisk (*) is displayed for each character. This attribute is only relevant for input fields and for combined I/O fields. The Hidden Input attribute can be made dynamic with the name HiddenInput. WinCC Manual 4-51

156 Graphics Designer High Limit Background Color BackColorTop Set the color for the top/left part of the slider. The High Limit Background Color attribute can be made dynamic with the name BackColorTop. High Limit Color ColorTop Set the color for the top/left slider position. The High Limit Color attribute can be made dynamic with the name ColorTop. High Limit Value LimitMax Set the high limit value for I/O fields as an absolute value dependent on the data format. If the value to be displayed is higher than the high limit value, it is identified with a sequence of ***, showing that it cannot be displayed. The High Limit Value attribute can be made dynamic with the name LimitMax. Hot Key Hotkey Set the key or keystroke combination for a mouse operation in a button. The Hot Key attribute cannot be made dynamic. Hysteresis Hysteresis Set whether the display should occur with hysteresis. Set the hysteresis value with the "Hysteresis Range" attribute. The Hysteresis attribute can be made dynamic with the name Hysteresis. Hysteresis Range HysteresisRange Set the hysteresis as a percent of the display value. The calculation is carried out only when the hysteresis has been enabled with the "Hysteresis" attribute. The Hysteresis Range attribute can be made dynamic with the name HysteresisRange. Immediate Input EditAtOnce Set the ability to make an input immediately upon accessing the I/O field with the Tab key, without having to carry out any further action. The Immediate Input attribute can be made dynamic with the name EditAtOnce WinCC Manual

157 08.97 Graphics Designer Index Index Polygon and Polyline: Enter the number of the corner whose current X or Y value you want to define relative to the origin of the picture. The Index attribute can be made dynamic with the name Index. Check Box and Option Group: Input the number (1 to 32) of the box whose text you want to define. The Index attribute can be made dynamic with the name Index. Italic FontItalic Set the text attribute Italic for the text in the object. The Italic attribute can be made dynamic with the name FontItalic. Label Each LongStrokesTextEach Determine which sections of the scale representation should be labeled (each one, every other one, every third, etc.). The Label Each attribute cannot be made dynamic. Language Switch LanguageSwitch Determine if the text list objects should be configured in multiple languages or not. The Language Switch attribute cannot be made dynamic. Latch Down Toggle Ensure that the "pressed" and "not pressed" switch settings for round button object types can be latched down. The Latch Down attribute can be made dynamic with the name Toggle. Layer Layer Set the location of the object in the picture. There are 16 layers available (0 to 15). Objects in layer 0 are completely in the background and objects in layer 15 are completely in the foreground. Within the layer, the objects which were configured first are in the background. You can also change the location of the elements using the Arrange - Within a Layer menu item. When configuring pictures, you can remove layers and thus make those objects visible which are located in a deeper layer and are hidden by objects in a higher layer. The Layer attribute cannot be made dynamic. Length of Axis Section LongStrokesSize Set the length (in pixels) of the axis sections ("Long Strokes" attribute). The Length of Axis Section attribute can be made dynamic with the name LongStrokesSize. WinCC Manual 4-53

158 Graphics Designer Limit AH AlarmHigh Set the limit value for "alarm high." Determine the type of analysis (percentage or absolute) with the "Alarm High Type" attribute. The limit value is monitored only when the value is active. The Limit AH attribute can be made dynamic with the name AlarmHigh. Limit AL AlarmLow Set the limit value for "alarm low." Determine the type of analysis (percentage or absolute) with the "Alarm Low Type" attribute. The limit value is monitored only when the value is active. The Limit AL attribute can be made dynamic with the name AlarmLow. Limit Marker Marker Determine whether the limit value should be displayed as a scale value in the bar representation. The Limit Marker attribute can be made dynamic with the name Marker. Limit RH4 LimitHigh4 Set the high limit value for "reserve 4." Determine the type of analysis (percentage or absolute) with the "Reserve 4 High Type" attribute. The limit value is monitored only when the value is active. The Limit RH4 attribute can be made dynamic with the name LimitHigh4. Limit RH5 LimitHigh5 Set the high limit for "reserve 5." Determine the type of analysis (percentage or absolute) with the "Reserve 5 High Type" attribute. The limit value is monitored only when the value is active. The Limit RH5 attribute can be made dynamic with the name LimitHigh5. Limit RL4 LimitLow4 Set the low limit value for "reserve 4." Determine the type of analysis (percentage or absolute) with the "Reserve 4 Low Type" attribute. The limit value is monitored only when the value is active. The Limit RL4 attribute can be made dynamic with the name LimitLow WinCC Manual

159 08.97 Graphics Designer Limit RL5 LimitLow5 Set the low limit value for "reserve 5." Determine the type of analysis (percentage or absolute) with the "Reserve 5 Low Type" attribute. The limit value is monitored only when the value is active. The Limit RL5 attribute can be made dynamic with the name LimitLow5. Limit TH ToleranceHigh Set the limit value for "tolerance high." Determine the type of analysis (percentage or absolute) with the "Tolerance High Type" attribute. The limit value is monitored only when the value is active. The Limit TH attribute can be made dynamic with the name ToleranceHigh. Limit TL ToleranceLow Set the limit value for "tolerance low." Determine the type of analysis (percentage or absolute) with the "Tolerance Low Type" attribute. The limit value is monitored only when the value is active. The Limit TL attribute can be made dynamic with the name ToleranceLow. Limit WH WarningHigh Set the limit value for "warning high." Determine the type of analysis (percentage or absolute) with the "Warning High Type" attribute. The limit value is monitored only when the value is active. The Limit WH attribute can be made dynamic with the name WarningHigh. Limit WL WarningLow Set the limit for "warning low." Determine the type of analysis (percentage or absolute) with the "Warning Low Type" attribute. The limit value is monitored only when the value is active. The Limit WL attribute can be made dynamic with the name WarningLow. Line Background Color BorderBackColor Set the background color of the line of the object. The background color is only visible when the line is not solid ("Line Style" attribute). The Line Background Color attribute can be made dynamic with the name BorderBackColor. WinCC Manual 4-55

160 Graphics Designer Line Color BorderColor Set the color of the line of the object. The Line Color attribute can be made dynamic with the name BorderColor. Line End Style BorderEndStyle Select the line end style (rounded, start arrow, angled arrow, etc.) for the object. The Line End Style attribute can be made dynamic with the name BorderEndStyle. Line Flash Frequency FlashRateBorderColor Set the flash frequency for the line. You can set the frequency to slow (approximately 0.5 Hz), medium (approximately 2 Hz), and fast (approximately 8 Hz). Since flashing is implemented by means of software, the frequency is systemand hardware-dependent (number of objects, processor, memory, update cycle, and more). The Line Flash Frequency attribute can be made dynamic with the name FlashRateBorderColor. Line Style BorderStyle Set the line style of the object. If you select the line styles "dash," "dot," "dash dot," or "dash dot dot," a weight of 1 pixel is displayed independent of the selected line weight. The Line Style attribute can be made dynamic with the name BorderStyle. Line Weight BorderWidth Set the weight of the line of the object. If you select the line styles "dash," "dot," "dash dot," or "dash dot dot," a weight of 1 pixel is displayed independent of the selected line weight. The Line Weight attribute can be made dynamic with the name BorderWidth. List Type ListType Set the type of text list (decimal, binary, or bit). The List Type attribute cannot be made dynamic. Long Axis Sections LongStrokesBold Set whether the long axis sections in the scale representation should be displayed as bold or normal. The Long Axis Sections attribute can be made dynamic with the name LongStrokesBold. Low Limit Background Color BackColorBottom Set the color for the bottom/right part of the slider. The Low Limit Background Color attribute can be made dynamic with the name BackColorBottom WinCC Manual

161 08.97 Graphics Designer Low Limit Color ColorBottom Set the color for the bottom/right slider position. The Low Limit Color attribute can be made dynamic with the name ColorBottom. Low Limit Value LimitMin Set the low limit value for I/O fields as an absolute value dependent on the data format. If the value to be displayed is lower than the low limit value, it is identified with a sequence of ***, showing that it cannot be displayed. The Low Limit Value attribute can be made dynamic with the name LimitMin. Maximum Value Max Set the absolute value for a full value view. If the scale view is active, this value is displayed. The Maximum Value attribute can be made dynamic with the name Max. Minimum Value Min Set the absolute value for the smallest value view. If the scale view is active, this value is displayed. The Minimum Value attribute can be made dynamic with the name Min. Monitoring AH CheckAlarmHigh Determine whether the limit value for "alarm high" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit AH", "Bar Color AH", and "Type AH"). The Monitoring AH attribute can be made dynamic with the name CheckAlarmHigh. Monitoring AL CheckAlarmLow Determine whether the limit value for "alarm low" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit AL", "Bar Color AL", and "Type AL"). The Monitoring AL attribute can be made dynamic with the name CheckAlarmLow. Monitoring RH4 CheckLimitHigh4 Determine whether the high limit value for "reserve 4" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit RH4", "Bar Color RH4", and "Type RH4"). The Monitoring RH4 attribute can be made dynamic with the name CheckLimitHigh4. WinCC Manual 4-57

162 Graphics Designer Monitoring RH5 CheckLimitHigh5 Determine whether the high limit value for "reserve 5" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit RH5", "Bar Color RH5", and "Type RH5"). The Monitoring RH5 attribute can be made dynamic with the name CheckLimitHigh5. Monitoring RL4 CheckLimitLow4 Determine whether the low limit value for "reserve 4" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit RL4", "Bar Color RL4", and "Type RL4"). The Monitoring RL4 attribute can be made dynamic with the name CheckLimitLow4. Monitoring RL5 CheckLimitLow5 Determine whether the low limit value for "reserve 5" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes (("Limit RL5", "Bar Color RL5", and "Type RL5"). The Monitoring RL5 attribute can be made dynamic with the name CheckLimitLow5. Monitoring TH CheckToleranceHigh Determine whether the limit value for "tolerance high" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit TH", "Bar Color TH", and "Type TH"). The Monitoring TH attribute can be made dynamic with the name CheckToleranceHigh. Monitoring TL CheckToleranceLow Determine whether the limit value for "tolerance low" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit TL", "Bar Color TL", and "Type TL"). The Monitoring TL attribute can be made dynamic with the name CheckToleranceLow. Monitoring WH CheckWarningHigh Determine whether the limit value for "warning high" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit WH", "Bar Color WH", and "Type WH"). The Monitoring WH attribute can be made dynamic with the name CheckWarningHigh WinCC Manual

163 08.97 Graphics Designer Monitoring WL CheckWarningLow Determine whether the limit value for "warning low" should be monitored. The limit value, the representation upon reaching the limit value, and the type of analysis are set in three supplemental attributes ("Limit WL", "Bar Color WL", and "Type WL"). The Monitoring WL attribute can be made dynamic with the name CheckWarningLow. Moveable Moveable Determine whether a window can be moved. The Moveable attribute cannot be made dynamic. Number of Boxes BoxCount Determine how many boxes are available for multiple or single selection in the Windows objects check box and option group. The Number of Boxes attribute can be made dynamic with the name BoxCount. Number of Corners PointCount Set the number of corners for the polygon and polyline object types. The Number of Corners attribute cannot be made dynamic. Number of Visible Lines NumberLines Set the number of lines the selection list of a text list object should contain. If the amount of configured text is larger than this value, the selection list receives a vertical scroll bar. The Number of Visible Lines attribute can be made dynamic with the name NumberLines. Object Name ObjectName Set the name of the object. The object name is unique within a picture. During script configuration or WinCC-API calls, the object is addressed using this unique name. The object name cannot contain any of the following characters: "\", "/", ":" and ".". Leading and trailing blank spaces are deleted by the system. The Object Name attribute cannot be made dynamic. Only Long Axis Sections LongStrokesOnly Set whether the long axis sections alone or both sections should be displayed in the scale representation. The Only Long Axis Sections attribute can be made dynamic with the name LongStrokesOnly. Operation Steps SmallChange Set the number of steps the slider can be moved with a mouse click. The Operation Steps attribute can be made dynamic with the name SmallChange. WinCC Manual 4-59

164 Graphics Designer Operator Activities Report OperationReport This attribute determines whether the reason for operator activity needs to be reported. When you select the Yes option, a dialog box appears when there is operator activity in an object. The user can input the reason for the activity as text in the dialog box. The operator activity is then sent to the diagnostics system and archived by it. The Operator Activities Report attribute can be made dynamic with the name OperationReport. Operator-Control Enable Operation Specify whether the object can be controlled. In order for you to actually be able to control the object, you must also have authorization ("Password" attribute) to control the object. The Operator-Control Enable attribute can be made dynamic with the name Operation. Operator Input Message OperationMessage Determine whether a message should be output when an operation is successfully carried out. The operator activity is then sent to the diagnostics system. That system determines whether a message system is available which could issue a message in a message line, for example. The Operator Input Message attribute can be made dynamic with the name OperationMessage. Output Format OutputFormat Set the way in which the output value is represented. The representation is dependent on the data format. The Output Format attribute cannot be made dynamic. Output Value OutputValue Set the defaults for the value to be displayed. This value is used in RUNTIME mode when the corresponding tag is not connected or not updated when the picture starts. The Output Value attribute can be made dynamic with the name OutputValue. Password PasswordLevel Set the authorization level for controlling this object (no input = no triggering of actions). You can set an authorization level (password) for each controllable object. The operator-control authorizations for each user are stored in a user-specific system entry. If 0 is entered as the value for the Password Attribute, there are no user limits set. The Password attribute can be made dynamic with the name PasswordLevel WinCC Manual

165 08.97 Graphics Designer Picture PictureName Set the picture (external format) to be displayed in the graphics object. Depending on the "Picture Referenced" attribute, the entire object or the object reference is saved. The Picture attribute can be made dynamic with the name PictureName. Picture Deact. Referenced PicDeactReferenced Determine whether the picture assigned to the Deactivated state is stored in the object or only the corresponding object reference is stored. The Picture Deact. Referenced attribute cannot be made dynamic. Picture Deact. Transparent Color PicDeactTransparent Determine which color of the assigned bitmap object (.bmp,.dib) should be set to "transparent." The attribute is analyzed only if the "Picture Deact. Transparent Color On" attribute is activated. The Picture Deact. Transparent Color attribute can be made dynamic with the name PicDeactTransparent. Picture Deact. Transparent Color On PicDeactUseTransColor Use this attribute to specify whether the "Transparent Color" function should be used. This function is only available for bitmap objects (.bmp,.dib). The Picture Deact. Transparent Color On attribute can be made dynamic with the name PicDeactUseTransColor. Picture Height Height Set the picture height in pixels. The default value is 600. The input can be larger than the maximum resolution of the screen. You can shift the picture using the slider. The Picture Height attribute can be made dynamic with the name Height. Picture Name PictureName Set the name of the picture to be displayed. The Picture Name attribute can be made dynamic with the name PictureName. Picture Off Referenced PicUpReferenced Determine whether the picture assigned to the Off state is stored in the object or only the corresponding object reference is stored. The Picture Off Referenced attribute cannot be made dynamic. Picture Off Transparent Color PicUpTransparent Determine which color of the assigned bitmap object (.bmp,.dib) should be set to "transparent". The attribute is analyzed only if the "Picture Off Transparent Color On" attribute is activated. The Picture Off Transparent Color attribute can be made dynamic with the name PicUpTransparent. WinCC Manual 4-61

166 Graphics Designer Picture Off Transparent Color On PicUpUseTransColor Use this attribute to specify whether the "Transparent Color" function should be used. This function is only available for bitmap objects (.bmp,.dib). The Picture Off Transparent Color On attribute can be made dynamic with the name PicUpUseTransColor. Picture Offset X OffsetLeft Set the horizontal distance of the picture from the left edge of the window. The Picture Offset X attribute can be made dynamic with the name OffsetLeft. Picture Offset Y OffsetTop Set the vertical distance of the picture from the top edge of the window. The Picture Offset Y attribute can be made dynamic with the name OffsetTop. Picture On Referenced PicDownReferenced Determine whether the picture assigned to the On state is stored in the object or only the corresponding object reference is stored. The Picture On Referenced attribute cannot be made dynamic. Picture On Transparent Color PicDownTransparent Determine which color of the assigned bitmap object (.bmp,.dib) should be set to "transparent". The attribute is analyzed only if the "Picture On Transparent Color On" attribute is activated. The Picture On Transparent Color attribute can be made dynamic with the name PicDownTransparent. Picture On Use this attribute to specify whether the "Transparent Color" function should Transparent Color On be used. This function is only available for bitmap objects (.bmp,.dib). PicDownUseTransColor The Picture On Transparent Color On attribute can be made dynamic with the name PicDownUseTransColor. Picture Referenced PicReferenced Determine whether the assigned picture is stored in the object or only the corresponding object reference is stored. The Picture Referenced attribute cannot be made dynamic. Picture Status Deactivated PictureDeactivated Set the image (bitmap) that is displayed on a button for the deactivated state. The Picture Status Deactivated attribute can be made dynamic with the name PictureDeactivated WinCC Manual

167 08.97 Graphics Designer Picture Status Off PictureUp Button: Set the image (bitmap) that is displayed on a button for the off state (button not depressed). The Picture Status Off attribute cannot be made dynamic. Round Button: Set the image (bitmap) that is displayed for a round button for the off state (button not depressed). The Picture Status Off attribute can be made dynamic with the name PictureUp. Picture Status On PictureDown Button: Set the image (bitmap) that is displayed on a button for the on state (button depressed). The Picture Status On attribute cannot be made dynamic. Round Button: Set the image (bitmap) that is displayed for a round button for the on state (button not depressed). The Picture Status On attribute can be made dynamic with the name PictureDown. Picture Transparent Color PicTransColor Determine which color of the assigned bitmap object (.bmp,.dib) should be set to "transparent". The attribute is analyzed only if the "Picture Transparent Color On" attribute is activated. The Picture Transparent Color attribute can be made dynamic with the name PicTransColor. Picture Transparent Color On PicUseTransColor Use this attribute to specify whether the "Transparent Color" function should be used. This function is only available for bitmap objects (.bmp,.dib). The Picture Transparent Color On attribute can be made dynamic with the name PicUseTransColor. Picture Width Width Set the picture width in pixels. The default value is 800. The input can be larger than the maximum resolution of the screen. You can shift the picture using the slider. The Picture Width attribute can be made dynamic with the name Width. Position X Left Set (in pixels) the horizontal distance of the starting point of the object (left upper corner of the rectangle surrounding the object) from the starting point of the picture (left upper corner of the picture). WinCC Manual 4-63

168 Graphics Designer Position Y Top Set (in pixels) the vertical distance of the starting point of the object (left upper corner of the rectangle surrounding the object) from the starting point of the picture (left upper corner of the picture). The Position Y attribute can be made dynamic with the name Top. Process Driver Connection Process Set the default for the value to be displayed. This value is used in RUNTIME mode if the appropriate tag is not linked or not updated when the picture starts. The Process Driver Connection attribute can be made dynamic with the name Process. Radius Radius Set the radius in pixels (0 to 999) for circular objects. The Radius attribute can be made dynamic with the name Radius. Radius X RadiusWidth Set the horizontal radius in pixels (0 to 999) for elliptical objects. The Radius X attribute can be made dynamic with the name RadiusWidth. Radius Y RadiusHeight Set the vertical radius in pixels (0 to 999) for elliptical objects. The Radius Y attribute can be made dynamic with the name RadiusHeight. Rotation Angle RotationAngle Set the clockwise rotation angle (in degrees) of the object around the rotation point. The starting point (zero) is the configured start position. The Rotation Angle attribute can be made dynamic with the name RotationAngle. Rotation Reference X ReferenceRotationLeft Set the reference point around which the line, polygon, and polyline object types are rotated. The input is relative to the width of the object, starting with the left edge of the rectangle surrounding the object. The Rotation Reference X attribute can be made dynamic with the name ReferenceRotationLeft. Rotation Reference Y ReferenceRotationTop Set the reference point around which the line, polygon, and polyline object types are rotated. The input is relative to the object height, starting with the top edge of the rectangle surrounding the object. The Rotation Reference Y attribute can be made dynamic with the name ReferenceRotationTop WinCC Manual

169 08.97 Graphics Designer Scale Scaling Set whether an additional scale should be used to represent the values within the bar representation. Use the "Bar Scaling" attribute to set the type of scale. The Scale attribute can be made dynamic with the name Scaling. Scale Color ScaleColor Set the color of the scale. This attribute is only in effect when the scale is active. The Scale Color attribute can be made dynamic with the name ScaleColor. Scale Marks ScaleTicks Set the scale divisions within the bar. The input is a percentage of the entire bar height. The Scale Marks attribute can be made dynamic with the name ScaleTicks. Scaling Factor Zoom Set the zoom factor for the window view. The Scaling Factor attribute can be made dynamic with the name Zoom. Scroll Bars ScrollBars Determine whether scroll bars are available in the window when needed. The Scroll Bars attribute cannot be made dynamic. Select Background Color UnselBGColor Set the color of the background for the unselected entries in the browser list for "Text List" objects. The Select Background Color attribute can be made dynamic with the name UnselBGColor. Select Text Color UnselTextColor Set the color of the text for the unselected entries in the browser list for "Text List" objects. The Select Text Color attribute can be made dynamic with the name UnselTextColor. Selected Box Process This attribute informs the system which box the user selected with a single selection (option group). In a 32-bit value, each box is represented by a bit (box 1 corresponds to the bit value of 0). The selected box is indicated by a set bit (1). Boxes which are not available are indicated by 0. If more than 1 bit is set, an error has occurred. The input is then discarded in this case. The Selected Box attribute can be made dynamic with the name Process. WinCC Manual 4-65

170 Graphics Designer Selected Boxes Process This attribute informs the system which boxes the user selected with multiple selection (check box). In a 32-bit value, each box is represented by a bit (box 1 corresponds to the bit value of 0). The selected box is indicated by a set bit (1). Boxes which are not available are indicated by 0. The Selected Boxes attribute can be made dynamic with the name Process. Selection Background Color SelBGColor Set the color of the background in the selected entry of the browser list for "Text List" objects. The Selection Background Color attribute can be made dynamic with the name SelBGColor. Selection Text Color SelTextColor Set the color of the text in the selected entry of the browser list for "Text List" objects. The Selection Text Color attribute can be made dynamic with the name SelTextColor. Separation Line Background Color ItemBorderBackColor Set the background color of the separation lines in the browser list for "Text List" objects. The Separation Line Background Color attribute can be made dynamic with the name ItemBorderBackColor. Separation Line Color ItemBorderColor Set the color of the separation lines in the browser list for "Text List" objects. The Separation Line Color attribute can be made dynamic with the name ItemBorderColor. Separation Line Style ItemBorderStyle Set the style of the separation lines in the browser list for "Text List" objects. The Separation Line Style attribute can be made dynamic with the name ItemBorderStyle. Separation Line Weight ItemBorderWidth Set the separation line weight in the browser list for "Text List" objects. The Separation Line Weight attribute can be made dynamic with the name ItemBorderWidth. Server Name ServerName Displays the name under which the embedded object (OLE control or OLE object) is registered in Windows. The Server Name attribute cannot be made dynamic. Sizeable Sizeable Determine whether the window size can be changed. The Sizeable attribute cannot be made dynamic WinCC Manual

171 08.97 Graphics Designer Start Angle StartAngle Set the beginning point for the segment and arc object types. The input is clockwise in degrees, starting with 12 o clock. The Start Angle attribute can be made dynamic with the name StartAngle. Switch Setting Pressed Template Template Indicate the status of the round button ("pressed" or "not pressed"). The Switch Setting attribute can be made dynamic with the name Pressed. Set the type of template according to the application (message system, process data acquisition, etc.) in the window. The Template attribute cannot be made dynamic. Text Text Set the text to be displayed in the object. For check- and radio-boxes, the object property "Index" determines, to which element the text change is referring. The text properties are set with other attributes. If the text entered contains control characters, they are also displayed in the "Object Properties" window (for example, \r\n equals CR/LF). The Text attribute can be made dynamic with the name Text. Text Flash Frequency FlashRateForeColor Set the flash frequency for the text. You can set the frequency to slow (approximately 0.5 Hz), medium (approximately 2 Hz), and fast (approximately 8 Hz). Since flashing is implemented by means of software, the frequency is systemand hardware-dependent (number of objects, processor, memory, update cycle, and more). The Text Flash Frequency attribute can be made dynamic with the name FlashRateForeColor. Text Orientation Orientation Set the direction of the text (horizontal/vertical). This only changes the alignment of the text within the object, not the entire object. The Text Orientation attribute can be made dynamic with the name Orientation. Title Caption In the case of window objects, determine whether the window has a title bar. The "Can Be Maximized" and "Can Be Closed" attributes are analyzed only when the "Title" attribute is active. The Title attribute cannot be made dynamic. WinCC Manual 4-67

172 Graphics Designer Tool Tip Text ToolTipText The attribute tool tip text determines the text that will be displayed in runtime as a "Tool Tip", if the mouse pointer is positioned above the object. The attribute Tool Tip Text can be made dynamic with the name ToolTipText. Trend Trend Set whether the trend should be displayed. The trend view shows the directional trend of the measured value when there are small changes to that value. The trend is represented with a small arrow beneath the bar. Depending on the tendency of the measured value, it points up or down. The Trend attribute can be made dynamic with the name Trend. Trend Color TrendColor Set the color for the trend display. The trend is represented by a small arrow beneath the bar. Depending on the tendency of the measured value, it points up or down. The Trend Color attribute can be made dynamic with the name TrendColor. Type AH TypeAlarmHigh Determine whether the limit value for "alarm high" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type AH attribute can be made dynamic with the name TypeAlarmHigh. Type AL TypeAlarmLow Determine whether the limit value for "alarm low" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type AL attribute can be made dynamic with the name TypeAlarmLow. Type RH4 TypeLimitHigh4 Determine whether the high limit value for "reserve 4" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type RH4 attribute can be made dynamic with the name TypeLimitHigh4. Type RH5 TypeLimitHigh5 Determine whether the high limit value for "reserve 5" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type RH5 attribute can be made dynamic with the name TypeLimitHigh WinCC Manual

173 08.97 Graphics Designer Type RL4 TypeLimitLow4 Determine whether the low limit value for "reserve 4" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type RL4 attribute can be made dynamic with the name TypeLimitLow4. TypeRL5 TypeLimitLow5 Determine whether the low limit value for "reserve 5" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type RL5 attribute can be made dynamic with the name TypeLimitLow5. Type TH TypeToleranceHigh Determine whether the limit value for "tolerance high" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type TH attribute can be made dynamic with the name TypeToleranceHigh. Type TL TypeToleranceLow Determine whether the limit value for "tolerance low" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type TL attribute can be made dynamic with the name TypeToleranceLow. Type WH TypeWarningHigh Determine whether the limit value for "warning high" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type WH attribute can be made dynamic with the name TypeWarningHigh. Type WL TypeWarningLow Determine whether the limit value for "warning low" should be provided as a percentage or absolute. The default is absolute. The limit value is monitored only when the value is active. The Type WL attribute can be made dynamic with the name TypeWarningLow. Underline FontUnderline Set the text attribute Underline for the text in the object. The Underline attribute can be made dynamic with the name FontUnderline. WinCC Manual 4-69

174 Graphics Designer Update Cycle UpdateCycle Set the method and frequency for updating the object. The Update Cycle attribute cannot be made dynamic. Width Width Set the width of the object in pixels. The Width attribute can be made dynamic with the name Width. Window Contents Application Determine the type of application (message system, process data acquisition, etc.) in the window. The Window Contents attribute cannot be made dynamic. Window Height Height Set the height of the window in pixels. The Window Height attribute can be made dynamic with the name Height. Window Width Width Set the width of the window in pixels. The Window Width attribute can be made dynamic with the name Width. Windows Style WindowsStyle Determine whether the object should correspond to the general Windows style (gray buttons without borders). When this attribute is active, attributes that do not correspond to the Windows style are ignored (for example, "Border Weight"). On the other hand, setting a border weight of a non-gray background color deactivates the "Windows Style" attribute. The Windows Style attribute can be made dynamic with the name WindowsStyle. X Alignment AlignmentLeft Set the horizontal alignment (aligned left, centered, aligned right) of the text. The X Alignment attribute can be made dynamic with the name AlignmentLeft. Y Alignment AlignmentTop Set the vertical alignment of the text (top, center, bottom). The Y Alignment attribute can be made dynamic with the name AlignmentTop. Zero Point ZeroPoint Set the zero point of the bar for bar objects. The input is a percentage of the entire bar height. The zero point can also be outside of the range represented. This attribute is only analyzed when the "Bar Scaling" attribute is set to "automatic." The Zero Point attribute can be made dynamic with the name ZeroPoint WinCC Manual

175 08.97 Graphics Designer Zero Point Value ZeroPointValue Set the absolute value for the zero point. For bar object types, set the location of the zero point with the "Zero Point" attribute. The Zero Point Value attribute can be made dynamic with the name ZeroPointValue. WinCC Manual 4-71

176 Graphics Designer Output formats for I/O-Fields Data Format Binary You may select the predefined output format "Binary" from the selection list. Example: You can define your own output format in the "Enter Format" input field. The following characters are allowed: Character Definition "1" Binary values "0" or "1" Each "1" stands for a character in the output value. A preceding "0" indicates that leading zeros are inserted where necessary (up to a maximum number of "1") WinCC Manual

177 08.97 Graphics Designer Data Format Decimal You may select the predefined output format "Decimal" from the selection list. Example: You can define your own output format in the "Enter Format" input field. The following characters are allowed: Character Definition "s" Sign provided "e" Exponent representation "9" Number between 0 and 9 "0" Leading zero accompanies output "." Decimal point Examples: Value 1.0 is to be displayed Output Format Display s s9.9e +1.0e WinCC Manual 4-73

178 Graphics Designer Data Format String You may select the predefined output format "String" from the selection list. Example: You can define your own output format in the "Enter Format" input field. The following characters are allowed: Character Definition * Any string in any length? Any string with a length of "Number?" (for example,???? any string with 4 characters) a Lower- or uppercase letters or number "0... 9" A Uppercase letters or number "0... 9" b Lower- or uppercase letters B Uppercase letters d Sign ("+" or "-"), decimal point, blank, or number "0... 9" t Separator "/", ":", ".", "," or blank 1 Number Number Number Number Number Number Number Number Number h Hexacharacter 0...9, A... F, or a... f 4-74 WinCC Manual

179 08.97 Graphics Designer Data Format Hexadecimal You may select the predefined output format "Hexadecimal" from the selection list. Example: You can define your own output format in the "Enter Format" input field. The following characters are allowed: Character "f" Definition Hexadecimal value "0" to "f" Each "f" stands for a character in the output value. A preceding "0" indicates that leading zeros are inserted where necessary (up to a maximum number of "f"). WinCC Manual 4-75

180 Graphics Designer Assignments for Text Lists List Type Decimal Use the "Assignments" attribute to assign the values for the text list. Four range types ("To Value," "Single Value," "From-To Value," and "From Value") are provided for the assignment in the "Decimal" list type. Depending on the range type that is set, the value range (relative to the value to be displayed) can be defined. Exactly one value can be assigned to a text for the "Single Value" range type. The "From-To Value" range type allows you to enter two values that define a value range (including the values you enter). The "To Value" range type defines a value range that is open on the bottom and reaches to include the value you entered. The "From Value" range is analogous to this and defines a value range that is open on the top. If there is no text assigned to the value to be displayed, the text "***" is output in CONFIGURATION mode and in RUNTIME mode. Use the "Append" button to add a new list entry to the end of the list. Use the "Remove," "Up," and "Down" buttons to remove a list entry or shift it up or down within the sequence of the list WinCC Manual

181 08.97 Graphics Designer List Type Binary Use the "Assignments" attribute to assign the values for the text list. One text can be assigned to each bit number (relative to the value to be displayed) for the "Binary" list type. The bit number has a value range of 0 to 31. If there is no text configured for the bit number and if the corresponding bit is set as the only one in the output value, the text "***" is displayed in CONFIGURATION mode and in RUNTIME mode. Use the "Append" button to add a new list entry to the end of the list. Use the "Remove," "Up," and "Down" buttons to remove a list entry or shift it up or down within the sequence of the list. WinCC Manual 4-77

182 Graphics Designer List Type Bit Use the "Assignments" attribute to assign the value for the text list. Exactly two texts can be configured for assignment to the "Bit" list type. One is for the case in which the bit that is observed has a value of 0, and one is for the case in which the bit has a value of 1. Use the "Bit Number" attribute (value range 0 to 31) to specify which bit of the value to be displayed is observed WinCC Manual

183 08.97 Graphics Designer Index 3 3D Bar 2-7 3D Border Color D Border Weight D Shadow Color 4-39 A Action 2-51; 3-1; 3-2; 3-14 Action configuration 3-1 ActualPointLeft 4-46 ActualPointTop 4-47 Adapt Border 4-39 Adapt Picture 4-39 Adapt Size 4-39 Addressing 3-33 Addressing method 3-33 AlarmHigh 4-54 AlarmLow 4-54 Alignment 4-40 Alignment palette 2-15 AlignmentLeft 4-70 AlignmentTop 4-70 Alpha Cursor 2-23 Application Window 2-4; 4-14 Apply on Exit 4-40 Apply on Full 4-40 Assignments 4-40 AssumeOnExit 4-40 AssumeOnFull 4-40 Attribute name 3-25 Attributes 2-41; 4-39 Average 4-40 Average Value 4-40 Axis Section 4-40 AxisSection 4-40 B BackBorderWidth 4-39; 4-45 BackColor 4-40 BackColor BackColor BackColorBottom 4-56 BackColorTop 4-52 BackFlashColorOff 4-49 BackFlashColorOn 4-49 Background Color 4-40 Background Flash Frequency 4-41 Bar 2-5; 4-20 Bar Background Color 4-41 Bar Color 4-41 Bar Color AH 4-41 Bar Color AL 4-41 Bar Color RH Bar Color RH Bar Color RL Bar Color RL Bar Color TH 4-42 Bar Color TL 4-42 Bar Color WH 4-42 Bar Color WL 4-42 Bar Direction 4-42 Bar Height 4-43 Bar Pattern 4-43 Bar Scaling 4-43 Bar Width 4-43 BasePicTransColor 4-43 BasePicUseTransColor 4-43 Basic Picture 4-43 Basic Picture Referenced 4-43 Basic Picture Transparent Color 4-43 Basic Picture Transparent Color On 4-43 BIT 3-8 Bit Number 4-44 Bit selection 3-9 BitNumber 4-44 Bold 4-44 Border 4-44 Border Background Color 4-44 Border Color 4-44 Border Flash Frequency 4-44 Border Style 4-44 Border Weight 4-45 BorderBackColor 4-44; 4-55 BorderColor 4-44; 4-56 BorderColorBottom 4-39 BorderColorTop 4-39 BorderEndStyle 4-56 BorderFlashColorOff 4-50 BorderFlashColorOn 4-50 BorderStyle 4-44; 4-56 BorderWidth 4-45; 4-56 Box Alignment 4-45 BoxAlignment 4-45 BoxCount 4-59 BoxType 4-48 Button 2-8; 4-27 WinCC Manual Index-1

184 Graphics Designer Button Color 4-45 ButtonColor 4-45 C C Action 2-49; 2-52; 3-21 C Function 3-22; 3-30 Can Be Closed 4-45 Can Be Maximized 4-45 Change 3-1 Change Color 4-45 Changing the palette size 2-2 Check Box 2-8; 4-29 CheckAlarmHigh 4-57 CheckAlarmLow 4-57 CheckLimitHigh CheckLimitHigh CheckLimitLow CheckLimitLow CheckToleranceHigh 4-58 CheckToleranceLow 4-58 CheckWarningHigh 4-58 CheckWarningLow 4-59 Circle 2-4; 4-5 Circular Arc 2-4; 4-9 Clear on Invalid Input 4-46 Clear on New Input 4-46 ClearOnError 4-46 ClearOnNew 4-46 Color palette 2-2 ColorAlarmHigh 4-41 ColorAlarmLow 4-41 ColorBottom 4-57 ColorChangeType 4-45 ColorLimitHigh ColorLimitHigh ColorLimitLow ColorLimitLow ColorToleranceHigh 4-42 ColorToleranceLow 4-42 ColorTop 4-52 ColorWarningHigh 4-42 ColorWarningLow 4-42 Configured Languages 4-46 Context sensitive help 2-1 Corner Radius X 4-46 Corner Radius Y 4-46 Ctrl+C 3-22 Ctrl+End 3-22 Ctrl+Home 3-22 Ctrl+V 3-22 Ctrl+X 3-22 Index-2 Current Status 4-46 Current Value X 4-46 Current Value Y 4-47 Cursor Control 4-47 Cursor Mode 4-47 CursorControl 4-47 Cycle 3-11; 3-12; 3-14; 3-26; 3-27 Cycle time 3-8; 3-9; 3-12; 3-13; 3-27; 3-28; 3-34 D Data Format 4-47 Data type 3-3; 3-7; 3-8; 3-9 Date of Last Change 4-47 Default addressing 3-33 Default cycle 3-4; 3-11; 3-21; 3-26 Default cycle time 3-4; 3-21 Default entry 3-11; 3-26 Default value 3-11; 3-26; 3-33 Digits to the Left of the Decimal Point 4-47 Digits to the Right of the Decimal Point 4-47 Direct connection 2-51; 2-52; 2-53 Direction 4-40; 4-42 Display 4-47 Drawing an Object 2-9 Dynamic 2-41; 2-49 Make dynamic 3-2; 3-3; 3-4; 3-21; 3-32 Dynamic dialog 2-49 Dynamic Filling 4-47 E Edit functions 3-22; 3-23 Edit window 3-31 EditAtOnce 4-52 Ellipse 2-4 Ellipse Arc 2-4; 4-8 Ellipse Segment 2-4; 4-6 End Angle 4-48 EndAngle 4-48 Event 2-50; 2-51; 3-1; 3-2; 3-11; 3-26; 3-30; 3-35 Event category 3-35 Events 3-35 Exponent 4-48 Exponent Display 4-48 Export 2-20; 3-31; 3-32 Export file 3-31 Expression 3-5 Extended Operation 4-48 ExtendedOperation 4-48 WinCC Manual

185 08.97 Graphics Designer F Feedback Documentation 2-20 Field Type 4-48 Fill Level 4-48 Fill Pattern 4-48 Fill Pattern Color 4-48 FillColor 4-48 Filling 4-47 FillingIndex 4-48 FillStyle 4-48 FillStyle Flash Picture 4-48 Flash Picture Flash Frequency 4-49 Flash Picture Referenced 4-49 Flash Picture Transparent Color 4-49 Flash Picture Transparent Color On 4-49 FlashBackColor 4-49 FlashBorderColor 4-49; 4-50 FlashFlashPicture 4-50 FlashForeColor 4-50 Flashing Background Active 4-49 Flashing Background Color Off 4-49 Flashing Background Color On 4-49 Flashing Border Active 4-49 Flashing Border Color Off 4-50 Flashing Border Color On 4-50 Flashing Flash Picture Active 4-50 Flashing Line Active 4-50 Flashing Line Color Off 4-50 Flashing Line Color On 4-50 Flashing Text Active 4-50 Flashing Text Color Off 4-50 Flashing Text Color On 4-50 FlashPicTransColor 4-49 FlashPicUseTransColor 4-49 FlashRateBackColor 4-41 FlashRateBorderColor 4-44; 4-56 FlashRateFlashPic 4-49 FlashRateForeColor 4-67 Font 4-50 Font Color 4-51 Font palette 2-37 Font Size 4-51 FontBold 4-44 FontItalic 4-53 FontName 4-50 FontSize 4-51 FontUnderline 4-69 ForeColor 4-51 ForeFlashColorOff 4-50 ForeFlashColorOn 4-50 Foreground 4-51 Formula 3-5 Function 3-5 Function name 3-5; 3-22 Function value 3-30 G Graphic Object (External Format) 2-5; 4-23 Grid Color 4-51 Grid Height 4-51 Grid On 4-51 Grid Width 4-51 Group 2-22; 4-37 Group Display 2-7 Group object 2-22; 4-37 H Height 4-43; 4-51; 4-61; 4-70 Hidden Input 4-51 HiddenInput 4-51 High limit 3-7 High Limit Background Color 4-52 High Limit Color 4-52 High Limit Value 4-52 Home 3-22 Hot Key 4-52 Hysteresis 4-52 Hysteresis Range 4-52 HysteresisRange 4-52 I I/O Field 2-5; 4-18 Immediate Input 4-52 Import 2-30; 3-32 Import file 3-32 Increment 3-7 Index 4-46; 4-53 Indir 3-33 Indirect addressing 2-41; 2-50 Italic 4-53 ItemBorderBackColor 4-66 ItemBorderColor 4-66 ItemBorderStyle 4-66 ItemBorderWidth 4-66 K Keystroke 3-1 WinCC Manual Index-3

186 Graphics Designer L Label Each 4-53 Language Switch 4-53 Languages 2-30; 2-48 Latch Down 4-53 Layer 2-29; 4-53 Layer bar 2-38 LeftComma 4-47 Length of Axis Section 4-53 Library 2-26 Light bulb 3-3; 3-14; 3-21; 3-32; 3-33 Light bulb 3-3 Light bulb icon 3-29 Lightning bolt 3-14; 3-15; 3-21; 3-31; 3-35 Limit AH 4-54 Limit AL 4-54 Limit Marker 4-54 Limit RH Limit RH Limit RL Limit RL Limit TH 4-55 Limit TL 4-55 Limit WH 4-55 Limit WL 4-55 LimitHigh LimitHigh LimitLow LimitLow LimitMax 4-52 LimitMin 4-57 Line 2-4; 4-1 Line Background Color 4-55 Line Color 4-56 Line End Style 4-56 Line Flash Frequency 4-56 Line Style 4-56 Line Weight 4-56 List Type 4-56 List type "Binary" 4-77 List type "Bit" 4-78 List type "Decimal" 4-76 Long Axis Sections 4-56 LongStrokesBold 4-56 LongStrokesOnly 4-59 LongStrokesSize 4-53 Low Limit Background Color 4-56 Low Limit Color 4-57 Low Limit Value 4-57 Index-4 M Marker 4-54 Max 4-57 Maximum Value 4-57 Menu bar 2-17 Menu commands 2-17 Min 4-57 Minimum value 3-7; 4-57 Monitoring AH 4-57 Monitoring AL 4-57 Monitoring RH Monitoring RH Monitoring RL Monitoring RL Monitoring TH 4-58 Monitoring TL 4-58 Monitoring WH 4-58 Monitoring WL 4-59 Mouse event 3-35 Moveable 4-59 Multiple selection 2-42; 4-28 N Number of Boxes 4-59 Number of Corners 4-59 Number of Visible Lines 4-59 NumberLines 4-59 O Object 3-2 Object attribute 3-4; 3-33 Object list 2-40 Object name 3-25; 4-59 Object palette 2-3 Object properties 2-10; 2-26; 2-39 OffsetLeft 4-62 OffsetTop 4-62 OLE automation name 4-39 OLE Control 2-5; 4-16 OLE links 2-32 OLE Object 2-5; 4-17 On-line help 2-1 Only Long Axis Sections 4-59 Operation 4-60 Operation Steps 4-59 OperationMessage 4-60 OperationReport 4-60 Operator 3-6 Operator Activities Report 4-60 WinCC Manual

187 08.97 Graphics Designer Operator Input Message 4-60 Operator-Control Enable 4-60 Operators 3-6 Option Group 2-8; 4-31 Orientation 4-67 Output Format 4-60 Output format "Binary" 4-72 Output format "Decimal" 4-73 Output format "Hexadecimal" 4-75 Output format "String" 4-74 Output Value 4-60 OutputValue 4-60 P Palette 2-27 Parameter Set parameters 3-23; 3-24 Parameter assignment 3-5; 3-23; 3-24 Parameter parentheses 3-22 Parameters 3-5; 3-22; 3-23; 3-24; 3-25 Password 4-60 PasswordLevel 4-60 PicDeactTransparent 4-61 PicDeactUseTransColor 4-61 PicDownTransparent 4-62 PicDownUseTransColor 4-62 PicTransColor 4-63 Picture 4-38; 4-61 Picture Browser 3-25 Picture cycle 3-11; 3-26; 3-34 Picture Deact. Referenced 4-61 Picture Deact. Transparent Color 4-61 Picture Deact. Transparent Color On 4-61 Picture Height 4-61 Picture name 3-25; 4-61 Picture Off Referenced 4-61 Picture Off Transparent Color 4-61 Picture Off Transparent Color On 4-62 Picture Offset X 4-62 Picture Offset Y 4-62 Picture On Referenced 4-62 Picture On Transparent Color 4-62 Picture On Transparent Color On 4-62 Picture Referenced 4-62 Picture Status Deactivated 4-62 Picture Status Off 4-63 Picture Status On 4-63 Picture Transparent Color 4-63 Picture Transparent Color On 4-63 Picture Width 4-63 Picture Window 2-5; 4-15 PictureDeactivated 4-62 PictureDown 4-63 PictureName 4-61 PictureUp 4-63 PicUpTransparent 4-61 PicUpUseTransColor 4-62 PicUseTransColor 4-63 Pie Segment 2-4; 4-7 Polygon 2-4; 4-2 Polyline 2-4; 4-3 Position Y 4-64 Presetting 3-11; 3-26 Pressed 4-67 Print Preview 2-19 Priority 3-10 Process 4-64; 4-65; 4-66 Process Driver Connection 4-64 Process tag 3-30 Properties 3-25 Property 3-1; 3-2 R Radius 4-64 Radius X 4-64 Radius Y 4-64 RadiusHeight 4-64 RadiusWidth 4-64 Range 3-23 Range high limit 3-15 Rectangle 2-4; 4-10 ReferenceRotationLeft 4-64 ReferenceRotationTop 4-64 Result of expression 3-3 Result tags 3-30 Return value 3-1; 3-2; 3-21; 3-29 RightComma 4-47 Rotation Angle 4-64 Rotation Reference X 4-64 Rotation Reference Y 4-64 RotationAngle 4-64 Round Button 2-8; 4-33 RoundCornerHeight 4-46 RoundCornerWidth 4-46 Rounded Rectangle 2-4; 4-11 Runtim mode 2-53 Run-Time Behavior 2-51 Runtime Mode 2-7; 2-18; 2-23 WinCC Manual Index-5

188 Graphics Designer S Scale 4-65 Scale Color 4-65 Scale Marks 4-65 ScaleColor 4-65 ScaleTicks 4-65 Scaling 4-65 Scaling Factor 4-65 ScalingType 4-43 Scroll Bars 4-65 SelBGColor 4-66 Select Background Color 4-65 Select Text Color 4-65 Selected Box 4-65 Selected Boxes 4-66 Selecting an Object 2-10 Selection Background Color 4-66 Selection Text Color 4-66 SelTextColor 4-66 Separation Line Background Color 4-66 Separation Line Color 4-66 Separation Line Style 4-66 Separation Line Weight 4-66 Server Name 4-66 Sizeable 4-66 Slider 2-8; 4-35 SmallChange 4-59 Smart Objects 2-4 Split bar 3-23; 3-31 Standard Objects 2-4 Standard toolbar 2-35 Start Angle 4-67 StartAngle 4-67 Static 2-41; 2-42 Static Text 2-4; 4-12 Status 3-3; 3-4; 3-10 Status bar 2-38; 3-30 Status Display 2-6; 4-24 Status evaluation 3-10 Status list 3-10 Style palette 2-12 Subject tree 2-40; 2-50 Switch Setting 4-67 System load 3-1 T Tab "Default Objects" 2-33 Tab "Event" 2-50 Tab "Grid" 2-32 Tab "Options" 2-32 Tab "Properties" 2-40 Index-6 Tab "Visible Layers" 2-32 Tab Order 2-23 Tag 3-24 Tag dialog 2-49 Tag list 3-11; 3-13; 3-14; 3-26; 3-28; 3-29 Tag name 3-4; 3-13; 3-23; 3-25; 3-28; 3-32; 3-33 Tag status 3-10 Tag value 3-32 Template 4-67 Text 4-67 Text Flash Frequency 4-67 Text List 2-6; 4-25; 4-76; 4-77; 4-78 Language Switch 2-6 Text Orientation 4-67 Tips & Tricks 2-1 Title 4-67 Toggle 4-53 ToleranceHigh 4-55 ToleranceLow 4-55 Tool Tip Text 4-68 Toolbar 2-27 ToolTipText 4-68 Top 4-64 Trend 4-68 Trend Color 4-68 TrendColor 4-68 Trigger 3-4; 3-11; 3-12; 3-26; 3-27 Trigger event 3-11; 3-14; 3-26 Trigger name 3-11; 3-26 Trigger tag 3-8; 3-9 Triggering events 2-51 Type AH 4-68 Type AL 4-68 Type RH Type RH Type RL Type RL Type TH 4-69 Type TL 4-69 Type WH 4-69 Type WL 4-69 TypeAlarmHigh 4-68 TypeAlarmLow 4-68 TypeLimitHigh TypeLimitHigh TypeLimitLow TypeLimitLow TypeToleranceHigh 4-69 TypeToleranceLow 4-69 TypeWarningHigh 4-69 TypeWarningLow 4-69 WinCC Manual

189 08.97 Graphics Designer U Underline 4-69 UnselBGColor 4-65 UnselTextColor 4-65 Update cycle 2-41; 2-50; 3-33; 3-34; 4-70 Update event 3-4; 3-11; 3-26 User cycle 3-12; 3-27; 3-34 V Valid range 3-8; 3-9 Value assignment 3-10 Value change 3-1; 3-12; 3-13; 3-27; 3-28 Value range 3-3; 3-5; 3-7; 3-10 Visible 4-47 W WarningHigh 4-55 WarningLow 4-55 Width 4-43; 4-63; 4-70 Window Contents 4-70 Window cycle 3-11; 3-26 Window Height 4-70 Window Width 4-70 Windows Objects 2-8 Windows Style 4-70 WindowsStyle 4-70 X X Alignment 4-70 Y Y Alignment 4-70 Z Zero Point 4-70 Zero Point Value 4-71 ZeroPoint 4-70 ZeroPointValue 4-71 Zoom 4-65 Zoom palette 2-17 WinCC Manual Index-7

190 Graphics Designer Index-8 WinCC Manual

191 WinCC Global Scripts Manual Edition August 1997

192 WinCC, SIMATIC, SINEC, STEP are Siemens registered trademarks. All other product and system names in this manual are (registered) trademarks of their respective owners and must be treated accordingly. (The reproduction, transmission or use of this document or ist contents is not permitted without express written authority. Offenders will be liable for damages. All rights, including rights created by patent grant or registration of a utility model or design, are reserved.) (We have checked the contents of this manual for agreement with the hardware and software described. Since deviations cannot be precluded entirely, we cannot guarantee full agreement. However, the data in this manual are reviewed regularly and any necessary corrections included in subsequent editions. Suggestions for improvement are welcomed.) Siemens AG All rights reserved Technical data subject to change Printed in the Federal Republic of Germany Siemens Aktiengesellschaft

193 Table of Contents / Global Scripts 1 Introduction Project Functions Standard Functions Alarm (Standard Functions) GRAPHICS (Standard Functions) TAGLOG (Standard Functions) TEMPLATE TOOLBAR BUTTONS WINCC (Standard Functions) WINDOWS (Standard Functions) Options (Standard Functions) Report (Standard Functions) Split Screen Manager (Standard Functions) Internal Functions alarm (Internal Functions) allocate c_bib graphics graphics-get-axes Functions graphics-get-color Functions graphics-get-fill Functions graphics-get-flash Functions graphics-get-focus-functions graphics-get-font Functions graphics-get-general Functions graphics-get-geometry Functions graphics-get-i_o Functions graphics-get-limits Functions graphics-get-link Functions graphics-get-misc Functions graphics-get-ole_control Functions graphics-get-pictures Functions graphics-get-property-funktionen graphics-get-state Functions graphics-get-style Functions graphics-set-axes Functions graphics-set-color Functions graphics-set-fill Functions graphics-set-flash Functions graphics-set-focus-functions graphics-set-font Functions graphics-set-geometry Functions WinCC Manual i

194 Global Scripts graphics-set-i_o Functions graphics-set-limits Functions graphics-set-link Functions graphics-set-misc Functions graphics-set-ole_control Functions graphics-set-pictures Functions graphics-set-property-funktionen graphics-set-state Functions graphics-set-style Functions Tag tag-get-functions tag-get-state Functions tag-get-wait Functions tag-get-state-wait Functions Tag-set Functions tag-set-state Functions tag-set-wait Functions tag-set-state-wait Functions wincc wincc system Actions Value Definitions of the Attributes Language Identifiers Colors Line End Styles Line Styles Flash Frequencies Text Orientation Bar Orientation I/O-Field, Field Type I/O-Field, Data Type of the Field Content Element Orientation in Check- and Radio Boxes ii WinCC Manual

195 08.97 Global Scripts Preface Purpose of the Manual This manual introduces you to the functions of each software component and their operation in a reference manual format. You can find the information you need quickly by using the table of contents or the index. Naturally, the information is also available to you in the on-line help in either a context-sensitive fashion or in the on-line help contents. Total Overview and Configuration Example The "Getting Started" manual, which is part of the WinCC package, contains a total overview of WinCC and a configuration example in which the most significant functions of the individual components are followed through in a practical application. Additional Support If you have technical questions, please address them to your Siemens contact partner, located in the businesses responsible for your location. You can find the addresses in the attachment entitled Siemens Worldwide, in "S7-300 Automation System Structure in an S7-300," in catalogs, and on CompuServe (go.autforum). In addition, you may call our Hotline at (Fax 7001). You can find additional information on the Internet under the address Information about SIMATIC products Up to date information about SIMATIC products can be obtained: * from the Internet under * via fax# In addition, the SIMATIC Customer Support provides current information and downloads that can be beneficial for the utilization of SIMATIC products: * from the Internet under * via the SIMATIC Customer Support Mailbox under phone# +49 (911) * To address the mailbox, use a modem with up to V.34 (28.8 kbaud), which parameters must be set as follows: 8, N, 1, ANSI, or dial up through ISDN (x.75, 64 kbit). The SIMATIC Customer Support can be reached by phone under the number +49 (911) and by fax under the number +49 (911) Inquiries can also be made via Internet mail or mail addressed to the above mailbox. WinCC Manual iii

196 Global Scripts iv WinCC Manual

197 08.97 Global Scripts 1 Introduction Global Scripts is the general term for C functions and actions that can be used throughout a project or across projects depending on their type. You can differentiate among the following types: Project Functions You can create new project functions and change existing project functions. The project functions are unique to the project in which they were created. Standard Functions You can create new standard functions and change existing standard functions. The standard functions are recognized across projects. Internal Functions You cannot create or change internal functions. They are recognized across projects. Actions You can create and change actions as global scripts. These actions are unique to the project in which they were created. Use project functions, standard functions, and internal functions in the following areas: In object-related C actions In object-related actions that you create in the dynamic dialog Use them to make the following areas dynamic: Process value archives User archives Compressed archives At run time, you can implement global script actions in the process control. Before you do this, you must activate the project and start the run-time system. For activating the project, see Control Center, Section To start the run-time system, see Control Center, Section 6.3. Note: Actions are processed interpretively. When implementing numerous or extensive actions, you should plan for a higher system load. It is therefore better to replace extensive actions with separate DLLs (Dynamic Link Libraries). Functionalities of available DLLs can be made available to functions and actions in WinCC. Use the following command sequence for this purpose: #pragma code("<name>.dll") #include "<NAME>.h" #pragma code() WinCC Manual 1-1

198 Global Scripts Note: If you define your own structures in connection with project or standard functions, the following construction will cause translation errors: struct MyOwnStruct; {... } void MyFunction (struct MyOwnStruct...); {... } The prototype of this function will be transferred to the file ap_pbib.h or ap_glob.h, but the structure is missing from there. To realize the transfer of such a structure or call back function, proceed as follows: In the project catalog (projectpath\library), insert apdefap.h before the #include "ap-pbib.h" structure struct MyOwnStruct; {... } #include "ap-pbib.h" Correspondingly also: #pragma code ("pdlcsapi.dll") #include "pldcsapi.h" #prgma code() #include "ap_pbib.h" The structure of MyOwnStruct and the structure of the call back function will therefore be known to the object, while the prototype of the project function is transferred. In the project function itself, write only the following #include "apdefap.h" 1-2 WinCC Manual

199 08.97 Global Scripts 2 Project Functions Project functions are C functions that you program and change yourself. They are unique to the current project in which they were created. You can use project functions to make graphic objects and archives dynamic. You can also use them in other project functions and Global Script actions. Create a project function by means of the Global Script editor. Start the editor in the Control Center. Use the following steps in creating a project function: 1. Formulate the function 2. Add function information 3. Compile the function 4. Save the function and, if necessary, rename it. 5. If necessary, generate header files. You have now created your project function. The first time you create a project function, the header file apdefap.h is loaded in the project folder...\<projectname>\library. The file contains the header file from the project library ap_plib.h which contains the header file ap_glob.h. The header file ap_plib.h contains the definitions of the project functions. If a project function is loaded and other default or project functions are used there, you must integrate the header file apdefap.h or ap_glob.h. WinCC Manual 2-1

200 Global Scripts How to Formulate a 1. Start the Global Script editor in the Control Center. The "Global Script" box opens. 2. Open the pop-up menu by clicking the right mouse button on the function type (project function, standard function, or action) in the function browser. Open the submenu by placing the cursor or clicking on "New" and select the "Function" submenu item. or Use one of the buttons on the Toolbar. This selection opens a window that already contains the outline of a C function. 3. Formulate your function. The following edit functions are available: Function New line Delete character to the right Delete character to the left Jump to the beginning of the line Jump to the end of the line Jump to the beginning of the text Jump to the end of the text Move the cursor Cut selected text Copy selected text Paste text from the Clipboard Key Stroke Enter Delete Backspace Home End Ctrl+Home Ctrl+End Cursor keys Ctrl+X Ctrl+C Ctrl+V 2-2 WinCC Manual

201 08.97 Global Scripts Function Highlight text Highlight a word Move the insertion point Mouse With the left mouse button Double click with the left mouse button With the left mouse button Additional edit functions include the following: The writing mode is "Insert." Highlighted text is replaced by the next character you enter on the keyboard. Expanded highlighting: Highlight an area: Place the cursor at the beginning of the area you want to highlight. Hold down the Shift key and place the cursor at the end of the area you want to highlight. Expand a highlighted selection: Hold down the Shift key and move the cursor to the end of the area you want to highlight. You can place fully programmed project functions, standard functions, and internal functions within your function at the cursor location or you can replace selected text with such functions. Proceed as follows: 1. Position the cursor or highlight the text you want to replace. 2. In the function browser, open the appropriate folder and click the right mouse button on the desired function to open the pop-up menu. 3. Select the "Send to..." menu item in the pop -up menu. 4. Select the appropriate editing window from the submenu listing. If you have multiple editing windows open, the submenu contains an entry for each one. 5. If necessary, update the parameters of the function you pasted. Enter tag names by clicking on the button. This action opens the "Select a Tag" dialog in which you can select the desired tag. If you need to, open folders. WinCC Manual 2-3

202 Global Scripts How to Add Information about a If you have more than one editing window open, make the window that contains the desired function the active window. 1. Click on the button to open the "Description" box. Date created, date changed, and version are already entered. The date created and date changed formats are (left to right) "Day," "Month," "Year." 2. Enter or change the "Created by" and "Changed by" boxes. 3. Enter a comment, for example, a brief description of the function, in the "Comment" box. 4. If you want to assign a password to your function to protect it from changes, click on the "Password" button to activate the "Change" button. Click on the "Change" button and enter your password in the "Enter Password" box. Retype your password to confirm it. Click on the "OK" button to close the box. You have now protected your function with a password. 5. Click the "OK" button to close the "Description" box. The entries are applied. 2-4 WinCC Manual

203 08.97 Global Scripts How to Compile the Function/Action: If you have more than one editing window open, make the window that contains the desired function/action the active window. Click on the button to begin compiling. The active editing window is divided into two areas. The top portion contains your function/action and the bottom displays the messages from the compiler. How to Save the If you create a new function or a new action, it receives a default name from the system. If you want to save your function or action under its current name, proceed as follows: 1. Click on the button. The editing window stays open. 2. Select the "Save" command in the "File" menu. The editing window stays open. 3. Click on the "Close" box in the editing window. This action opens a box that tells you that there are changes that have not been saved. You can then choose to save the function/action, reject the changes, or cancel the procedure. If you cancel the procedure, the editing window stays open, otherwise it closes. If you want to save your function/action under another name select "Save As " in the "File" menu. This selection opens a box in which you can set the name and the storage location. Generally, the storage area is set as follows: For project functions: In the "Library" subfolder in the project folder For actions: In the "Pas" subfolder in the project folder For standard functions: In the WinCC system folder in the "Aplib" subfolder. WinCC Manual 2-5

204 Global Scripts How to Generate the New Header Files: If functions are programmed autonomously, you can make them available to the project by copying them to the appropriate folders. This makes the functions available but unknown to the system. Use the button or select the "Generate header" menu item to regenerate the header files. The system can then recognize these new or changed functions. In the same way, deleted functions are made unrecognizable to the system. When the new header files are generated, the new functions appear in the function browser of the Global Script Editor. 2-6 WinCC Manual

205 08.97 Global Scripts 3 Standard Functions The system makes standard functions available. These functions can be changed to adapt to your needs. In addition, you can also create standard functions yourself. Standard functions are recognized across projects. Use standard functions to make graphic objects and archives dynamic. You can also use them in project functions, other standard functions, and Global Script actions. Create a standard function with the Global Script editor. Start this editor in the Control Center. You must follow these steps to create a standard function: Formulate the function. (see Section 2). Expand the function information. (see Section 2). Compile the function. (see Section 2). Save the function. and rename it if necessary (see Section 2). If necessary, generate header files (see Section 2). You have now created your standard function. The header file apdefap.h integrates the header file ap_glob.h that contains the definition of the standard functions. The files apdefap.h and ap_glob.h are located in the folder...\aplib. If a new standard function is created and if other standard functions are used there, you must integrate the header file apdefap.h or ap_glob.h. New standard functions are added to the available standard functions on the server computer in the WinCC installation folder under...\aplib. The system provides standard functions. They are divided into the following categories: Alarm GRAPHICS TAGLOG WINCC WINDOWS WinCC Manual 3-1

206 Global Scripts Depending on the option package (for example, Basic Process Control, Advanced Process Control), the system provides you with additional standard functions. These functions are divided into the following categories: Options Report Split Screen Manager userarc The standard functions contained in "userarc", are explained in more detail in the Simatic-WinCC-Manual "Tag Logging User Archives". 3-2 WinCC Manual

207 08.97 Global Scripts 3.1 Alarm (Standard Functions) The return value for these functions is the following error code: TRUE: FALSE: = The function was executed without errors. = An error occured BOOL GMsgFunction(char* pszmsgdata) This function represents a global function for single messages. It provides the message data of the single messages and can only be activated if the "trigger action" parameter is set. pszmsgdata = Pointer to a buffer on which the message data are stored. BOOL OnBtnArcLong(char* pszmsgwin) BOOL AXC_OnBtnArcLong(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function displays the sequence archive (display sequence archive). pszmsgwin = Pointer to the message window name (OnBtnArcLong) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnArcLong) BOOL OnBtnArcShort(char* pszmsgwin) BOOL AXC_OnBtnArcShort(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function displays the short-term archive (display short-term archive). pszmsgwin = Pointer to the message window name (OnBtnArcShort) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnArcShort) WinCC Manual 3-3

208 Global Scripts BOOL OnBtnComment(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function displays the comment (comment). pszmsgwin = Pointer to the message window name BOOL OnBtnEmergAckn(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function opens the acknowledgment dialog (Emergency acknowledgment/reset). pszmsgwin = Pointer to the message window name BOOL OnBtnHornAckn(char* pszmsgwin) BOOL AXC_OnBtnHornAckn(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function acknowledges the horn signal (horn acknowledgment). Parameters pszmsgwin = Pointer to the message window name (OnBtnHornAckn) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnHornAckn) BOOL OnBtnInfo(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function displays the info text (Infotext). pszmsgwin = Pointer to the message window name 3-4 WinCC Manual

209 08.97 Global Scripts BOOL OnBtnLanguage(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function allows you to change the language of the message window operation (Language switch). pszmsgwin = Pointer to the message window name This function will not be supported anymore starting with WinCC V4.0. BOOL OnBtnLock(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function activates the "Set Lock" dialog. pszmsgwin = Pointer to the message window name BOOL OnBtnLoop(char* pszmsgwin) BOOL AXC_OnBtnLoop(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function triggers the "Loop-In-Alarm" function of the selected message. pszmsgwin = Pointer to the message window name (OnBtnLoop) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnLoop) BOOL OnBtnMsgFirst(char* pszmsgwin) BOOL AXC_OnBtnMsgFirst(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function switches to the beginning of the message list (First list). pszmsgwin = Pointer to the message window name (OnBtnMsgFirst) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnMsgFirst) WinCC Manual 3-5

210 Global Scripts BOOL OnBtnMsgLast(char* pszmsgwin) BOOL AXC_OnBtnMsgLast(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function switches to the end of the message list (Last list). pszmsgwin = Pointer to the message window name (OnBtnMsgLast) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnMsgLast) BOOL OnBtnMsgNext(char* pszmsgwin) BOOL AXC_OnBtnMsgNext(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function switches to the next message in the message list (Next message). pszmsgwin = Pointer to the message window name (OnBtnMsgNext) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnMsgNext) BOOL OnBtnMsgPrev(char* pszmsgwin) BOOL AXC_OnBtnMsgPrev(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function switches to the previous message in the message list (Previous message). pszmsgwin = Pointer to the message window name (OnBtnMsgPrev) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnMsgPrev) 3-6 WinCC Manual

211 08.97 Global Scripts BOOL OnBtnMsgWin(char* pszmsgwin) BOOL AXC_OnBtnMsgWin(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function calls the process message window (Call process message window). Note: The process message window contains the current messages that have not been acknowledged. pszmsgwin = Pointer to the message window name (OnBtnMsgWin) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnMsgWin) BOOL OnBtnPrint(char* pszmsgwin) BOOL AXC_OnBtnPrint(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function activates reporting (Report function). pszmsgwin = Pointer to the message window name (OnBtnPrint) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnPrint) BOOL OnBtnScroll(char* pszmsgwin) BOOL AXC_OnBtnScroll(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function activates the horizontal and vertical scroll function (Auto scroll On/Off). pszmsgwin = Pointer to the message window name (OnBtnScroll) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnScroll) WinCC Manual 3-7

212 Global Scripts BOOL OnBtnSelect(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function activates the "Set Selection" dialog. pszmsgwin = Pointer to the message window name BOOL OnBtnSinglAckn(char* pszmsgwin) BOOL AXC_OnBtnSinglAckn(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function executes the acknowledgment of a message (single acknowledgment). pszmsgwin = Pointer to the message window name (OnBtnSinglAckn) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnSinglAckn) BOOL OnBtnVisibleAckn(char* pszmsgwin) BOOL AXC_OnBtnVisibleAckn(char* pszmsgwin) Implementation of external message window operation by means of graphic objects. This function executes the acknowledgment of all of the messages visible in the message window (group acknowledgment). pszmsgwin = Pointer to the message window name (OnBtnVisibleAckn) pszmsgwin = Pointer on the name of the OLE-Control-Element (AXC_OnBtnVisibleAckn) 3-8 WinCC Manual

213 08.97 Global Scripts 3.2 GRAPHICS (Standard Functions) void OpenPicture(Picture Picture Name) Opens the picture with the picture name you set. Picture Name = Picture Name 3.3 TAGLOG (Standard Functions) TEMPLATE TOOLBAR BUTTONS The return value for the TOOLBAR BUTTONS functions is the following error code: TRUE: FALSE: The function was executed without errors. An error occured TEMPLATE int TlgGetColumnPosition(char* lpsztemplate) Current position of the column pointer in a table window. Gives the current position of the column pointer in a table window. The name of the table window is transferred with the parameter lpsztemplate. lpsztemplate = Pointer on the name of the table window WinCC Manual 3-9

214 Global Scripts int TlgGetNumberOfColumns(char* lpsztemplate) Number of columns in a table window. Gives the number of columns in a table window. The name of the table window is transferred with the parameter lpsztemplate. lpsztemplate = Pointer on the name of the table window int TlgGetNumberOfRows(char* lpsztemplate) Number of rows in a table window. Gives the number of rows in a table window. The name of the table window is transferred with the parameter lpsztemplate. lpsztemplate = Pointer on the name of the table window int TlgGetNumberOfTrends(char* lpsztemplate) Number of visible trends in a trend window. Gives the number of trends in a trend window. The name of the trend window is transferred with the parameter lpsztemplate. lpsztemplate = Pointer on the name of the trend window 3-10 WinCC Manual

215 08.97 Global Scripts int TlgGetRowPosition(char* lpsztemplate) Current position of the row pointer in a table window. Gives the current position of the row pointer in a table window. The name of the table window is transferred with the parameter lpsztemplate. lpsztemplate = Pointer on the name of the table window char* TlgGetRulerArchivNameTrend(char* lpsztemplate, int ntrend) Archive name of a trend in a trend window at the position of the ruler. Gives the archive name of a trend with the number n trend in a trend window at the position of the ruler. The name of the trend window is transferred with the parameter lpsztemplate. lpsztemplate ntrend = Pointer on the name of the trend window = Number of the trend (0 <= ntrend <= Number of visible trends - 1) SYSTEMTIME TlgGetRulerTimeTrend(char* lpsztemplate, int ntrend) Time of a trend in a trend window at the position of the ruler. Gives the time of a trend with the number n trend in a trend window at the position of the ruler. The name of the trend window is transferred with the parameter lpsztemplate. lpsztemplate ntrend = Pointer on the name of the trend window = Number of the trend (0 <= ntrend <= Number of visible trends - 1) WinCC Manual 3-11

216 Global Scripts double TlgGetRulerValueTrend(char* lpsztemplate, int ntrend) Value of a trend in a trend window at the position of the ruler. Gives the value of a trend with the number n trend in a trend window at the position of the ruler. The name of the trend window is transferred with the parameter lpsztemplate. lpsztemplate ntrend = Pointer on the name of the trend window = Number of the trend (0 <= ntrend <= Number of visible trends - 1) char* TlgGetRulerVariableNameTrend(char* lpsztemplate, int ntrend) Tag name of a trend in a trend window at the position of the ruler. Gives the tag name of a trend with the number n trend in a trend window at the position of the ruler. The name of the trend window is transferred with the parameter lpsztemplate. lpsztemplate ntrend = Pointer on the name of the trend window = Number of the trend (0 <= ntrend <= Number of visible trends - 1) char* TlgGetTextAtPos(char* lpsztemplate, int ncolumn, int nline) Content of a cell of a table window as text. For process value archives and user archives. gives the content of a cell of a table window as text. The cell is specified by ncolumn and nline. The name of the table window is transferred with the parameter lpsztemplate. lpsztemplate ncolumn nline = Pointer on the name of the table window = Number of the column = Number of the line 3-12 WinCC Manual

217 08.97 Global Scripts TOOLBAR BUTTONS BOOL TlgTableWindowPressEditRecordButton(char* lpsztemplatename) The editing of the table window is permitted/not permitted (toggle-function) Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTableWindowPressFirstButton(char* lpsztemplatename) Displays the first data records of the display area in the table window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTableWindowPressHelpButton(char* lpsztemplatename) Displays the online help in the table window Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTableWindowPressInsertRecordButton(char* lpsztemplatename) Inserts a data record Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTableWindowPressLastButton(char* lpsztemplatename) Displays the last data records of the display area in the table window. The number of records displayed depends on the configured time range lpsztemplatename = Pointer on the name of the application window WinCC Manual 3-13

218 Global Scripts BOOL TlgTableWindowPressNextButton(char* lpsztemplatename) Displays the data records following the current display area in the table window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTableWindowPressNextItemButton(char* lpszwindowname) The columns of a table window will be moved to the left by one column, where the left column will be positioned at the right column. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTableWindowPressOpenArchiveVariableSelectionDlgButton(char* lpszwindowname) Opens a dialog for connecting table columns to one archive name and one tag each. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTableWindowPressOpenDlgButton(char* lpsztemplatename) The dialog for the online configuration of the table window is displayed Parameter: lpsztemplatename = Pointer on the name of the application window 3-14 WinCC Manual

219 08.97 Global Scripts BOOL TlgTableWindowPressOpenItemSelectDlgButton(char* lpszwindowname) Opens a dialog for selecting the visible columns. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTableWindowPressOpenTimeSelectDlgButton(char* lpszwindowname) Opens a dialog for connecting table columns to one time range each, in which the values are displayed. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTableWindowPressPrevButton(char* lpsztemplatename) Displays the data records preceding the current display area in the table window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTableWindowPressPrevItemButton(char* lpszwindowname) The columns of a table window will be moved to the right by one column, where the right column will be positioned at the left column. Parameter: lpszwindowname = Pointer on the name of the application window WinCC Manual 3-15

220 Global Scripts BOOL TlgTableWindowPressRemoveRecordButton(char* lpsztemplatename) Deletes a data record Parameter: lpsztemplatename = Pointer on the name of a the application window BOOL TlgTableWindowPressStartStopButton(char* lpsztemplatename) The updating of the table window is turned on/off (toggle-function) Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressFirstButton(char* lpsztemplatename) Displays the first data records of the display area in the trend window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressHelpButton(char* lpsztemplatename) Displays the online help for the trend window Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressLastButton(char* lpsztemplatename) Displays the last data records of the display area in the trend window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window 3-16 WinCC Manual

221 08.97 Global Scripts BOOL TlgTrendWindowPressLinealButton(char* lpsztemplatename) Turns the ruler for the trend window on/off (toggle-function). The ruler can be moved via the left or right cursor keys. Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressNextButton(char* lpsztemplatename) Displays the data records following the current display area in the trend window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressNextItemButton(char* lpszwindowname) Moves all trends in a trend window one layer to the front. The trend in the front will be moved to the back. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTrendWindowPressOneToOneButton(char* lpsztemplatename) The trend window will revert to the state it had before the magnifying glass was turned on. The magnifying glass is turned off. Selecting a zoom area is only possible with a mouse. See also TlgTrendWindowPressZoomInButton Parameter: lpsztemplatename = Pointer on the name of the application window WinCC Manual 3-17

222 Global Scripts BOOL TlgTrendWindowPressOpenArchiveTagSelectionDlgButton(char* lpszwindowname) Opens a dialog for connecting trends in a trend window to one archive name and one tag each. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTrendWindowPressOpenDlgButton(char* lpsztemplatename) The dialog for the online configuration of the trend window is displayed. Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressOpenItemSelectDlgButton(char* lpszwindownumber) Opens a dialog for selecting the visible trends and the trend that is to be displayed at the front. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTrendWindowPressOpenTimeSelectDlgButton(char* lpszwindownumber) Opens a dialog for connecting trends to one time range each, in which the values are displayed. Parameter: lpszwindowname = Pointer on the name of the application window 3-18 WinCC Manual

223 08.97 Global Scripts BOOL TlgTrendWindowPressPrevButton(char* lpsztemplatename) Displays the data records preceding the current display area in the trend window. The number of records displayed depends on the configured time range Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressPrevItemButton(char* lpszwindowname) Moves all trends in a trend window one layer to the back. The trend in the back will be moved to the front. Parameter: lpszwindowname = Pointer on the name of the application window BOOL TlgTrendWindowPressStartStopButton(char* lpsztemplatename) The updating of the trend window is turned on/off (toggle-function) Parameter: lpsztemplatename = Pointer on the name of the application window BOOL TlgTrendWindowPressZoomInButton(char* lpsztemplatename) The magnifying glass is turned on. Selecting a zoom area is only possible with a mouse. Parameter: lpsztemplatename = Pointer on the name of the application window WinCC Manual 3-19

224 Global Scripts WINCC (Standard Functions) void OnErrorExecute(CCAPErrorExecute ErrorExecute) OnErrorExecute will be called up, if an error occurred while executing an action or function. This enables you to perform your own error treatment and to determine the exact error cause. Parameter: ErrorExecute = Structure, which informs you about the occurred error Structure Definition: typedef struckt { DWORD dwcurrentthreadid; //Thread ID of the current thread DWORD dwerrorcode1; //Error code 1 DWORD dwerrorcode2; //Error code 2 BOOL bcycle; //cycle/acycle char* szapplicationname; //Name of the application char* szfunctionname; //Name of the function char* sztagname; //Name of the tag LPVOID lpparam; //Pointer to the action stack DWORD dwparamsize; //Size of the action stack DWORD dwcycle; //Cycle of the variable CMN_ERROR* perror; //Pointer to CMN_ERROR } CCAPErrorExecute; 3-20 WinCC Manual

225 08.97 Global Scripts The meaning of the individual error markings and the transferred structure elements depending on them, is described in the following table: x x x x x Exception in the action x x x x x Exception while accessing the return result x x x x x Stack overflow while executing the action x x x x x Division by 0 in the action x x x x x Access to a symbol not present in the action x x x x x Access violation in the action x x x Unknown function x x Action contains no P-Code x x Function name is wrong x x x x x Return value type is invalid ff x x x x x Error in the Ciss Compiler while loading the action x x x x x x x Tag is not defined x x x x x x x Tag timeout x x x x x x x x Tag can not be supplied in the desired format x x x x x x x x Tag delivers a status violation, the status is located at CMN_ERROR.dwError x x x x x x Error at PDLRTGetProp x x x x x x Error at PDLRTSetProp x x x x x x Error at DM-Call WinCC Manual 3-21

226 Global Scripts WINDOWS (Standard Functions) unsigned int ProgramExecute(char* Programm_Name) Starts the program with the name provided. Program_Name = Pointer to the program name. 3.6 Options (Standard Functions) BOOL GetCSigPicture(LPCSTR lpcpicturename, LPCSTR lpcobjectname, LPCSTR lpcpropertyname, LPSTR lppicturename) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. DWORD GetSignificantMask(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. BOOL PASSCheckAreaPermission(LPCTSTR areaname) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Authorization available FALSE = No authorization available Determines if the user has general authorization for operating a specific system. areaname = Name of the system 3-22 WinCC Manual

227 08.97 Global Scripts BOOL PASSCheckAreaLevelPermission(LPCTSTR areaname, DWORD level) This function is a part of the ADVANCED PROCESS CONTROL option package. Error code TRUE = Authorization available FALSE = No authorization available Checks whether the user has the authorization for the transferred system when the authorization level is transferred. areaname level = Name of the system = Authorization level as a number value void PASSLoginDialog(TCHAR ch) This function is a part of the BASIC PROCESS CONTROL option package. Displays the Login dialog and loads the user data to shared memory when a successful login occurs. ch = Specification of the monitor on which the login dialog is to be opened (for monitor 1, input the "1" character.). WinCC Manual 3-23

228 Global Scripts Report (Standard Functions) void ReportJob(LPSTR lpjobname, LPSTR lpmethodname) This function will be replaced by the functions RPTJobPreview and RPTJobPrint and should therefore not be used any more. Depending on the value of the parameter lpmethodname, a print job or a print preview will be started. Parameter lpjobname = Pointer on the name of the print job lpmethodname = Pointer on the name of the function mode "PRINT" Print job will be executed "PREVIEW" Print preview is started BOOL RPTJobPreview(LPSTR lpjobname) Starts the preview of a print job. Parameter lpjobname = Pointer on the name of the print job BOOL RPTJobPrint(LPSTR lpjobname) Starts the print job. Parameter lpjobname = Pointer on the name of the print job 3-24 WinCC Manual

229 08.97 Global Scripts 3.8 Split Screen Manager (Standard Functions) BOOL AcknowledgeAllPicture(LPCTSTR pictname) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. void GetASVarIndex(int nvarindex, int nclassindex, BOOL* bactive, BOOL* bquit) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. int GetIndexFromMask(DWORD dwmask) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. void GetMessageClassFromVar(TCHAR* VarName, int nclassindex, BOOL* bactive, BOOL* bquit) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. BOOL GetCountPicture(LPTSTR aktname, LPTSTR newname, int nnewnamelength, DWORD dwbitmask) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. BOOL LoopInAlarm(TCHAR* TagName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Authorization available FALSE = No authorization available This function displays a prototype picture for the tag name provided and links the prototype picture with the tag name. TagName = Pointer to the tag name void profile(long pos_no, long value, LPCTSTR lpszpicturename) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. WinCC Manual 3-25

230 Global Scripts BOOL PTMUnload() This function is a part of the BASIC PROCESS CONTROL option package. This function unloads the Picture Tree Manager. For internal use only. void reset_hoer(tag var) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. void SetASVarIndex(int nvarindex, int nclassindex, BOOL bactive, BOOL bquit) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. void SetMessageClassToVar(TCHAR* VarName, int nclassindex, BOOL bactive, BOOL bquit) This function is a part of the BASIC PROCESS CONTROL option package. For internal use only. BOOL SFCLoopInAlarm(TCHAR* TagInfo) This function is a part of the ADVANCED PROCESS CONTROL option package. Error code TRUE = Function was executed FALSE = Function was not executed or incorrect parameter input This function opens a view to the SFC plan that triggered the message at the measurement point provided. TagInfo = Pointer to the buffer on which the information about the measurement point is stored 3-26 WinCC Manual

231 08.97 Global Scripts BOOL SSMChangeButtonField(char Screen, char* PictureName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the button area FALSE = Error; Display not changed The picture named lptpicturename is displayed in the button area of the monitor described with Screen. Screen = contains the number of the monitor as a character string PictureName = Pointer to the name, including the extension, of the picture to be displayed in the button area BOOL SSMChangeOverviewField(char Screen, char* PictureName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the overview area FALSE = Error; Display not changed The picture named lptpicturename is displayed in the overview area of the monitor described with Screen. Screen = contains the number of the monitor as a character string PictureName = Pointer to the name, including the extension, of the picture to be displayed in the overview area WinCC Manual 3-27

232 Global Scripts BOOL SSMChangeWorkField(char Screen, char* PictureName, BOOL Store) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the overview area FALSE = Error; Display not changed The contents of a file are displayed in the workspace of the monitor described with Screen. Screen = contains the number of the monitor as a character string PictureName = Pointer to the name, including the extension, of the PDL file to be displayed. If the name specified in PictureName is included in the hierarchy of the "Picture Tree Manager," the area name is transmitted and saved automatically. You can access the area name by means of the "SSMGetAreaFromPicturePath" function. If the file specified in PictureName is not in the hierarchy, (picture prototype), you can set the area name by calling the SSMRTSetAreaToPicturePath function. Store = Update the picture store if TRUE. (Default setting) BOOL SSMCheckWorkFieldDown(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Picture in the first lower node exists. FALSE = Error or the picture in the first lower node does not exist. This function determines which picture in the Screen workspace is displayed and checks whether the picture exists in the corresponding lower node in the hierarchy of the "Picture Tree Manager." Screen = contains the number of the monitor as a character string 3-28 WinCC Manual

233 08.97 Global Scripts BOOL SSMCheckWorkFieldLeft(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Picture in the node to the left exists. FALSE = Error or picture in the node to the left does not exist. This function determines which picture in the Screen workspace is displayed and checks whether the picture exists in the node to the left in the hierarchy of the "Picture Tree Manager." Screen = contains the number of the monitor as a character string BOOL SSMCheckWorkFieldRight(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Picture in the node to the right exists. FALSE = Error or picture in the node to the right does not exist. This function determines which picture in the Screen workspace is displayed and checks whether the picture exists in the node to the right in the hierarchy of the "Picture Tree Manager." Screen = contains the number of the monitor as a character string WinCC Manual 3-29

234 Global Scripts BOOL SSMCheckWorkFieldUp(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Picture in the next higher node exists. FALSE = Error or the picture in the next higher node does not exist. This function determines which picture in the Screen workspace is displayed and checks whether the picture exists in the corresponding higher node in the hierarchy of the "Picture Tree Manager." Screen = contains the number of the monitor as a character string BOOL SSMChgWorkFieldDown(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the workspace. FALSE = Error, display not changed in the workspace. This function determines which picture is displayed in the monitor workspace. It gets the appropriate picture from the first lower node in the hierarchy of the "Picture Tree Manager" and displays this new picture in the workspace of Screen. The picture stack is updated automatically. Screen = contains the number of the monitor as a character string 3-30 WinCC Manual

235 08.97 Global Scripts BOOL SSMChgWorkFieldLeft(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the workspace. FALSE = Error, display not changed in the workspace. This function determines which picture is displayed in the Screen workspace. It gets the appropriate picture from the node to the left in the hierarchy of the "Picture Tree Manager" and displays this picture in the workspace of Screen. The picture stack is updated automatically. Screen = contains the number of the monitor as a character string BOOL SSMCheckWorkFieldRight(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the workspace. FALSE = Error, display not changed in the workspace. This function determines which picture is displayed in the Screen workspace. It gets the appropriate picture from the node to the right in the hierarchy of the "Picture Tree Manager" and displays this picture in the workspace of Screen. The picture stack is updated automatically. Screen = contains the number of the monitor as a character string WinCC Manual 3-31

236 Global Scripts BOOL SSMCheckWorkFieldUp(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Display changed in the workspace. FALSE = Error, display not changed in the workspace. This function determines which picture is displayed in the Screen workspace. It gets the appropriate picture from the next higher node in the hierarchy of the "Picture Tree Manager" and displays this picture in the workspace of Screen. The picture stack is updated automatically. Screen = contains the number of the monitor as a character string BOOL SSMDeleteUserSettings(LPCTSTR lpctusername) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = User-related settings deleted. FALSE = Error Use this function to delete all of the files of the "Split Screen Manager" that were created by lpctusername in the standard folder of lpctusername. Files that belong to other users or other editors are unaffected. Files that belong to the current user in other folders are also not affected. lpctusername = Pointer to the name of the user whose settings are to be deleted WinCC Manual

237 08.97 Global Scripts BOOL SSMGetAreaFromPath(char* PicturePath, char* AreaName, int len) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = User-related settings deleted. FALSE = Error This function gets the system assignment of the specified picture path. The function does not use the "Picture Tree Manager." PicturePath must contain the complete path of a picture displayed in the workspace or in one of the top fields. PicturePath = Pointer to the name of the picture, including the path. You do not need to input the extension. AreaName = Pointer to a buffer on which the area/system name should be stored. len = maximum length of the AreaName buffer BOOL SSMGetAreaFromWorkField(char Screen, char* AreaName, int nareanamelen) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function gets the system assignment of the workspace in the monitor specified. Screen = contains the number of the monitor as a character string AreaName = Pointer to a buffer on which the area/system name should be stored. nareanamelen = maximum length of the AreaName buffer WinCC Manual 3-33

238 Global Scripts BOOL SSMGetAutoLoadSettings() This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Automatic load activated FALSE = Error This function determines whether the user -specific settings should be loaded automatically in the run-time system after a user has logged on. BOOL SSMGetContainerToPicture(char* PictureName, char* ReturnContainer, int len) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got container FALSE = Error This function uses the Picture Tree Manager to get the container that is appropriate for the picture specified. PictureName = Name of the picture ReturnContainer = Pointer to a buffer on which the container name should be stored len = maximum length of the ReturnContainer buffer 3-34 WinCC Manual

239 08.97 Global Scripts BOOL SSMGetContPict(int area_no, int subarea_no, char* ReturnPictureName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got picture name FALSE = Error This function gets the picture name of the container specified by the system number and the subsystem number. If the subsystem number is zero, the function gets the picture name of the system container. area_no = System number subarea_no = Subsystem number ReturnPictureName = Pointer to a buffer on which the picture name should be stored. BOOL SSMGetContainer(int area_no, int subarea_no, char* ReturnName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got container name FALSE = Error This function gets the container name of the container specified by the system number and subsystem number. If the subsystem number is zero, the system gets the container name of the system container. area_no = System number subarea_no = Subsystem number ReturnName = Pointer to a buffer on which the container name should be stored. WinCC Manual 3-35

240 Global Scripts BOOL SSMGetRootToPicture(char* PictureName, char* ReturnRootContainer) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got system container name FALSE = Error This function uses the picture name to get the system container name. PictureName = Picture name ReturnRootContainer = Pointer to a buffer on which the system container name should be stored char SSMGetScreen(char* lpszpicturename) This function is a part of the BASIC PROCESS CONTROL option package. This function specifies the monitor on which the selected picture is displayed. lpszpicturename = Pointer to the picture to be examined BOOL SSMGetWorkFieldPicture(char Screen, char* ReturnPictureName, int len) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got picture name FALSE = Error This function gets the name (including the extension) of the picture currently displayed in the workspace of Screen. Screen = Contains the number of the monitor as a character string. ReturnPictureName = Pointer to a buffer on which the name of the picture should be stored len = Length of the ReturnPictureName buffer 3-36 WinCC Manual

241 08.97 Global Scripts BOOL SSMGetWorkFieldCoordinates(TCHAR cmonitor, int* pleft, int* ptop, int* pwidth, int* pheight) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got size and location of the workspace. FALSE = Error This function gets the location and position of the workspace for the cmonitor monitor and loads it in the pleft, ptop, pwidth and pheight parameters. cmonitor = Contains the number of the monitor as a character string. pleft = Pointer to a storage location on which the X coordinates of the workspace should be loaded ptop = Pointer to a storage location on which the Y coordinates of the workspace should be loaded pwidth = Pointer to a storage location on which the width of the workspace should be loaded pheight = Pointer to a storage location on which the height of the workspace should be loaded. void SSMGetWorkFieldPath(char Screen, char* ReturnBaseName, int Length) This function is a part of the BASIC PROCESS CONTROL option package. This function gets the complete path of the picture in the workspace from the monitor specified. Screen = Contains the number of the monitor as a character string ReturnBaseName = Pointer to a button on which the path specification should be loaded Length = Length of the ReturnBaseName buffer WinCC Manual 3-37

242 Global Scripts BOOL SSMLoadCurrentFields(LPCTSTR lpctsettingsname, LPCTSTR lpctusername) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got path settings FALSE = Error From the file specified in lpctsettingsname, this function loads the user-specific information as long as the name specified in lpctusername corresponds to the user name stored in the file. The following information is loaded for each monitor: Name of the picture in the overview area Name of the picture in the workspace Name of the picture in the button area Names and positions (PosX, PosY, Width, Height) of all of the pictures displayed in process windows at this point Picture stack Picture store Names and positions (PosX, PosY, Width, Height) of all of the areas visible at this point lpctsettingsname = Pointer to the name of the file in which the user-specific information is stored. If lpctsettingsname does not contain any name extensions, the extension ".SSM" is attached. If lpctsettingsname does not contain any path specification, the function searches for it in the SSM standard folder of the lpctusername user. If lpctsettingsname contains relative or absolute path specifications, then that path is used without any changes (not recommended). lpctusername = Pointer to the name of the user whose settings are to be loaded. If there is no user name entered in lpctusername (ZERO or empty character string), the name of the user that is currently logged on is used WinCC Manual

243 08.97 Global Scripts BOOL SSMLoadSettings(TCHAR cmonitor) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got path settings FALSE = Error This function displays the user-specific settings in a dialog window. The following information is displayed for the monitor specified: Name of the picture in the overview area Name of the picture in the workspace Name of the picture in the button area Names and positions (PosX, PosY, Width, Height) of all of the pictures displayed in process windows at this point Picture stack Picture store Names and positions (PosX, PosY, Width, Height) of all of the areas visible at this point cmonitor = Number of the monitor as a character string on which the selection dialog is to be displayed. BOOL SSMOpenSpecField(char Screen, char* FieldName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function opens a spec field on the monitor specified. Screen = Contains the number of the monitor as a character string FieldName = Pointer to the buffer on which the spec field name is stored WinCC Manual 3-39

244 Global Scripts BOOL SSMOpenTopField(char Screen, char* PictureName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Opened process window FALSE = Error or no top field available This function opens a process window of variable size and uses it to display the picture specified by PictureName. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture to be displayed in the process window BOOL SSMOpenTopFieldFixedSize(char Screen, char* PictureName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Opened process window FALSE = Error This function opens a process window of a set size and uses it to display the picture specified by PictureName. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture to be displayed in the process window 3-40 WinCC Manual

245 08.97 Global Scripts BOOL SSMPictureStoreGet(char Screen, char* PictureName, int len) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Edited picture store FALSE = Error This function loads a picture name from the picture store of the monitor specified. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture that is stored in the picture store len = Length of the PictureName buffer int SSMPictureStoreNum(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. This function specifies the picture number of the picture located in the picture store. Screen = Contains the number of the monitor as a character string WinCC Manual 3-41

246 Global Scripts BOOL SSMPictureStoreSet(char Screen, char* PictureName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Edited picture store FALSE = Error This function stores a picture name in the picture store of the monitor specified. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture that is stored in the picture store. unsigned int SSMProgramExecute(char Screen, char * szcommandline) This function is a part of the BASIC PROCESS CONTROL option package. This function starts an application on the monitor specified. Screen = Contains the number of the monitor as a character string szcommandline = Command line (program name including parameters) 3-42 WinCC Manual

247 08.97 Global Scripts BOOL SSMPictureMemoryInquire(char Screen, char* PictureName, int len, int* ReturnCount) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function gets the picture name of the top memory area in a picture stack. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture that is stored in the picture stack len = Length of the PictureName buffer ReturnCount = Pointer to the number of pictures (elements) in the picture store of the monitor Screen int SSMPictureMemoryNum(char Screen) This function is a part of the BASIC PROCESS CONTROL option package. This function specifies how many pictures are located in the picture stack of the monitor specified. A maximum of 8 pictures can be stored in the picture stack. Screen = Contains the number of the monitor as a character string WinCC Manual 3-43

248 Global Scripts BOOL SSMPictureMemoryStore(char Screen, char* PictureName, int* ReturnCount) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function saves a picture from the appropriate monitor to the picture stack. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture that is stored in the picture stack ReturnCount = Pointer to the number of pictures (elements) in the picture stack of the monitor BOOL SSMPictureMemoryRestore(char Screen, char* PictureName, int len, int* ReturnCount) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function loads a picture to the appropriate monitor from the picture stack. The memory is then available again. Screen = Contains the number of the monitor as a character string PictureName = Pointer to the name of the picture that is stored in the picture stack len = Length of the PictureName buffer ReturnCount = Pointer to the number of pictures (elements) in the picture stack of the monitor Screen 3-44 WinCC Manual

249 08.97 Global Scripts BOOL SSMSetAreaNameToPicture(char* PicturePath, char* AreaName) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function sets the area name for a picture path. The area name is not tested by this function but is stored directly. PicturePath = Pointer to the name of the picture, including the path settings. The extension does not have to be given. AreaName = Pointer to the area name to be connected to the picture path BOOL SSMSetLanguage(DWORD dwlanguage) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function sets the language to be used in RUNTIME mode. dwlanguage = The language to be used in RUNTIME as a number value WinCC Manual 3-45

250 Global Scripts BOOL SSMStoreCurrentFields(LPCTSTR lpctsettingsname, LPCTSTR lpctusername) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got path settings FALSE = Error This function creates a file specified in lpctsettingsname and saves user-specific information in it. The following information is stored for each monitor: Name of the picture in the overview area Name of the picture in the workspace Name of the picture in the button area Names and positions (PosX, PosY, Width, Height) of all of the pictures displayed in process windows at this point Picture stack Picture store Names and positions (PosX, PosY, Width, Height) of all areas visible at this time lpctsettingsname = Pointer to the name of the file in which the user-specific information is to be stored. If a file already exists with the name specified in lpctsettingsname, it is overwritten. There are no limitations regarding the file name. If you provide an extension, it must be ".SSM." If lpctsettingsname does not contain any name extensions, the ".SSM" extension is added. If lpctsettingsname does not contain any path specification, the file is set up in the SSM standard folder of the lpctusername user. If lpctsettingsname contains relative or absolute path specifications, that path is used without any changes (not recommended). lpctusername = Pointer to the name of the user whose settings are to be loaded. If there is no user name entered in lpctusername (ZERO or empty character string), the name of the user that is currently logged on is used WinCC Manual

251 08.97 Global Scripts BOOL SSMStoreSettings(TCHAR cmonitor) This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = Got path settings FALSE = Error This function stores the user-specific settings in a file selected by means of a selection dialog. The following information is stored for the monitor specified: Name of the picture in the overview area Name of the picture in the workspace Name of the picture in the button area Names and positions (PosX, PosY, Width, Height) of all of the pictures displayed in process windows at this point Picture stack Picture store Names and positions (PosX, PosY, Width, Height) of all areas visible at this time cmonitor = Number of the monitor as a character string on which to display the selection dialog. BOOL SSMUnload() This function is a part of the BASIC PROCESS CONTROL option package. Error code TRUE = No errors FALSE = An error occurred This function unloads the Split Screen Manager. For internal use only. WinCC Manual 3-47

252 Global Scripts WinCC Manual

253 08.97 Global Scripts 4 Internal Functions Use internal functions to make graphic objects and archives dynamic. You can also use them in project functions, standard functions, and Global Script actions. Internal functions are divided into the following categories: alarm contains functions for starting and stopping the reception of single messages and for specifying filters. allocate Contains functions for reserving and enabling working memory. c_bib Contains functions from the C standard library. graphics Contains functions for reading and setting properties of graphic objects. tag Contains functions for writing and reading process tags. wincc contains functions for language switching, for deactivating runtime, and for exiting WinCC. WinCC Manual 4-1

254 Global Scripts alarm (Internal Functions) BOOL MSRTSetMsgFilter (DWORD dwserviceid, LPMSG_FILTER_STRUCT lpmsgfilter, LPCMN_ERROR lperror); Set a new filter for the service displayed. dwserviceid = Service, for which the filter is to be set lpmsgfilter = Filter to be used lperror = Pointer that acquires the extended error message BOOL MSRTStartMsgService (LPDWORD lpdwserviceid, MSG_SERVICE_NOTIFY_PROC lpfnnotifyproc, LPMSG_FILTER_STRUCT lpmsgfilter, DWORD dwnotifymask, LPVOID lpvuser, LPCMN_ERROR lperror); Start the service for receiving single messages. You can create your own message window. lpdwserviceid = Contains the service ID after the function has been called up successfully. lpfnnotifyproc = Notification function for transferring messages to the service lpmsgfilter = Pointer to the filter conditions: (NULL = all messages) dwnotifymask = Specifies which messages are sent. lpvuser = User data are sent to callback. lperror = Pointer that acquires the extended error message BOOL MSRTStopMsgService (DWORD dwserviceid, LPCMN_ERROR lperror); Stop the service for receiving single messages. dwserviceid = ID number of the service you want to stop lperror = Pointer that acquires the extended error message 4-2 WinCC Manual

255 08.97 Global Scripts 4.2 allocate The "allocate" function category contains functions for reserving and enabling work memory. void SysFree(void* lpfree); Releases memory that was reserved with the "SysMalloc" function. lpfree = Pointer void* SysMalloc(unsigned long int size); Reserves memory for an action. The memory range is allocated to the action. When the action is completed and the result is sent, the system releases the memory. Use the "SysFree" function to release the memory yourself. Example: Reserve memory for the return value of the action. char* main(...); { char* returnwert; char text[17]; returnwert=sysmalloc(17); strcpy(returnwert,&text[0]; return returnwert; } size = Size of the memory in bytes WinCC Manual 4-3

256 Global Scripts c_bib The functions category c_bib contains C functions from the C library and is divided into the following areas: ctype math memory stdio stdlib string time stdio itself is divided into the following areas: char_io directio error file file_pos output You can find a description of this function in related technical literature. 4-4 WinCC Manual

257 08.97 Global Scripts 4.4 graphics The Graphics function category is divided into the following functions: get Functions Functions for transmitting attribute values. The get functions themselves are divided into the following function groups: axes color fill flash focus font general geometry i_o limits link miscs ole_control pictures property state style The get functions need the following two parameters: lpszpicturename: Picture name (without name extension pdl) lpszobjectname: Object name WinCC Manual 4-5

258 Global Scripts set Functions Functions for setting attribute values. The set functions themselves are divided into the following function groups: axes color fill flash focus font geometry i_o limits link miscs ole_control pictures property state style The set functions need the following three parameters: lpszpicturename: Picture name (without name extension pdl) lpszobjectname: Object name 3. Parameter: Attribute value The return value for the set functions is the following error code: TRUE: The function was executed without errors. FALSE: An error occurred. 4-6 WinCC Manual

259 08.97 Global Scripts graphics-get-axes Functions BOOL GetAlignment (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects TRUE: The text is to the right of the bar. FALSE: The text is to the left of the bar. double GetAxisSection (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Axis section: the value difference between two neighboring axis labels. BOOL GetExponent (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects TRUE means the numbers on the axis are exponents. FALSE means the numbers on the axis are in decimal format. long int GetLeftComma (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Number of digits to the left of the decimal point on the axis. BOOL GetLongStrokesBold (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects TRUE means the long axis sections on the bar scale are displayed as bold. FALSE means the long axis sections on the bar scale are displayed as normal. WinCC Manual 4-7

260 Global Scripts BOOL GetLongStrokesOnly (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects TRUE means that only the long axis sections are displayed in the bar scale. FALSE means that both the long axis sections and the subsections are displayed in the bar scale. long int GetLongStrokesSize(LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Number value that controls the length of the long axis sections long int GetLongStrokesTextEach (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Number value that controls the text labels of the long axis sections Example: Return Value = 1 -> Each long axis section is labeled. Return Value = 2 -> Every other long axis section is labeled. long int GetRightComma (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Number of digits to the right of the decimal point on the axis. long int GetScaleTicks (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Scale marks as a percentage value of the entire height of the bar. BOOL GetScaling (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects TRUE means with an additional scale. FALSE means without an additional scale. 4-8 WinCC Manual

261 08.97 Global Scripts long int GetScalingType(LPCTSTR lpszpicturename, LPCTSTR Only with bar objects Return Value Number value that determines the type of bar scaling 0: Linear (same weight) 1: Logarithmic (lower values emphasized) 2: Negative logarithmic (higher values emphasized) 3: Automatic (linear) 4: Tangent (high and low values emphasized) 5: Squared (high values emphasized) 6: Cubic (high values heavily emphasized) WinCC Manual 4-9

262 Global Scripts graphics-get-color Functions long int GetBackColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the background color of the object Note: If the function call relates to the entire picture, set the parameter lpszobjectname = NULL. long int GetBackColor2 (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color of bar objects long int GetBackColor3 (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar background color for bar objects long int GetBackColorBottom(LPCTSTR lpszpicturename, LPCTSTR Number value that sets the bottom right background color with slider objects. long int GetBackColorTop(LPCTSTR lpszpicturename, LPCTSTR Number value that sets the top left background color with slider objects. long int GetBorderBackColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the line or border background color long int GetBorderColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the line or border color 4-10 WinCC Manual

263 08.97 Global Scripts long int GetBorderColorBottom (LPCTSTR lpszpicturename, LPCTSTR Number value of the color for the right and bottom part of the 3D border (shadow) long int GetBorderColorTop (LPCTSTR lpszpicturename, LPCTSTR Number value of the color for the left and top part of the 3D border long int GetButtonColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the button color in slider objects long int GetColorBottom (LPCTSTR lpszpicturename, LPCTSTR Number value of the color for the bottom/right slider position (low limit) long int GetColorTop (LPCTSTR lpszpicturename, LPCTSTR Number value of the color for the top/left slider position (high limit) long int GetFillColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the color of the fill pattern Note: If the function call relates to the entire picture, set the parameter lpszobjectname = NULL. long int GetForeColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the font color WinCC Manual 4-11

264 Global Scripts long int GetGridColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the grid color of the Graphics Designer workspace long int GetItemBorderBackColor(LPCTSTR lpszpicturename, LPCTSTR Display of the separate line background color in a "Text List" object. long int GetItemBorderColor(LPCTSTR lpszpicturename, LPCTSTR Display of the separate line color in a "Text List" object. long int GetScaleColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the scale color in bar objects long int GetSelBGColor(LPCTSTR lpszpicturename, LPCTSTR Display of the background color for selected entry in the browser list in a "Text List" object. long int GetSelTextColor(LPCTSTR lpszpicturename, LPCTSTR Display of the font color for selected entry in the browser list in a "Text List" object. long int GetTrendColor (LPCTSTR lpszpicturename, LPCTSTR Number value of the trend color in bar objects 4-12 WinCC Manual

265 08.97 Global Scripts long int GetUnselBGColor(LPCTSTR lpszpicturename, LPCTSTR Display of the background color for unselected entries in the browser list for a "Text List" object. long int GetUnselTextColor(LPCTSTR lpszpicturename, LPCTSTR Display of the text color for unselected entries in the browser list for a "Text List" object. WinCC Manual 4-13

266 Global Scripts graphics-get-fill Functions BOOL GetFilling (LPCTSTR lpszpicturename, LPCTSTR TRUE means the dynamic filling attribute with the background color is active. An object with a solid border (rectangle, rounded rectangle, circle, ellipse, pie segment, ellipse segment, polygon, text, I/O field, and others) can be filled. FALSE means the dynamic filling attribute with the background color is not active. long int GetFillingIndex (LPCTSTR lpszpicturename, LPCTSTR Number value of the current fill level (percentage) 4-14 WinCC Manual

267 08.97 Global Scripts graphics-get-flash Functions long int GetBackFlashColorOff (LPCTSTR lpszpicturename, LPCTSTR Number value of the background color when the flashing attribute is switched off long int GetBackFlashColorOn (LPCTSTR lpszpicturename, LPCTSTR Background color when the flashing attribute is switched on as number value long int GetBorderFlashColorOff (LPCTSTR lpszpicturename, LPCTSTR Number value of the border color or line color when the flashing attribute is switched off long int GetBorderFlashColorOn (LPCTSTR lpszpicturename, LPCTSTR Number value of the border color or line color when the flashing attribute is switched on BOOL GetFlashBackColor (LPCTSTR lpszpicturename, LPCTSTR TRUE means background flashing is active. FALSE means background flashing is not active. BOOL GetFlashBorderColor (LPCTSTR lpszpicturename, LPCTSTR TRUE means border or line flashing is active. FALSE means border or line flashing is not active. WinCC Manual 4-15

268 Global Scripts BOOL GetFlashForeColor (LPCTSTR lpszpicturename, LPCTSTR TRUE means text flashing is active. FALSE means text flashing is not active. long int GetFlashRateBackColor (LPCTSTR lpszpicturename, LPCTSTR Background flash frequency. long int GetFlashRateBorderColor (LPCTSTR lpszpicturename, LPCTSTR Line or border flash frequency. long int GetFlashRateForeColor (LPCTSTR lpszpicturename, LPCTSTR Text flash frequency. long int GetForeFlashColorOff (LPCTSTR lpszpicturename, LPCTSTR Number value of the text color when the flashing attribute is switched off long int GetForeFlashColorOn (LPCTSTR lpszpicturename, LPCTSTR Number value of the text color when the flashing attribute is switched on 4-16 WinCC Manual

269 08.97 Global Scripts graphics-get-focus-functions char* Get_Focus(); Name of the object the focus is placed on or has been placed on last graphics-get-font Functions long int GetAlignmentLeft (LPCTSTR lpszpicturename, LPCTSTR Number value of the horizontal alignment (aligned left, centered, aligned right) of the text long int GetAlignmentTop (LPCTSTR lpszpicturename, LPCTSTR Number value of the vertical alignment (aligned top, center, bottom) of the text BOOL GetFontBold (LPCTSTR lpszpicturename, LPCTSTR TRUE means the "Bold" text attribute is set. FALSE means the "Bold" text attribute is not set. BOOL GetFontItalic (LPCTSTR lpszpicturename, LPCTSTR TRUE means the "Italic" text attribute is set. FALSE means the "Italic" text attribute is not set. char* GetFontName (LPCTSTR lpszpicturename, LPCTSTR Pointer to the name of the font that is currently set. WinCC Manual 4-17

270 Global Scripts long int GetFontSize (LPCTSTR lpszpicturename, LPCTSTR Current font size lpszpicturename = Name of the picture lpszobjectname = Name of the object BOOL GetFontUnderline (LPCTSTR lpszpicturename, LPCTSTR TRUE means the "Underline" text attribute is set. FALSE means the "Underline" text attribute is not set. BOOL GetOrientation (LPCTSTR lpszpicturename, LPCTSTR TRUE means the text orientation is horizontal. FALSE means the text orientation is vertical. char* GetText (LPCTSTR lpszpicturename, LPCTSTR Pointer to static text. For radio- and check-boxes, as well as for polygons and polylines, the element or point has to be set with the SetIndex function before calling the GetText function WinCC Manual

271 08.97 Global Scripts graphics-get-general Functions long int GetLayer (LPCTSTR lpszpicturename, LPCTSTR Provides the picture layer on which the object is located graphics-get-geometry Functions long int GetActualPointLeft (LPCTSTR lpszpicturename, LPCTSTR Current horizontal position (X axis ) of the corner point for polygon and polyline object types in relation to the origin of the picture. The SetIndex function sets the current point of the polygon. long int GetActualPointTop (LPCTSTR lpszpicturename, LPCTSTR Current vertical position (Y axis) of the corner point for polygon and polyline object types in relation to the origin of the picture. The SetIndex function sets the current point of the polygon. long int GetBoxCount (LPCTSTR lpszpicturename, LPCTSTR Number of selected check boxes in a check box area or option buttons in an option group area. long int GetDirection (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar direction (up, down, left, or right) in bar objects long int GetEndAngle (LPCTSTR lpszpicturename, LPCTSTR End angle of pie and ellipse segments as well as circular and ellipse arcs WinCC Manual 4-19

272 Global Scripts BOOL GetGrid (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the grid is turned on in the workspace of the Graphics Designer. FALSE means that the grid is turned off in the workspace of the Graphics Designer. long int GetGridHeight (LPCTSTR lpszpicturename, LPCTSTR Height of the grid in the workspace of the Graphics Designer long int GetGridWidth (LPCTSTR lpszpicturename, LPCTSTR Width of the grid in the workspace of the Graphics Designer long int GetHeight (LPCTSTR lpszpicturename, LPCTSTR Height of the rectangle surrounding an object Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. long int GetLeft (LPCTSTR lpszpicturename, LPCTSTR Current location on the X axis of the left upper corner of the rectangle surrounding an object long int GetPointCount (LPCTSTR lpszpicturename, LPCTSTR Number of corners for a polygon or polyline long int GetRadius (LPCTSTR lpszpicturename, LPCTSTR Radius of a circle, pie segment, or circular arc 4-20 WinCC Manual

273 08.97 Global Scripts long int GetRadiusHeight (LPCTSTR lpszpicturename, LPCTSTR The vertical radius of an ellipse, an ellipse segment, or an ellipse arc long int GetRadiusWidth (LPCTSTR lpszpicturename, LPCTSTR Horizontal radius of an ellipse, an ellipse segment, or an ellipse arc long int GetReferenceRotationLeft (LPCTSTR lpszpicturename, LPCTSTR Valid for line, polygon, and polyline X value of the rotation reference (the reference point around which the object is rotated) long int GetReferenceRotationTop (LPCTSTR lpszpicturename, LPCTSTR Valid for line, polygon, and polyline. Y value of the rotation reference (the reference point around which the object is rotated) long int GetRotationAngle (LPCTSTR lpszpicturename, LPCTSTR Valid for line, polygon, and polyline. Clockwise rotation angle (in degrees) of the object around the rotation point long int GetRoundCornerHeight (LPCTSTR lpszpicturename, LPCTSTR Vertical radius of the corner of a rounded rectangle long int GetRoundCornerWidth (LPCTSTR lpszpicturename, LPCTSTR Horizontal radius of the corner of a rounded rectangle WinCC Manual 4-21

274 Global Scripts long int GetStartAngle (LPCTSTR lpszpicturename, LPCTSTR Beginning angle for pie and ellipse segments as well as circular and ellipse arcs long int GetTop (LPCTSTR lpszpicturename, LPCTSTR Current Y axis value of the left upper corner of the rectangle surrounding an object long int GetWidth (LPCTSTR lpszpicturename, LPCTSTR Width of the rectangle surrounding an object Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. long int GetZeroPoint (LPCTSTR lpszpicturename, LPCTSTR Zero point in bar objects 4-22 WinCC Manual

275 08.97 Global Scripts graphics-get-i_o Functions char* GetAssignments(LPCTSTR lpszpicturename, LPCTSTR Assignment of text to value range depending on the type of list. BOOL GetAssumeOnExit (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields TRUE means the system accepts the input value as soon as the field is exited. FALSE means the system does not accept the input value as soon as the field is exited. BOOL GetAssumeOnFull (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields TRUE means the system exits the input field automatically (without Tab or Enter key) and accepts the input as soon as the input has been completed (the specified number of characters was entered). FALSE means the system does not exit the input field automatically and accept the input as soon as the input has been completed. long int GetBitNumber(LPCTSTR lpszpicturename, LPCTSTR Display of the relevant bit in the output value in the "Bit" list type. BOOL GetClearOnError (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields TRUE means the input field is deleted automatically when there is an invalid input. FALSE means the input field is not deleted when there is an invalid input. WinCC Manual 4-23

276 Global Scripts BOOL GetClearOnNew (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields TRUE means the input field is deleted at startup. FALSE means the input field is not deleted at startup. long int GetDataFormat (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields Number value of the data type (binary, decimal, hexadecimal, or string) of the contents of the field BOOL GetHiddenInput (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields TRUE means the input value is hidden during input. An asterisk (*) is displayed for each character. FALSE means the input value is not hidden during input. char* GetInputValueChar (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields Pointer to the input value double GetInputValueDouble (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields Input value long int GetListType(LPCTSTR lpszpicturename, LPCTSTR Displays the type of the text list. The following list types are possible: 0: Decimal 1: Binary 2: Bit 4-24 WinCC Manual

277 08.97 Global Scripts long int GetNumberLines(LPCTSTR lpszpicturename, LPCTSTR Display of how many visible lines a browser list in a "Text List" object contains. Note: If the number of configured texts is larger than the number of visible lines, the browser list receives a vertical scroll bar. char* GetOutputFormat (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields Pointer to the output format char* GetOutputValueChar (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields Pointer to the output value double GetOutputValueDouble (LPCTSTR lpszpicturename, LPCTSTR Only with I/O fields Output value WinCC Manual 4-25

278 Global Scripts graphics-get-limits Functions double GetAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR Alarm high limit in bar objects double GetAlarmLow (LPCTSTR lpszpicturename, LPCTSTR Alarm low limit in bar objects BOOL GetCheckAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the limit value for "alarm high" is monitored in bar objects. FALSE means that the limit value for "alarm high" is not monitored. BOOL GetCheckAlarmLow (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the limit value for "alarm low" is monitored in bar objects. FALSE means that the limit value for "alarm low" is not monitored in bar objects. BOOL GetCheckLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the high limit value for "reserve 4" is monitored in bar objects. FALSE means that the high limit value for "reserve 4" is not monitored in bar objects. BOOL GetCheckLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the high limit value for "reserve 5" is monitored in bar objects. FALSE means that the high limit value for "reserve 5" is not monitored in bar objects WinCC Manual

279 08.97 Global Scripts BOOL GetCheckLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the low limit value for "reserve 4" is monitored in bar objects. FALSE means that the low limit value for "reserve 4" is not monitored in bar objects. BOOL GetCheckLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the low limit value for "reserve 5" is monitored in bar objects. FALSE means that the low limit value for "reserve 5" is not monitored in bar objects. BOOL GetCheckToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the limit value for "tolerance high" is monitored in bar objects. FALSE means that the limit value for "tolerance high" is not monitored in bar objects. BOOL GetCheckToleranceLow (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the limit value for "tolerance low" is monitored in bar objects. FALSE means that the limit value for "tolerance low" is not monitored in bar objects. BOOL GetCheckWarningHigh (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the limit value for "warning high" is monitored in bar objects. FALSE means that the limit value for "warning high" is not monitored in bar objects. WinCC Manual 4-27

280 Global Scripts BOOL GetCheckWarningLow (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the limit value for "warning low" is monitored in bar objects. FALSE means that the limit value for "warning low" is not monitored in bar objects. long int GetColorAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the limit value of "alarm high" is reached long int GetColorAlarmLow (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the limit value of "alarm low" is reached long int GetColorLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the high limit value of "reserve 4" is reached long int GetColorLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the high limit value of "reserve 5" is reached long int GetColorLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the low limit value of "reserve 4" is reached 4-28 WinCC Manual

281 08.97 Global Scripts long int GetColorLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the low limit value of "reserve 5" is reached long int GetColorToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the limit value of "tolerance high" is reached long int GetColorToleranceLow (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the limit value of "tolerance low" is reached long int GetColorWarningHigh (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the limit value of "warning high" is reached long int GetColorWarningLow (LPCTSTR lpszpicturename, LPCTSTR Number value of the bar color when the limit value of "warning low" is reached double GetLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR The high limit value for "reserve 4" in bar objects double GetLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR The high limit value for "reserve 5" in bar objects WinCC Manual 4-29

282 Global Scripts double GetLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR The low limit value for "reserve 4" in bar objects double GetLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR The low limit value for "reserve 5" in bar objects double GetLimitMax (LPCTSTR lpszpicturename, LPCTSTR High limit value for I/O fields double GetLimitMin (LPCTSTR lpszpicturename, LPCTSTR Low limit value for I/O fields BOOL GetMarker (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value is displayed as a scale value in bar objects. FALSE means the limit value is not displayed in bar objects. double GetToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR Limit value for "tolerance high" in bar objects double GetToleranceLow (LPCTSTR lpszpicturename, LPCTSTR Limit value for "tolerance low" in bar objects 4-30 WinCC Manual

283 08.97 Global Scripts BOOL GetTypeAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value for "alarm high" is provided as a percentage in bar objects. FALSE means the limit value for "alarm high" is provided as an absolute in bar objects. BOOL GetTypeAlarmLow (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value for "alarm low" is provided as a percentage in bar objects. FALSE means the limit value for "alarm low" is provided as an absolute in bar objects. BOOL GetTypeLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR TRUE means the high limit value for "reserve 4" is provided as a percentage in bar objects. FALSE means the high limit value for "reserve 4" is provided as an absolute in bar objects. BOOL GetTypeLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR TRUE means the high limit value for "reserve 5" is provided as a percentage in bar objects. FALSE means the high limit value for "reserve 5" is provided as an absolute in bar objects. BOOL GetTypeLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR TRUE means the low limit value for "reserve 4" is provided as a percentage in bar objects. FALSE means the low limit value for "reserve 4" is provided as an absolute in bar objects. WinCC Manual 4-31

284 Global Scripts BOOL GetTypeLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR TRUE means the low limit value for "reserve 5" is provided as a percentage in bar objects. FALSE means the low limit value for "reserve 5" is provided as an absolute in bar objects. BOOL GetTypeToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value for "tolerance high" is provided as a percentage in bar objects. FALSE means the limit value for "tolerance high" is provided as an absolute in bar objects. BOOL GetTypeToleranceLow (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value for "tolerance low" is provided as a percentage in bar objects. FALSE means the limit value for "tolerance low" is provided as an absolute in bar objects. BOOL GetTypeWarningHigh (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value for "warning high" is provided as a percentage in bar objects. FALSE means the limit value for "warning high" is provided as an absolute in bar objects WinCC Manual

285 08.97 Global Scripts BOOL GetTypeWarningLow (LPCTSTR lpszpicturename, LPCTSTR TRUE means the limit value for "warning low" is provided as a percentage in bar objects. FALSE means the limit value for "warning low" is provided as an absolute in bar objects. double GetWarningHigh (LPCTSTR lpszpicturename, LPCTSTR Limit value for "warning high" in bar objects double GetWarningLow (LPCTSTR lpszpicturename, LPCTSTR Limit value for "warning low" in bar objects WinCC Manual 4-33

286 Global Scripts graphics-get-link Functions BOOL GetLink(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname,lpctstr lpszpropertyname, LPLINKINFO() plink); Inquiry to the current tag connection of object properties Stucture: The tag structure consists of the LinkTyp, dwcycle, and szlinkname parameters. LinkType: 0 Object property not dynamic 1 Direct tag connection 2 Indirect tag connection 3 C action 4 C action created by means of the dynamic wizard dwcycle: 0 Picture cycle 1 Window cycle 2 Upon change ms ms 5 1 s 6 2 s 7 5 s 8 10 s 9 1 min 10 5 min min 12 1 hr User cycle 1 to 5 szlinkname: If there is of a direct or indirect tag connection, the tag name is transferred. Example: { LINKINFO linkinfo; } GetLink(..., &linkinfo); printf( %d, %d, %s, linkinfo.linktype, linkinfo.dwcycle, linkinfo.szlinkname); 4-34 WinCC Manual

287 08.97 Global Scripts graphics-get-misc Functions BOOL GetAdaptBorder (LPCTSTR lpszpicturename, LPCTSTR Valid for static text, I/O field, button, check box, and option button. TRUE means the border is dynamically fitted to the text size. FALSE means the border is not dynamically fitted to the text size. BOOL GetAdaptPicture (LPCTSTR lpszpicturename, LPCTSTR Valid for picture windows. Adapts the picture to the size of the picture window. TRUE means the picture is adapted to fit the window size. FALSE means the picture is not adapted to fit the window size. BOOL GetAdaptSize (LPCTSTR lpszpicturename, LPCTSTR Only for picture windows. TRUE means the window size is adapted to fit the picture size. FALSE means the window size is not adapted to fit the picture size. BOOL GetAverage (LPCTSTR lpszpicturename, LPCTSTR Only with bar objects TRUE means the last 15 values will be averaged. FALSE means the last 15 values will not be averaged. long int GetBoxType (LPCTSTR lpszpicturename, LPCTSTR Field type of an I/O object (input field, output field, input/output field) BOOL GetCaption (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the picture window has a title. FALSE means that the picture window does not have a title. WinCC Manual 4-35

288 Global Scripts BOOL GetCloseButton (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the picture window can be closed. FALSE means that the picture window cannot be closed. BOOL GetColorChangeType (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the color change when a limit is reached is carried out in the entire bar. FALSE means that the color change when a limit is reached is carried out in an individual bar segment. BOOL GetCursorControl (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the cursor control is turned on in I/O fields (an alpha cursor jumps to the next field in the tab sequence after exiting the current field). FALSE means that the cursor control is turned off in I/O fields. BOOL GetCursorMode (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the cursor mode for the picture is an alpha cursor sequence. FALSE means that the cursor mode for the picture is a tab order sequence. BOOL GetEditAtOnce (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the immediate input attribute is set to "yes" for I/O fields (you can make an input immediately upon accessing the I/O field with the Tab key, without having to carry out any further action). FALSE means that the immediate input attribute is set to "no" for I/O fields WinCC Manual

289 08.97 Global Scripts BOOL GetExtendedOperation (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the extended operation attribute is set to "yes" for sliders (the slider is set to a new appropriate minimum/maximum limit value by clicking on the area outside of the current slider setting) FALSE means that the extended operation attribute is set to "no" for sliders. long int GetHotkey (LPCTSTR lpszpicturename, LPCTSTR Hot key or key combination for a button. BOOL GetHysteresis (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the display occurs with hysteresis for bar objects. FALSE means that the display occurs without hysteresis for bar objects. double GetHysteresisRange (LPCTSTR lpszpicturename, LPCTSTR Hysteresis in the bar object display (hysteresis as a percent of the display value) char* GetLanguageSwitch(LPCTSTR lpszpicturename, LPCTSTR Shows if the text list object was configured in one or more languages. TRUE multiple language text list FALSE single language text list char* GetLastChange (LPCTSTR lpszpicturename, LPCTSTR Date the picture was last changed. WinCC Manual 4-37

290 Global Scripts double GetMax (LPCTSTR lpszpicturename, LPCTSTR The absolute value for a full value view with bar and slider objects BOOL GetMaximizeButton (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the picture or application window can be maximized. FALSE means that the picture or application window cannot be maximized. double GetMin (LPCTSTR lpszpicturename, LPCTSTR Absolute value for the smallest value view for bar and slider objects BOOL GetMoveable (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the picture or application window can be moved. FALSE means that the picture or application window cannot be moved. long int GetOffsetLeft (LPCTSTR lpszpicturename, LPCTSTR Horizontal distance of the picture from the left edge of the window in picture windows long int GetOffsetTop (LPCTSTR lpszpicturename, LPCTSTR Vertical distance of the picture from the top edge of the window in picture windows BOOL GetOnTop (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the picture or application window is always in the foreground. FALSE means that the picture or application window is not always in the foreground WinCC Manual

291 08.97 Global Scripts BOOL GetOperation (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the object can be controlled. FALSE means that the object cannot be controlled. Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL GetOperationMessage (LPCTSTR lpszpicturename, LPCTSTR Valid for the I/O field, check box, option button, and slider objects TRUE means that a message is output when an operation is successfully carried out. FALSE means that no message is output when an operation is successfully carried out. BOOL GetOperationReport (LPCTSTR lpszpicturename, LPCTSTR Valid for all objects except application windows, picture windows, and OLE control TRUE means that the reason for operator activity is reported. FALSE means that the reason for operator activity is not reported. Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. long int GetPasswordLevel (LPCTSTR lpszpicturename, LPCTSTR Valid for all objects except application windows, picture windows, and OLE control Authorization level for controlling the object Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. WinCC Manual 4-39

292 Global Scripts char* GetPictureName (LPCTSTR lpszpicturename, LPCTSTR Valid for picture objects Pointer to the name of a picture contained in a picture object double GetProcess (LPCTSTR lpszpicturename, LPCTSTR Valid for slider, bar, check box, and option group objects For sliders and bars: Value of the presetting for the process value to be displayed. For check boxes and option groups: The selected box(es) BOOL GetScrollBars(LPCTSTR lpszpicturename, LPCTSTR TRUE means that the picture window has a scroll bar. FALSE means that the picture window does not have a scroll bar. char* GetServerName(LPCTSTR lpszpicturename, LPCTSTR Displays the name of the object (OLE Control and OLE object), under which it is registered in Windows. BOOL GetSizeable (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the application or picture window size can be changed. FALSE means that the application or picture window size cannot be changed. long int GetSmallChange (LPCTSTR lpszpicturename, LPCTSTR Number of steps the slider can be moved with a mouse click 4-40 WinCC Manual

293 08.97 Global Scripts BOOL GetTrend (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the trend is displayed in a bar object. FALSE means that the trend is not displayed in a bar object. long int GetUpdateCycle (LPCTSTR lpszpicturename, LPCTSTR Number value of the update cycle for the entire picture BOOL GetVisible (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the object is displayed. FALSE means that the object is not displayed. Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL GetWindowBorder (LPCTSTR lpszpicturename, LPCTSTR TRUE means that the application or picture window is displayed with a border. FALSE means that the application or picture window is displayed without a border. double GetZeroPointValue (LPCTSTR lpszpicturename, LPCTSTR Absolute value for the zero point in a bar display long int GetZoom (LPCTSTR lpszpicturename, LPCTSTR Zoom factor for a picture window WinCC Manual 4-41

294 Global Scripts graphics-get-ole_control Functions long int GetPosition(LPCTSTR lpszpicturename, LPCTSTR Slider position of the OCX slider as a number value long int GetRangeMax(LPCTSTR lpszpicturename, LPCTSTR Maximum setting range of the OCX slider as a number value. long int GetRangeMin(LPCTSTR lpszpicturename, LPCTSTR Minimum setting range of the OCX slider as a number value WinCC Manual

295 08.97 Global Scripts graphics-get-pictures Functions char* GetPictureDeactivated(LPCTSTR lpszpicturename, LPCTSTR Picture name for "deactivated" status Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be linked. char* GetPictureDown(LPCTSTR lpszpicturename, LPCTSTR Picture for the "on/pressed" status. Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be linked char* GetPictureUp(LPCTSTR lpszpicturename, LPCTSTR Picture name for the "off/not pressed" status Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be linked. BOOL GetPicDeactReferenced(LPCTSTR lpszpicturename, LPCTSTR TRUE means a reference to the bit map file for the "deactivated" status. FALSE means copy the contents of the bit map file to the graphic (for the "deactivated" status). long int GetPicDeactTransparent(LPCTSTR lpszpicturename, LPCTSTR Transparent color for the "deactivated" status Note: This function only applies to bitmap graphics. BOOL GetPicDeactUseTransColor(LPCTSTR lpszpicturename, LPCTSTR TRUE means use the transparent color for the "deactivated" status. FALSE means do not use the transparent color for the "deactivated" status. WinCC Manual 4-43

296 Global Scripts BOOL GetPicDownReferenced(LPCTSTR lpszpicturename, LPCTSTR TRUE means a reference to the bitmap file for the "on/pressed" status. FALSE meas copy the bitmap file to the graphic (for the status "on/pressed") long int GetPicDownTransparent(LPCTSTR lpszpicturename, LPCTSTR Transparent color for the "on/pressed" status Note: This function only applies to bitmap graphics. BOOL GetPicDownUseTransColor(LPCTSTR lpszpicturename, LPCTSTR TRUE means use the transparent color for the "on/pressed" status. FALSE means do not use the transparent color for the "on/pressed" status. BOOL GetPicReferenced(LPCTSTR lpszpicturename, LPCTSTR TRUE means a reference to the bitmap file. FALSE means copy the contents of the bitmap file to the graphic object. long int GetPicTransColor(LPCTSTR lpszpicturename, LPCTSTR Transparent color for the background picture of a graphic object Note: This function only applies to bitmap graphics. BOOL GetPicUpReferenced(LPCTSTR lpszpicturename, LPCTSTR TRUE means a reference to the bitmap file for the "off/not pressed" status. FALSE means copy the contents of the bitmap file to the graphic (for the "off/not pressed" status) WinCC Manual

297 08.97 Global Scripts long int GetPicUpTransparent(LPCTSTR lpszpicturename, LPCTSTR Transparent color for the "off/not pressed" status. Note: This function only applies to bitmap graphics. BOOL GetPicUpUseTransColor(LPCTSTR lpszpicturename, LPCTSTR TRUE means use the transparent color for the "off/not pressed" status. FALSE means do not use the transparent color for the "off/not pressed" status. BOOL GetPicUseTransColor(LPCTSTR lpszpicturename, LPCTSTR TRUE means use the transparent color for the background picture of a graphic object. FALSE means do not use the transparent color for the background picture of a graphic object. WinCC Manual 4-45

298 Global Scripts graphics-get-property-funktionen BOOL GetPropBOOL(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname) Attribute value of the type BOOL. Parameter: lpszpropertyname = OLE-Automation-Name of the attribute char* GetPropChar(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname) Pointer on the attribute value of the type char. Parameter: lpszpropertyname = OLE-Automation-Name of the attribute double GetPropDouble(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname) Attribute value of the type double. Parameter: lpszpropertyname = OLE-Automation-Name of the attribute long GetPropWord(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname) Attribute value of the type long. Parameter: lpszpropertyname = OLE-Automation-Name of the attribute 4-46 WinCC Manual

299 08.97 Global Scripts graphics-get-state Functions long int GetBasePicTransColor(LPCTSTR lpszpicturename, LPCTSTR Transparent color of the base picture Note: This function only applies to bitmap graphics. BOOL GetBasePicUseTransColor(LPCTSTR lpszpicturename, LPCTSTR TRUE means use the transparent color for the base picture. FALSE means do not use the transparent color for the base picture. char* GetBasePicture(LPCTSTR lpszpicturename, LPCTSTR Base picture name for the status display BOOL GetBasePicReferenced(LPCTSTR lpszpicturename, LPCTSTR TRUE means reference to the bitmap file. FALSE means copy the contents of the bitmap file to the status display. BOOL GetFlashFlashPicture(LPCTSTR lpszpicturename, LPCTSTR TRUE means the flash picture is dynamically animated. FALSE means the flash picture is statically animated. char* GetFlashPicture(LPCTSTR lpszpicturename, LPCTSTR Flash picture name (file name of the graphic) WinCC Manual 4-47

300 Global Scripts long int GetFlashPicTransColor(LPCTSTR lpszpicturename, LPCTSTR Transparent color of the flash picture Note: This function only applies to bitmap graphics. BOOL GetFlashPicUseTransColor(LPCTSTR lpszpicturename, LPCTSTR TRUE means use the transparent color for the flash picture. FALSE means do not use the transparent color for the flash picture. BOOL GetFlashPicReferenced(LPCTSTR lpszpicturename, LPCTSTR TRUE means reference to the bitmap file. FALSE means copy the contents of the bitmap file to the status display. long int GetFlashRateFlashPic (LPCTSTR lpszpicturename, LPCTSTR Number value for the flash frequency of a flash picture 0: No flash frequency 1: Flash frequency slow (approximately 0.5 Hz) 2: Flash frequence medium (approximately 2 Hz) 3: Flash frequency fast (approximately 8 Hz) Note: Since flashing is a software implementation, the frequency depends on the system and the hardware (number of objects, processor, memory, update time, etc.). long int GetIndex(LPCTSTR lpszpicturename, LPCTSTR Current index of a polygon or polyline WinCC Manual

301 08.97 Global Scripts graphics-get-style Functions long int GetBackBorderWidth(LPCTSTR lpszpicturename, LPCTSTR Number value for the weight of the border of 3D border and slider objects long int GetBorderEndStyle (LPCTSTR lpszpicturename, LPCTSTR Number value of the type of line end style long int GetBorderStyle (LPCTSTR lpszpicturename, LPCTSTR Number value of the line style or border style long int GetBorderWidth (LPCTSTR lpszpicturename, LPCTSTR Line weight or weight of the border line as number value long int GetBoxAlignment (LPCTSTR lpszpicturename, LPCTSTR Number value of the assignment of the control elements in check boxes or option buttons, align left or right long int GetFillStyle (LPCTSTR lpszpicturename, LPCTSTR Number value of the type of fill pattern Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. WinCC Manual 4-49

302 Global Scripts long int GetFillStyle2 (LPCTSTR lpszpicturename, LPCTSTR Number value of the fill pattern of the bar in a bar display long int GetItemBorderStyle(LPCTSTR lpszpicturename, LPCTSTR Style for the separate line for the "text list" object long int GetItemBorderWidth(LPCTSTR lpszpicturename, LPCTSTR Weight for the separate line for the "text list" object BOOL GetPressed(LPCTSTR lpszpicturename, LPCTSTR Only for round buttons TRUE means a switch setting of on/pressed. FALSE means a switch setting of off/not pressed. BOOL GetToggle(LPCTSTR lpszpicturename, LPCTSTR Only for round buttons TRUE means the switch setting is not latched. FALSE means the switch setting is latched. BOOL GetWindowsStyle (LPCTSTR lpszpicturename, LPCTSTR You can only use this function on buttons. TRUE corresponds to the "Windows style," meaning the button is displayed according to Windows conventions. FALSE corresponds to the "not Windows style," meaning you can determine the way the button looks yourself WinCC Manual

303 08.97 Global Scripts graphics-set-axes Functions BOOL SetAlignment (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL balignment); Only with bar objects Set the location of the text (right/left) relative to the bar. balignment = Text located right or left of the bar. TRUE: The text is to the right of the bar. FALSE: The text is to the left of the bar. BOOL SetAxisSection (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double daxissection); Only with bar objects Set the units of measurement on the axis (the value difference between two neighboring axis labels). daxissection = Axis section BOOL SetExponent (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bexponent); Only with bar objects Determine whether the number display should be with exponents or decimals. bexponent = Axis numbering with exponents/decimals TRUE means the number display on the axis is with exponents. FALSE means the number display on the axis is with decimals. WinCC Manual 4-51

304 Global Scripts BOOL SetLeftComma (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lleftcomma); Only with bar objects Set the number of digits to the left of the decimal point. lleftcomma = Number of digits to the left of the decimal point BOOL SetLongStrokesBold (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL blongstrokesbold); Only with bar objects Set whether the long axis sections in the scale representation should be displayed as bold or normal. blongstrokesbold = Long axis sections bold/normal TRUE means the long axis sections in the scale representation of the bar are bold. FALSE means the long axis sections in the scale representation of the bar are normal. BOOL SetLongStrokesOnly (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL blongstrokesonly); Only with bar objects Determine whether only long axis sections or the sub-sections are also used on the bar scale. blongstrokesonly = Exclusively long axis sections yes/no. TRUE means only long axis sections are used on the bar scale. FALSE means long axis sections and sub-sections are used on the bar scale WinCC Manual

305 08.97 Global Scripts BOOL SetLongStrokesSize(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int llongstrokessize); Only with bar objects Set the length of the long axis sections on the bar scale. llongstrokessize = Length of the long axis sections BOOL SetRightComma (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lrightcomma); Only with bar objects Set the number of digits to the right of the decimal point (0 to 20) in the axis labeling. lrightcomma = Number of digits to the right of the decimal point BOOL SetScaleTicks (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lscaleticks); Only with bar objects Set the scale marks within the bar as a percentage of the entire bar height. lscaleticks = Scale marks as a percentage of the entire bar height BOOL SetScaling (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bscaling); Only with bar objects Turn the scale on and off. bscaling = Scale on/off TRUE means "with scale" FALSE means "without scale" WinCC Manual 4-53

306 Global Scripts BOOL SetScalingType(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lscalingtype); Only with bar objects Set the type of bar scaling. lscalingtype = Type of bar scaling 0: Linear (same weight) 1: Logarithmic (low values emphasized) 2: Negative logarithmic (high values emphasized) 3: Automatic (linear) 4: Tangent (high and low values emphasized) 5: Squared (high values emphasized) 6: Cubic (high values heavily emphasized) 4-54 WinCC Manual

307 08.97 Global Scripts graphics-set-color Functions BOOL SetBackColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackcolor); Set the background color of the object. lbackcolor = Number value of the background color of the object Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetBackColor2 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackcolor2); Set the bar color for bar objects. lbackcolor2 = Number value of the bar color for bar objects BOOL SetBackColor3 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackcolor3); Set the color of the bar background for bar objects. lbackcolor3 = Number value of the bar background color for bar objects BOOL SetBackColorBottom(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackcolorbottom); Set the bottom/right background color for slider objects. lbackcolorbottom = Number value of the bar background color WinCC Manual 4-55

308 Global Scripts BOOL SetBackColorTop(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackcolortop); Set the top/left background color for slider objects. lbackcolortop = Number value of the bar background color BOOL SetBorderBackColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lborderbackcolor); Set the line or border background color. lborderbackcolor = Number value of the line or border background color BOOL SetBorderColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbordercolor); Set the line or border color. lbordercolor = Number value of the line or border color BOOL SetBorderColorBottom (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbordercolorbottom); Set the color for the right and bottom part (shadow) of the 3D border. lbordercolorbottom = Number value of the 3D shadow color 4-56 WinCC Manual

309 08.97 Global Scripts BOOL SetBorderColorTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbordercolortop); Set the color for the left and top part of the 3D border. lbordercolortop = Number value of the left and top 3D border color BOOL SetButtonColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbuttoncolor); Set the button color for slider objects. lbuttoncolor = Number value of the button color in slider objects BOOL SetColorBottom (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorbottom); Set the color for the bottom/right part of a slider. lcolorbottom = Number value of the color of the bottom/right part of a slider BOOL SetColorTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolortop); Set the color for the top/left slider position. lcolortop = Number value of the color for the top/left slider position WinCC Manual 4-57

310 Global Scripts BOOL SetFillColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lfillcolor); Set the fill pattern color. lfillcolor = Number value of the fill pattern color Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetForeColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lforecolor); Set the color of the text in the object. lforecolor = Number value of the text color BOOL SetItemBorderBackColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int litemborderbackcolor); Set the separate line background color for the "text list" object. litemborderbackcolor = Number value of the background color BOOL SetItemBorderColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int litembordercolor); Set the separate line color for the "text list" object. litembordercolor = Number value of the separate line color 4-58 WinCC Manual

311 08.97 Global Scripts BOOL SetScaleColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lscalecolor); Set the scale color for bar objects. lscalecolor = Number value of the scale color in bar objects BOOL SetSelBGColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lselbgcolor); Set the background color for the selected entry in the browser list for the "text list" object. lselbgcolor = Background color for the selected entry BOOL SetSelTextColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lseltextcolor); Set the text color for the selected entry in the browser list for the "text list" object. lseltextcolor = Text color for the selected entry BOOL SetTrendColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int ltrendcolor); Set the trend color in bar objects. ltrendcolor = Number value of the trend color in bar objects WinCC Manual 4-59

312 Global Scripts BOOL SetUnselBGColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lunselbgcolor); Set the background color for unselected entries in the browser list for the "text list" object. lunselbgcolor = Background color for unselected entries in the browser list BOOL SetUnselTextColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lunseltextcolor); Set the text color for unselected entries in the browser list for the "text list" object. lunseltextcolor = Number value for the text color 4-60 WinCC Manual

313 08.97 Global Scripts graphics-set-fill Functions BOOL SetFilling (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bfilling); Activate/deactivate dynamic filling with the background color. bfilling = Dynamic filling with the background color active/inactive TRUE means dynamic filling with the background color is active. FALSE means dynamic filling with the background color is inactive. BOOL SetFillingIndex (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lfillingindex); Set the filling index. lfillingindex = Number value of the filling index WinCC Manual 4-61

314 Global Scripts graphics-set-flash Functions BOOL SetBackFlashColorOff (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackflashcoloroff); Set the background color when the flashing attribute is switched off. lbackflashcoloroff = Number value of the background color when flashing attribute is switched off BOOL SetBackFlashColorOn (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackflashcoloron); Set the background color when the flashing attribute is switched on. lbackflashcoloron = Number value of the background color when the flashing attribute is switched on BOOL SetBorderFlashColorOff (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lborderflashcoloroff); Set the border or line color when the flashing attribute is switched off. lborderflashcoloroff = Number value of the border or line color when the flashing attribute is switched off BOOL SetBorderFlashColorOn (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lborderflashcoloron); Set the border or line color when the flashing attribute is switched on. lborderflashcoloron = Number value of the border or line color when the flashing attribute is switched on 4-62 WinCC Manual

315 08.97 Global Scripts BOOL SetFlashBackColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bflashbackcolor); Activate or deactivate background flashing. bflashbackcolor = Background flashing active/inactive TRUE means background flashing is active. FALSE means background flashing is inactive. BOOL SetFlashBorderColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bflashbordercolor); Activate the flashing border or line. bflashbordercolor = Flashing border or line active/inactive TRUE means border or line flashing is active. FALSE means border or line flashing is inactive. BOOL SetFlashForeColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bflashforecolor); Activate the text flashing. bflashforecolor = Text flashing active/not active TRUE means text flashing is active. FALSE means text flashing is inactive. BOOL SetFlashRateBackColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lflashratebackcolor); Set the background flash frequency. lflashratebackcolor = Background flash frequency WinCC Manual 4-63

316 Global Scripts BOOL SetFlashRateBorderColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lflashratebordercolor); Set the line or border flash frequency. lflashratebordercolor = Line or border flash frequency BOOL SetFlashRateForeColor (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lflashrateforecolor); Set the text flash frequency. lflashrateforecolor = Text flash frequency BOOL SetForeFlashColorOff (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lforeflashcoloroff); Set the text color when the flashing attribute is switched off. lforeflashcoloroff = Number value of the text color when the flashing attribute is switched off BOOL SetForeFlashColorOn (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lforeflashcoloron); Set the text color when the flashing attribute is switched on. lforeflashcoloron = Number value of the text color when the flashing attribute is switched on 4-64 WinCC Manual

317 08.97 Global Scripts graphics-set-focus-functions BOOL Set_Focus(LPCTSTR lpszpicturename, LPCTSTR Places the focus on the specified object graphics-set-font Functions BOOL SetAlignmentLeft (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lalignmentleft); Set the horizontal alignment (aligned left, centered, aligned right) of the text. lalignmentleft = Number value of the horizontal alignment (aligned left, centered, aligned right) of the text BOOL SetAlignmentTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lalignmenttop); Set the vertical alignment of the text (top, center, bottom). lalignmenttop = Number value of the vertical alignment of the text (top, center, bottom) BOOL SetFontBold (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bfontbold); Turns the "Bold" text attribute on and off. bfontbold = "Bold" on/off TRUE means "Bold" is on. FALSE means "Bold" is off. WinCC Manual 4-65

318 Global Scripts BOOL SetFontItalic (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bfontitalic); Turn the "Italic" text attribute on and off. bfontitalic = "Italic" on/off TRUE means "Italic" is on. FALSE means "Italic" is off. BOOL SetFontName (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* szfontname); Set a font. szfontname = Pointer to the name of the font BOOL SetFontSize (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lfontsize); Set the font size. lfontsize = Font size BOOL SetFontUnderline (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bfontunderline); Turns the "Underline" text attribute on and off. bfontunderline = Text style "Underline" on/off TRUE means "Underline" is on. FALSE means "Underline" is off WinCC Manual

319 08.97 Global Scripts BOOL SetOrientation (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL borientation); Set the direction of the text (horizontal/vertical). borientation = Horizontal/vertical text direction TRUE means horizontal text direction. FALSE means vertical text direction. BOOL SetText (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* sztext); Set a pointer to a static text. For radio- and check-boxes, as well as for polygons and polylines, the element or point has to be set with the SetIndex function before calling the SetText function. sztext = Pointer to static text WinCC Manual 4-67

320 Global Scripts graphics-set-geometry Functions BOOL SetActualPointLeft (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lactualpointleft); Set the current horizontal position of the corner point for a polygon or polyline in relation to the origin of the picture. Set the current point of the polygon with the SetIndex function. lactualpointleft = X value (horizontal position) of the corner point for a polygon or polyline BOOL SetActualPointTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lactualpointtop); Set the current vertical position of the corner point for a polygon or a polyline in relation to the origin of the picture. Set the current point of the polygon with the SetIndex function. lactualpointtop = Y value (vertical position) of the corner point for a polygon or polyline BOOL SetBoxCount (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lboxcount); Set the number of check boxes in a check box area or option buttons in an option group. lboxcount = Number of check boxes in a check box area or option buttons in an option group. BOOL SetDirection (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int ldirection); Set the bar direction (up, down, left, or right) in bar objects. ldirection = Number value of the bar direction (up, down, left, or right) in bar objects 4-68 WinCC Manual

321 08.97 Global Scripts BOOL SetEndAngle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lendangle); Set end angle of pie and ellipse segments as well as circular and ellipse arcs. lendangle = End angle of pie and ellipse segments as well as circular and ellipse arcs BOOL SetHeight (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lheight); Set the height of the rectangle surrounding an object. lheight = Height of the rectangle surrounding an object Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetLeft (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lleft); Set the location on the X axis of the left upper corner of the rectangle surrounding an object. lleft = X value (location on the X axis) of the left upper corner of the rectangle surrounding an object BOOL SetPointCount (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lpointcount); Set the number of corners for a polygon or polyline. lpointcount = Number of corners WinCC Manual 4-69

322 Global Scripts BOOL SetRadius (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lradius); Set the radius of a circle, pie segment, or circular arc. lradius = Radius BOOL SetRadiusHeight (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lradiusheight); Set the vertical radius of an ellipse, an ellipse segment, or an ellipse arc. lradiusheight = Vertical radius BOOL SetRadiusWidth (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lradiuswidth); Set the horizontal radius of an ellipse, an ellipse segment, or an ellipse arc. lradiuswidth = Horizontal radius BOOL SetReferenceRotationLeft (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lreferencerotationleft); Valid for line, polygon and polyline. Set the X value of the rotation reference (the reference point around which the object is rotated). lreferencerotationleft = X value of the rotation reference 4-70 WinCC Manual

323 08.97 Global Scripts BOOL SetReferenceRotationTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lreferencerotationtop); Valid for line, polygon, and polyline Set the Y value of the rotation reference (the reference point around which the object is rotated). lreferencerotationtop = Y value of the rotation reference BOOL SetRotationAngle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lrotationangle); Valid for line, polygon, and polyline Set the clockwise rotation angle (in degrees) of the object around the rotation point. lrotationangle = Rotation angle BOOL SetRoundCornerHeight (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lroundcornerheight); Set the vertical radius of the corner of a rounded rectangle. lroundcornerheight = Vertical radius BOOL SetRoundCornerWidth (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lroundcornerwidth); Set the horizontal radius of the corner of a rounded rectangle. lroundcornerwidth = Horizontal radius WinCC Manual 4-71

324 Global Scripts BOOL SetStartAngle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lstartangle); Set the beginning angle for pie and ellipse segments as well as circular and ellipse arcs. lstartangle = Beginning angle BOOL SetTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int ltop); Set the Y axis value of the left upper corner of the rectangle surrounding an object. ltop = Y axis value of the left upper corner of the rectangle surrounding an object BOOL SetWidth (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lwidth); Set the width of the rectangle surrounding an object. lwidth = Width of the rectangle surrounding an object Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetZeroPoint (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lzeropoint); Set the zero point in bar objects. lzeropoint = Zero point in bar objects 4-72 WinCC Manual

325 08.97 Global Scripts graphics-set-i_o Functions BOOL SetAssumeOnExit (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bassumeonexit); Only with I/O fields Set the system to accept the input as soon as the field is exited (using the Tab or Enter key). bassumeonexit = Accept the input as soon as the field is exited: yes/no. TRUE means the system accepts the input as soon as the field is exited. FALSE means the system does not accept the input as soon as the field is exited. BOOL SetAssumeOnFull (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bassumeonfull); Only with I/O fields Set the system to exit the input field automatically (without Tab or Enter key) and accept the input as soon as the input has been completed (the specified number of characters was entered). bassumeonfull = Value accepted as soon as the input has been completed: yes/no TRUE means the system automatically accepts the input as soon as the input has been completed. FALSE means the system does not automatically accept the input as soon as the input has been completed. BOOL SetBitNumber(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbitnumber); Set the relevant bit in the output value for the "bit" list type. lbitnumber = Relevant bit in the output value WinCC Manual 4-73

326 Global Scripts BOOL SetClearOnError (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bclearonerror); Only with I/O fields Set the field entry in the input field to be deleted automatically when there is an invalid input. bclearonerror = Automatically delete the field entry in the input field when there is an invalid input: yes/no TRUE means the field entry is deleted automatically when there is an invalid input. FALSE means the field entry is not deleted automatically when there is an invalid input. BOOL SetClearOnNew (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bclearonnew); Only with I/O fields Set the field entry in the input field to be deleted when there is a new entry. bclearonnew = Delete the field entry in the input field when there is a new entry: yes/no TRUE means the system deletes the field entry when there is a new entry. FALSE means the system does not delete the field entry when there is a new entry. BOOL SetHiddenInput (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bhiddeninput); Only with I/O fields Hide the input value during input. An asterisk (*) is displayed for each character. bhiddeninput = Hidden input: yes/no. TRUE means the input is hidden. FALSE means the input is not hidden WinCC Manual

327 08.97 Global Scripts BOOL SetNumberLines(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lnumberlines); Set the number of visible rows in a browser list for the "text list" object. Note: If the number of configured text is larger than the number of visible rows, the browser list receives a vertical scroll bar. lnumberlines = Number of visible rows BOOL SetOutputValueChar (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* szoutputvaluechar); Only with I/O fields Set a pointer to the output value. szoutputvaluechar = Pointer to the output value BOOL SetOutputValueDouble (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double doutputvaluedouble); Only with I/O fields Set the output value. doutputvaluedouble = Output value WinCC Manual 4-75

328 Global Scripts graphics-set-limits Functions BOOL SetAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dalarmhigh); Set the alarm high limit in bar objects. dalarmhigh = Alarm high limit BOOL SetAlarmLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dalarmlow); Set the alarm low limit in bar objects. dalarmlow = Alarm low limit BOOL SetCheckAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcheckalarmhigh); Set the monitoring function for the limit value for "alarm high." bcheckalarmhigh = Monitor: yes/no TRUE means the limit value for "alarm high" is monitored. FALSE means the limit value for "alarm high" is not monitored. BOOL SetCheckAlarmLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcheckalarmlow); Set the monitoring function for the limit value for "alarm low." bcheckalarmlow = Monitor: yes/no TRUE means the limit value for "alarm low" is monitored. FALSE means the limit value for "alarm low" is not monitored WinCC Manual

329 08.97 Global Scripts BOOL SetCheckLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bchecklimithigh4); Set the monitoring function for the high limit value for "reserve 4" in bar objects. bchecklimithigh4 = Monitor: yes/no TRUE means the high limit value for "reserve 4" is monitored. FALSE means the high limit value for "reserve 4" is not monitored. BOOL SetCheckLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bchecklimithigh5); Set the monitoring function for the high limit value for "reserve 5" in bar objects. bchecklimithigh5 = Monitor: yes/no TRUE means the high limit value for "reserve 5" is monitored. FALSE means the high limit value for "reserve 5" is not monitored. BOOL SetCheckLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bchecklimitlow4); Set the monitoring function for the low limit value for "reserve 4" in bar objects. bchecklimitlow4 = Monitor: yes/no TRUE means the low limit value for "reserve 4" is monitored. FALSE means the low limit value for "reserve 4" is not monitored. WinCC Manual 4-77

330 Global Scripts BOOL SetCheckLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bchecklimitlow5); Set the monitoring function for the low limit value for "reserve 5" in bar objects. bchecklimitlow5 = Monitor: yes/no TRUE means the low limit value for "reserve 5" is monitored. FALSE means the low limit value for "reserve 5" is not monitored. BOOL SetCheckToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bchecktolerancehigh); Set the monitoring function for the limit value for "tolerance high" in bar objects. bchecktolerancehigh = Monitor: yes/no TRUE means that the limit value for "tolerance high" is monitored. FALSE means that the limit value for "tolerance high" is not monitored. BOOL SetCheckToleranceLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bchecktolerancelow); Set the monitoring function for the limit value for "tolerance low" in bar objects. bchecktolerancelow = Monitor: yes/no TRUE means that the limit value for "tolerance low" is monitored. FALSE means that the limit value for "tolerance low" is not monitored WinCC Manual

331 08.97 Global Scripts BOOL SetCheckWarningHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcheckwarninghigh); Set the monitoring function for the limit value for "warning high" in bar objects. bcheckwarninghigh = Monitor: yes/no TRUE means that the limit value for "warning high" is monitored. FALSE means that the limit value for "warning high" is not monitored. BOOL SetCheckWarningLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcheckwarninglow); Set the monitoring function for the limit value for "warning low" in bar objects. bcheckwarninglow = Monitor: yes/no TRUE means that the limit value for "warning low" is monitored. FALSE means that the limit value for "warning low" is not monitored. BOOL SetColorAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcoloralarmhigh); Set the bar color when the limit value of "alarm high" is reached. lcoloralarmhigh = Number value of the bar color BOOL SetColorAlarmLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcoloralarmlow); Set the bar color when the limit value of "alarm low" is reached. lcoloralarmlow = Number value of the bar color WinCC Manual 4-79

332 Global Scripts BOOL SetColorLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorlimithigh4); Set the bar color when the high limit value of "reserve 4" is reached in bar objects. lcolorlimithigh4 = Number value of the bar color BOOL SetColorLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorlimithigh5); Set the bar color when the high limit value of "reserve 5" is reached in bar objects. lcolorlimithigh5 = Number value of the bar color BOOL SetColorLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorlimitlow4); Set the bar color when the low limit value of "reserve 4" is reached in bar objects. lcolorlimitlow4 = Number value of the bar color BOOL SetColorLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorlimitlow5); Set the bar color when the low limit value of "reserve 5" is reached in bar objects. lcolorlimitlow5 = Number value of the bar color 4-80 WinCC Manual

333 08.97 Global Scripts BOOL SetColorToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolortolerancehigh); Set the bar color when the limit value of "tolerance high" is reached in bar objects. lcolortolerancehigh = Number value of the bar color BOOL SetColorToleranceLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolortolerancelow); Set the bar color when the limit value of "tolerance low" is reached in bar objects. lcolortolerancelow = Number value of the bar color BOOL SetColorWarningHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorwarninghigh); Set the bar color when the limit value of "warning high" is reached in bar objects. lcolorwarninghigh = Number value of the bar color BOOL SetColorWarningLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lcolorwarninglow); Set the bar color when the limit value of "warning low" is reached in bar objects. lcolorwarninglow = Number value of the bar color WinCC Manual 4-81

334 Global Scripts BOOL SetLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dlimithigh4); Set the high limit value for "reserve 4" in bar objects. dlimithigh4 = High limit value for "reserve 4" BOOL SetLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dlimithigh5); Set the high limit value for "reserve 5" in bar objects. dlimithigh5 = High limit value for "reserve 5" BOOL SetLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dlimitlow4); Set the low limit value for "reserve 4" in bar objects. dlimitlow4 = Low limit value for "reserve 4" BOOL SetLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dlimitlow5); Set the low limit value for "reserve 5" in bar objects. dlimitlow5 = Low limit value for "reserve 5" BOOL SetLimitMax (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dlimitmax); Set the high limit value for I/O fields. dlimitmax = High limit value 4-82 WinCC Manual

335 08.97 Global Scripts BOOL SetLimitMin (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dlimitmin); Set the low limit value for I/O fields. dlimitmin = Low limit value BOOL SetMarker (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bmarker); Set the display of the limit value in bar objects. bmarker = Limit value display: on/off TRUE means the limit value is displayed as a scale value in bar objects. FALSE means the limit value is not displayed in bar objects. BOOL SetToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dtolerancehigh); Set the limit value for "tolerance high" in bar objects. dtolerancehigh = Limit value for "tolerance high" BOOL SetToleranceLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dtolerancelow); Set the limit value for "tolerance low" in bar objects. dtolerancelow = Limit value for "tolerance low" WinCC Manual 4-83

336 Global Scripts BOOL SetTypeAlarmHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypealarmhigh); Set the manner in which the limit value for "alarm high" is provided in bar objects. btypealarmhigh = Limit value for "alarm high" as percentage or absolute TRUE means the limit value for "alarm high" is provided as a percentage. FALSE means the limit value for "alarm high" is provided as an absolute. BOOL SetTypeAlarmLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypealarmlow); Set the manner in which the limit value for "alarm low" is provided in bar objects. btypealarmlow = Limit value for "alarm low" as percentage or absolute TRUE means the limit value for "alarm low" is provided as a percentage. FALSE means the limit value for "alarm low" is provided as an absolute. BOOL SetTypeLimitHigh4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypelimithigh4); Set the manner in which the high limit value for "reserve 4" is provided in bar objects. btypelimithigh4 = High limit value for "reserve 4" as percentage or absolute TRUE means the high limit value for "reserve 4" is provided as a percentage. FALSE means the high limit value for "reserve 4" is provided as an absolute WinCC Manual

337 08.97 Global Scripts BOOL SetTypeLimitHigh5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypelimithigh5); Set the manner in which the high limit value for "reserve 5" is provided in bar objects. btypelimithigh5 = High limit value for "reserve 5" as percentage or absolute TRUE means the high limit value for "reserve 5" is provided as a percentage. FALSE means the high limit value for "reserve 5" is provided as an absolute. BOOL SetTypeLimitLow4 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypelimitlow4); Set the manner in which the low limit value for "reserve 4" is provided in bar objects. btypelimitlow4 = Low limit value for "reserve 4" as percentage or absolute TRUE means the low limit value for "reserve 4" is provided as a percentage. FALSE means the low limit value for "reserve 4" is provided as an absolute. BOOL SetTypeLimitLow5 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypelimitlow5); Set the manner in which the low limit value for "reserve 5" is provided in bar objects. btypelimitlow5 = Low limit value for "reserve 5" as percentage or absolute TRUE means the low limit value for "reserve 5" is provided as a percentage. FALSE means the low limit value for "reserve 5" is provided as an absolute. WinCC Manual 4-85

338 Global Scripts BOOL SetTypeToleranceHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypetolerancehigh); Set the manner in which the limit value for "tolerance high" is provided in bar objects. btypetolerancehigh = Limit value for "tolerance high" as percentage or absolute TRUE means the limit value for "tolerance high" is provided as a percentage. FALSE means the limit value for "tolerance high" is provided as an absolute. BOOL SetTypeToleranceLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypetolerancelow); Set the manner in which the limit value for "tolerance low" is provided in bar objects. btypetolerancelow = Limit value for "tolerance low" as percentage or absolute TRUE means the limit value for "tolerance low" is provided as a percentage. FALSE means the limit value for "tolerance low" is provided as an absolute. BOOL SetTypeWarningHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypewarninghigh); Set the manner in which the limit value for "warning high" is provided in bar objects. btypewarninghigh = Limit value for "warning high" as percentage or absolute TRUE means the limit value for "warning high" is provided as a percentage. FALSE means the limit value for "warning high" is provided as an absolute WinCC Manual

339 08.97 Global Scripts BOOL SetTypeWarningLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btypewarninglow); Set the manner in which the limit value for "warning low" is provided in bar objects. btypewarninglow = Limit value for "warning low" as percentage or absolute TRUE means the limit value for "warning low" is provided as a percentage. FALSE means the limit value for "warning low" is provided as an absolute. BOOL SetWarningHigh (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dwarninghigh); Set the limit value for "warning high" in bar objects. dwarninghigh = Limit value for "warning high" BOOL SetWarningLow (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dwarninglow); Set the limit value for "warning low" in bar objects. dwarninglow = Limit value for "warning low" WinCC Manual 4-87

340 Global Scripts graphics-set-link Functions BOOL SetLink(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname,lpctstr lpszpropertyname, LPLINKINFO() plink); Create a tag link of object properties. lpszpropertyname plink = Object property = Address entry of the tag link structure Structure: The tag structure consists of the LinkTyp, dwcycle, and szlinkname parameters. LinkTyp: 1 direct tag link 2 indirect tag link dwcycle: 0 Upon change ms ms 3 1 s 4 2 s 5 5 s 6 10 s 7 1 min 8 5 min 9 10 min 10 1 hr User cycle 1 to 5 szlinkname: The tag name Example: { LINKINFO linkinfo; linkinfo.llinktype = 1; linkinfo.cwcycle = 3; strcpy(linkinfo.szlinkname, Tag1 ); } SetLink(..., &linkinfo); 4-88 WinCC Manual

341 08.97 Global Scripts graphics-set-misc Functions BOOL SetAverage (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL baverage); Determine if the last 15 values in a bar object are averaged. baverage = Average the values: yes/no TRUE means the last 15 values will be averaged. FALSE means the last 15 values will not be averaged. BOOL SetBoxType (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lboxtype); Set the field type of an I/O object (input field, output field, input/output field). lboxtype = Field type of an I/O object (input field, output field, input/output field) BOOL SetColorChangeType(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcolorchangetype); Set the type of color change for bars. bcolorchangetype = Type of color change: total/segment TRUE means a color change for the bar segment. FALSE means a color change for the entire bar. WinCC Manual 4-89

342 Global Scripts BOOL SetCursorControl (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcursorcontrol); Set the cursor control for I/O fields. bcursorcontrol = Cursor control: on/off TRUE means that the cursor control is turned on in I/O fields (an alpha cursor jumps to the next field in the TAB sequence after exiting the current field). FALSE means that the cursor control is turned off in I/O fields. BOOL SetCursorMode (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bcursormode); Set the cursor mode for the picture. bcursormode = Cursor mode: tab order sequence/alpha cursor sequence TRUE means that the cursor mode for the picture is an alpha cursor sequence. FALSE means that the cursor mode for the picture is a tab order sequence. BOOL SetEditAtOnce (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL beditatonce); Set the input for I/O fields. beditatonce = Immediate input: yes/no TRUE means that the immediate input attribute is set to "yes" for I/O fields (you can make an input immediately upon accessing the I/O field with the Tab key, without having to carry out any further action). FALSE means that the immediate input attribute is set to "no" for I/O fields WinCC Manual

343 08.97 Global Scripts BOOL SetExtendedOperation (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bextendedoperation); Set the extended operation for sliders. bextendedoperation = Extended operation: yes/no TRUE means that the extended operation attribute is set to "yes" for sliders (the slider is set to a new appropriate minimum/maximum limit value by clicking on the area outside of the current slider setting) FALSE means that the extended operation attribute is set to "no" for sliders. BOOL SetHysteresis (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bhysteresis); Set the display for bar objects (with or without hysteresis). bhysteresis = Display with or without hysteresis TRUE means that the display occurs with hysteresis. FALSE means that the display occurs without hysteresis. BOOL SetHysteresisRange (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dhysteresisrange); Set the hysteresis in the bar object display (hysteresis as a percent of the display value). dhysteresisrange = Hysteresis BOOL SetMax (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dmax); Set the absolute value for a full value view with bar and slider objects. dmax = Maximum value WinCC Manual 4-91

344 Global Scripts BOOL SetMin (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dmin); Set the absolute value for the smallest value view for bar and slider objects. dmin = Minium value BOOL SetOffsetLeft (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int loffsetleft); Set the horizontal distance of the picture from the left edge of the window in picture windows. loffsetleft = Picture offset BOOL SetOffsetTop (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int loffsettop); Set the vertical distance of the picture from the top edge of the window in picture windows. loffsettop = Picture offset BOOL SetOperation (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL boperation); Determine whether objects can be controlled. boperation = Object can be controlled: yes/no TRUE means that the object can be controlled. FALSE means that the object cannot be controlled. Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL WinCC Manual

345 08.97 Global Scripts BOOL SetOperationMessage (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL boperationmessage); Valid for the I/O field, check box, option button, and slider objects Determine whether a message is output when an operation is successfully carried out. boperationmessage = A message is output when an operation is successfully carried out: yes/no TRUE means that a message is output when an operation is successfully carried out. FALSE means that no message is output when an operation is successfully carried out. BOOL SetOperationReport (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL boperationreport); Valid for all objects except application windows, picture windows, and OLE control. Determine whether the reason for operator activity in objects is reported. boperationreport = The reason for operator activity is reported: yes/no TRUE means that the reason for operator activity is reported. FALSE means that the reason for operator activity is not reported. Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. WinCC Manual 4-93

346 Global Scripts BOOL SetPasswordLevel (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lpasswordlevel); Valid for all objects except application windows, picture windows, and OLE control. Set the authorization level for controlling the object. lpasswordlevel = Authorization level Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetPictureName (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* szpicturename); Set a pointer to the name of a picture contained in a picture object. szpicturename = Pointer to the name of the picture BOOL SetProcess (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dprocess); Valid for the slider, bar, check box, and option group objects. For sliders and bars: Set the value of the presetting for the process value to be displayed. For check boxes and option groups: Select the box(es). dprocess = Value of the default BOOL SetSmallChange (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lsmallchange); Set the number of steps the slider can be moved with a mouse click. lsmallchange = Number of steps set 4-94 WinCC Manual

347 08.97 Global Scripts BOOL SetTrend (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btrend); Set the trend display in bar objects. btrend = Display trend: yes/no TRUE means that the trend is displayed in a bar object. FALSE means that the trend is not displayed in a bar object. BOOL SetVisible (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bvisible); Determine whether an object is displayed. bvisible = Object is displayed: yes/no TRUE means that the object is displayed. FALSE means that the object is not displayed. Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetZeroPointValue (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, double dzeropointvalue); Set the absolute value for the zero point in a bar display. dzeropointvalue = Absolute value for the zero point BOOL SetZoom (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lzoom); Set the zoom factor for a picture window. lzoom = Zoom factor WinCC Manual 4-95

348 Global Scripts graphics-set-ole_control Functions BOOL SetPosition(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lposition); Set the slider position for the OCX slider. lposition = Slider position of the OCX slider BOOL SetRangeMax(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lrangemax); Set the maximum setting range for the OCX slider. lrangemax = Maximum setting range for the OCX slider BOOL SetRangeMin(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lrangemin); Set the minimum setting range for the OCX slider. lrangemin = Minimum setting range for the OCX slider 4-96 WinCC Manual

349 08.97 Global Scripts graphics-set-pictures Functions BOOL SetPictureDeactivated(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* szpicturedeactivated); Set the picture name for the "deactivated" state of a round button. Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be linked. szpicturedeactivated = Picture name for the "deactivated" state BOOL SetPictureDown(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* szpicturedown); Set the picture name for the "on/pressed" status of a round button. Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be linked. szpicturedown = Picture name for the "on/pressed" status BOOL SetPictureUp(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, char* szpictureup); Set the picture name for the "off/not pressed" status of a round button. Bitmap files (*.bmp, *.dib) as well as metafiles (*.emf, *.wmf) can be linked. szpictureup = Picture name for the "off/not pressed" status BOOL SetPicDeactTransparent(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lpicdeacttransparent); Set the transparent color for the "deactivated" status of a round button. Note: This function only applies to bitmap graphics. lpicdeacttransparent = Transparent color for the "deactivated" status WinCC Manual 4-97

350 Global Scripts BOOL SetPicDeactUseTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bpicdeactusetranscolor); Control the transparent color for the "deactivated" status of a round button bpicdeactusetranscolor = Transparent color yes/no TRUE Use transparent color for the "deactivated" status. FALSE Do not use transparent color for the "deactivated" status. BOOL SetPicDownTransparent(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lpicdowntransparent); Set the transparent color for the "on/pressed" status of a round button. Note: This function only applies to bitmap graphics. lpicdowntransparent = Transparent color for the "on/pressed" status BOOL SetPicDownUseTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bpicdownusetranscolor); Control the transparent color for the "on/pressed" status of a round button. bpicdownusetranscolor = Transparent color yes/no TRUE Use transparent color for the "on/pressed" status. FALSE Do not use transparent color for the "on/pressed" status WinCC Manual

351 08.97 Global Scripts BOOL SetPicTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lpictranscolor); Set the transparent color of the background picture of a graphic object. Note: This function only applies to bitmap graphics. lpictranscolor = Transparent color of the background picture BOOL SetPicUpTransparent(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lpicuptransparent); Set the transparent color for the "off/not pressed" status of a round button. Note: This function only applies to bitmap graphics. lpicuptransparent = Transparent color "off/not pressed" WinCC Manual 4-99

352 Global Scripts BOOL SetPicUpUseTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bpicupusetranscolor); Control the transparent color for the "off/not pressed" status of a round button. bpicupusetranscolor = Transparent color yes/no TRUE Use the transparent color for the "off/not pressed" status. FALSE Do not use the transparent color for the "off/not pressed" status. BOOL SetPicUseTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bpicusetranscolor); Control the transparent color of the background picture of a graphic object. bpicusetranscolor = Transparent color yes/no TRUE Use transparent color for the background picture. FALSE Do not use transparent color fro the background picture WinCC Manual

353 08.97 Global Scripts graphics-set-property-funktionen BOOL SetPropBOOL(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname, BOOL bvalue) Sets the attribute with the value bvalue. lpszpropertyname bvalue = OLE-Automation-Name of the attribute = Value (TRUE, FALSE) Example: SetPropBOOL("Picture1","CustomizedObject1","Visible1",FALSE); //ReturnType BOOL The self-defined attribute of the OLE-Automation-Name Visible1 of the customized object CustomizedObject1 in the picture Picture1 is set to FALSE. BOOL SetPropChar(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname, char* szvalue) Sets the attribute value to which the pointer szvalue is pointing. lpszpropertyname szvalue = OLE-Automation-Name of the attribute = Zeiger on the value WinCC Manual 4-101

354 Global Scripts BOOL SetPropDouble(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname, double dvalue) Sets the attribute with the value dvalue. lpszpropertyname dvalue = OLE-Automation-Name of the attribute = Value BOOL SetPropWord(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, LPCTSTR lpszpropertyname, long lvalue) Sets the attribute with the value lvalue. lpszpropertyname lvalue = OLE-Automation-Name of the attribute = Value WinCC Manual

355 08.97 Global Scripts graphics-set-state Functions BOOL SetBasePicTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbasepictranscolor); Set the transparent color of the base picture of a status display. Note: This function only applies to bitmap graphics. lbasepictranscolor = Transparent color of the base picture BOOL SetBasePicUseTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bbasepicusetranscolor); Control the transparent color of the base picture of a status display. bbasepicusetranscolor = Transparent color yes/no TRUE Use the transparent color in the base picture. FALSE Do not use the transparent color in the base picture. BOOL SetFlashFlashPicture(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bflashflashpicture); Control the flashing of the flash picture in a status display. bflashflashpicture = Transparent color yes/no TRUE Flash picture dynamic FALSE Flash picture static WinCC Manual 4-103

356 Global Scripts BOOL SetFlashPicTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lflashpictranscolor); Set the transparent color of the flash picture for a status display. Note: This function only applies to bitmap graphics. lflashpictranscolor = Transparent color in the flash picture BOOL SetFlashPicUseTransColor(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bflashpicusetranscolor); Control the transparent color of the flash picture in a status display. bflashpicusetranscolor = Transparent color yes/no TRUE Use transparent color in the flash picture. FALSE Do not use transparent color in the flash picture WinCC Manual

357 08.97 Global Scripts BOOL SetFlashRateFlashPic(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lflashrateflashpic); Set the flash frequency of the flash picture in a status display. lflashrateflashpic = Flash picture flash frequency 0: No flash frequency 1: Flash frequency slow (approximately 0.5 Hz) 2: Flash frequency medium (approximately 2 Hz) 3: Flash frequency fast (approximately 8 Hz) Note: Since flashing is a software implementation, the frequency depends on the system and the hardware (number of objects, processor, memory, update time, etc.). BOOL SetIndex(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lindex); Sets the index of a polygon or polyline, and therefore the current point of the object. lindex = Index value WinCC Manual 4-105

358 Global Scripts graphics-set-style Functions BOOL SetBackBorderWidth(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lbackborderwidth); Set the weight of the border for 3D borders and slider objects. lbackborderwidth = Border weight BOOL SetBorderEndStyle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lborderendstyle); Set the line end style. lborderendstyle = Number value of the line end style BOOL SetBorderStyle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lborderstyle); Set the line or border style. lborderstyle = Number value of the line or border style BOOL SetBorderWidth (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lborderwidth); Set the line or border weight. lborderwidth = Number value of the weight of the line or border WinCC Manual

359 08.97 Global Scripts BOOL SetBoxAlignment (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lboxalignment); Align the control elements in check boxes or option buttons to the left or right. lboxalignment = Number value of the alignment of the control elements in check boxes or option buttons to the left or right BOOL SetFillStyle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lfillstyle); Set the fill pattern. lfillstyle = Number value of the type of the fill pattern Note: If the call of the function relates to the entire picture, the lpszobjectname parameter must be = NULL. BOOL SetFillStyle2 (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long int lfillstyle2); Set the fill pattern of a bar in a bar display. lfillstyle2 = Number value of the fill pattern of a bar in a bar display BOOL SetItem BorderStyle(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long ind litemborderstyle); Set the separate line type for the "text list" object. litemborderstyle = Number value of the separate line WinCC Manual 4-107

360 Global Scripts BOOL SetItem BorderWidth(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, long ind litemborderwidth); Set the separate line weight for the "text list" object. litemborderwidth = Number value of the separate line weight BOOL SetPressed(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bpressed); Valid only for round buttons Control the switch setting of a round button. bpressed = Switch setting of a round button TRUE Switch setting "on/pressed" FALSE Switch setting "off/not pressed" WinCC Manual

361 08.97 Global Scripts BOOL SetToggle(LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL btoggle); Valid only for round buttons Control the switch function latched or not latched. btoggle = Switch function latched or not latched TRUE Switch function not latched FALSE Switch function latched BOOL SetWindowsStyle (LPCTSTR lpszpicturename, LPCTSTR lpszobjectname, BOOL bwindowstyle); Valid only for buttons Turn the "Windows Style" on or off. bwindowstyle = "Windows Style" on/off TRUE corresponds to "Windows Style" which means that the button is displayed as is standard for Windows (gray buttons without borders). FALSE corresponds to "not Windows Style," which means you can set the look of the button yourself. WinCC Manual 4-109

362 Global Scripts Tag The Tag function category is divided into the following functions: get functions General get functions get state functions get wait functions get state wait functions set Functions General set functions set state functions set wait functions set state wait functions The wait functions differ from the other functions in that the tag values are accessed directly at the process. The tags are not logged into the Control Center. You can reduce the communication network load significantly by implementing the appropriate get-wait or get-state-wait functions instead of the get or get-state functions because the tags are then no longer scanned cyclically for changes in this case. Since the system waits until the wait functions are eectured, the processes can be better synchronized. The return value of the set functions is the error code TRUE: no errors FALSE: an error occurred WinCC Manual

363 08.97 Global Scripts tag-get-functions short int GetTagBit (Tag Tag_Name); Value of the process tag in the "short int" data type Tag_Name = Name of the process tag BYTE GetTagByte (Tag Tag_Name); Value of the process tag in the "BYTE" data type Tag_Name = Name of the process tag char* GetTagChar (Tag Tag_Name); Pointer to the value of the process tag in the "char" data type Tag_Name = Name of the process tag double GetTagDouble (Tag Tag_Name); Value of the process tag in the "double" data type Tag_Name = Name of the process tag DWORD GetTagDWord (Tag Tag_Name); Value of the process tag in the "DWORD" data type Tag_Name = Name of the process tag WinCC Manual 4-111

364 Global Scripts float GetTagFloat (Tag Tag_Name); Value of the process tag in the "float" data type Tag_Name = Name of the process tag BOOL GetTagRaw (Tag Tag_Name, BYTE* pvalue, DWORD size); Error code TRUE = no errors FALSE = an error occurred Gets a value from the raw data type. Tag_Name pvalue size = Name of the process tag = Byte pointer to a byte box that contains raw data = Size of the box in bytes signed char GetTagSByte(Tag Tag_Name); Value of the process tag in the "signed char" data type Tag_Name = Name of the process tag long GetTagSDWord(Tag Tag_Name); Value of the process tag in the "long" data type Tag_Name = Name of the process tag WinCC Manual

365 08.97 Global Scripts short GetTagSWord(Tag Tag_Name); Value of the process tag in the "short" data type. Tag_Name = Name of the process tag BOOL GetTagValue (LPDM_VARKEY lpdmvarkey, LPDM_VAR_UPDATE_STRUCT lpdmresult, LPCMN_ERROR lpdmerror); Error code TRUE = no errors FALSE = an error occurred Enables the transfer of a value in the form of a variant. Gets a pointer to the result structure that contains the value. lpdmvarkey = Pointer to the DM_VARKEY structure lpdmresult = Pointer to the value of the "variant" data type lpdmerror = Pointer to the structure that cont ains the error description WORD GetTagWord (Tag Tag_Name); Value of the process tag in the "WORD" data type Tag_Name = Name of the process tag WinCC Manual 4-113

366 Global Scripts tag-get-state Functions short int GetTagBitState (Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "short int" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag BYTE GetTagByteState (Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "BYTE" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag char* GetTagCharState (Tag Tag_Name, PDWORD lp_dwstate); Pointer to the value of the process tag in the "char" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag double GetTagDoubleState (Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "double" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag WinCC Manual

367 08.97 Global Scripts DWORD GetTagDWordState (Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "DWORD" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag float GetTagFloatState (Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "float" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag BOOL GetTagRawState (Tag Tag_Name, BYTE* pvalue, DWORD size, PDWORD lp_dwstate); Error code TRUE = no errors FALSE = an error occurred Value of the process tags in the raw data type. Tag_Name pvalue size lp_dwstate = Name of the process tag = Byte pointer to a byte box that contains raw data = Size of the box in bytes = Status of the tag signed char GetTagSByteState(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "signed char" data type. Tag_Name lp_dwstate = Name of the process tag = Status of the tag WinCC Manual 4-115

368 Global Scripts long GetTagSDWordState(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "long" data type. Tag_Name lp_dwstate = Name of the process tag = Status of the tag short GetTagSWordState(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "short" data type. Tag_Name lp_dwstate = Name of the process tag = Status of the tag WORD GetTagWordState (Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "WORD" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag WinCC Manual

369 08.97 Global Scripts tag-get-wait Functions VARIANT_BOOL GetTagBitWait(Tag Tag_Name); Value of the process tag in the "VARIANT_BOOL" data type. Tag_Name = Name of the process tag BYTE GetTagByteWait(Tag Tag_Name); Value of the process tag in the "BYTE" data type Tag_Name = Name of the process tag char* GetTagCharWait(Tag Tag_Name); Pointer to the value of the process tag in the "char" data type Tag_Name = Name of the process tag double GetTagDoubleWait(Tag Tag_Name); Value of the process tag in the "double" data type Tag_Name = Name of the process tag DWORD GetTagDWordWait(Tag Tag_Name); Value of the process tag in the "DWORD" data type Tag_Name = Name of the process tag WinCC Manual 4-117

370 Global Scripts float GetTagFloatWait(Tag Tag_Name); Value of the process tag in the "float" data type Tag_Name = Name of the process tag BOOL GetTagMultiWait(const char* pformat,...) TRUE = no error occurred FALSE = an error occurred The values of multiple tags are determined and stored at the corresponding addresses in the indicated format. pformat = Format description like at the function printfs. Followed by the tag name and the address of the value. Example: DWORD dwtag1value; char* sztag2value; //Storage for the tag value is created by the function with SysMalloc BOOL ok; ok=gettagmultiwait("%d %s, "Tag1", &dwtag1value, "Tag2", &sztag2value); BOOL GetTagRawWait(Tag Tag_Name, BYTE pvalue[], DWORD size); TRUE = no errors FALSE = an error occurred Get a value from the raw data type. Tag_Name pvalue size = Name of the process tag = Byte pointer to a byte box that contains raw data = Size of the box in bytes WinCC Manual

371 08.97 Global Scripts signed char GetTagSByteWait(Tag Tag_Name); Value of the process tag in the "signed char" data type Tag_Name = Name of the process tag long GetTagSDWordWait(Tag Tag_Name); Value of the process tag in the "long" data type Tag_Name = Name of the process tag short GetTagSWordWait(Tag Tag_Name); Value of the process tag in the "short" data type. Tag_Name = Name of the process tag BOOL GetTagValueWait(LPDM_VARKEY lpdmvarkey, LPDM_VAR_UPDATE_STRUCT lpdmresult, LPCMN_ERROR lpdmerror); TRUE = no errors FALSE = an error occurred Allow the transmission of a value in the form of a variant. Get the pointer to the result structure that contains the value. lpdmvarkey = Pointer to the DM_VARKEY structure lpdmresult = Pointer to the value of the "Variant" data type lpdmerror = Pointer to the structure that contains the error description WinCC Manual 4-119

372 Global Scripts WORD GetTagWordWait(Tag Tag_Name); Value of the process tag in the "WORD" data type Tag_Name = Name of the process tag WinCC Manual

373 08.97 Global Scripts tag-get-state-wait Functions VARIANT_BOOL GetTagBitStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "VARIANT_BOOL" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag BYTE GetTagByteStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "BYTE" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag char* GetTagCharStateWait(Tag Tag_Name, PDWORD lp_dwstate); Pointer to the value of the process tag in the "char" data type. Tag_Name lp_dwstate = Name of process tag = Status of the tag double GetTagDoubleStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "double" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag WinCC Manual 4-121

374 Global Scripts DWORD GetTagDWordStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "DWORD" data type. Tag_Name lp_dwstate = Name of the process tag = Status of the tag float GetTagFloatStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "float" data type. Tag_Name lp_dwstate = Name of the process tag = Status of the tag BOOL GetTagMultiStateWait(DWORD* pdwstate, const char* pformat) TRUE = no error occurred FALSE = an error occurred The values and states of multiple tags are determined and stored at the corresponding addresses in the indicated format. pdwstate = pformat = Field, in which the tag states are stored Format description like at the function printfs. Followed by the tag name and the address of the value. Example: DWORD dwsate[2]; DWORD dwtag1value; char* sztag2value; //Storage for the tag value is created by the function with SysMalloc BOOL ok; ok=gettagmultistatewait ("%d %s, &dwsate, "Tag1", &dwtag1value, "Tag2", &sztag2value); WinCC Manual

375 08.97 Global Scripts BOOL GetTagRawStateWait(Tag Tag_Name, BYTE pvalue[], DWORD size, PDWORD lp_dwstate); TRUE = no errors FALSE = an error occurred Determines a value of the raw data type. Tag_Name pvalue size lp_dwstate = Name of the process tag = Byte pointer to a byte box that contains raw data = Size of the box in bytes = Status of the tag signed char GetTagSByteStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "signed char" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag long GetTagSDWordStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "long" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag WinCC Manual 4-123

376 Global Scripts short GetTagSWordStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "short" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag WORD GetTagWordStateWait(Tag Tag_Name, PDWORD lp_dwstate); Value of the process tag in the "WORD" data type Tag_Name lp_dwstate = Name of the process tag = Status of the tag WinCC Manual

377 08.97 Global Scripts Tag-set Functions BOOL SetTagBit (Tag Tag_Name, short int value); Set the value of the process tag with a value of the "short int" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagByte (Tag Tag_Name, BYTE value); Set the value of the process tag with a value of the "BYTE" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagChar (Tag Tag_Name, LPSTR value); Set the value of the process tag with a value of the "char" data type. Tag_Name value = Name of the tag = Pointer to the value of the tag BOOL SetTagDouble (Tag Tag_Name, double value); Set the value of the process tag with a value of the "double" data type. Tag_Name value = Name of the tag = Value of the tag WinCC Manual 4-125

378 Global Scripts BOOL SetTagDWord (Tag Tag_Name, DWORD value); Set the value of the process tag with a value of the "DWORD" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagFloat (Tag Tag_Name, float value); Set the value of the process tag with a value of the "float" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagRaw (Tag Tag_Name, BYTE* pvalue, DWORD size); Set the value of the process tag with a value that is addressed by the pointer pvalue and has a length of "size." Tag_Name = Name of the tag pvalue = Pointer to a byte box that contains the value of the raw data tag size = Size of the box BOOL SetTagSByte(Tag Tag_Name, signed char value); Set the value of the process tag with a value of the "signed char." data type. Tag_Name value = Name of the tag = Value of the tag WinCC Manual

379 08.97 Global Scripts BOOL SetTagSDWord(Tag Tag_Name, long value); Set the value of the process tag with a value of the "long" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagSWord(Tag Tag_Name, short value); Set the value of the process tag with a value of the "short" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagValue (LPDM_VARKEY lpdmvarkey, LPVARIANT lpdmvalue, PDWORD dwstate, LPCMN_ERROR lpdmerror); Enable the transfer of a value in the form of a variant. Set the pointer to the value of the "variant" data type. lpdmvarkey = Pointer to the "DM_VARKEY" structure lpdmvalue = Pointer to the value of the "variant" data type dwstate = Status of the tag. The status is returned after the function is executed. lpdmerror = Pointer to the structure that contains the error description BOOL SetTagWord (Tag Tag_Name, WORD value); Set the value of the process tag with a value of the "WORD" data type. Tag_Name value = Name of the tag = Value of the tag WinCC Manual 4-127

380 Global Scripts tag-set-state Functions BOOL SetTagBitState (Tag Tag_Name, short int value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "short int" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagByteState (Tag Tag_Name, BYTE value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "BYTE" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagCharState (Tag Tag_Name, LPSTR value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "char" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual

381 08.97 Global Scripts BOOL SetTagDoubleState (Tag Tag_Name, double value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "double" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagDWordState (Tag Tag_Name, DWORD value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "DWORD" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagFloatState (Tag Tag_Name, float value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "float" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual 4-129

382 Global Scripts BOOL SetTagRawState (Tag Tag_Name, BYTE* pvalue, DWORD size, PDWORD lp_dwstate); Set the value of the process tag to a value that is addressed by the "pvalue" pointer and has a length of "size." Tag_Name pvalue size lp_dwstate = Name of the tag = Pointer to the value = Length of the value = Status of the tag after the function is executed BOOL SetTagSByteState(Tag Tag_Name, signed char value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "signed char" data type. "lp_dwstate" contains the tag status after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagSDWordState(Tag Tag_Name, long value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "long" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual

383 08.97 Global Scripts BOOL SetTagSWordState(Tag Tag_Name, short value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "short" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagWordState (Tag Tag_Name, WORD value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "WORD" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual 4-131

384 Global Scripts tag-set-wait Functions BOOL SetTagBitWait(Tag Tag_Name, short value); Set the value of the process tag with a value of the "short" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagByteWait(Tag Tag_Name, BYTE value); Set the value of the process tag with a value of the "BYTE" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagCharWait(Tag Tag_Name, LPSTR value); Set the value of the process tag with a value of the "LPSTR" data type. Tag_Name value = Name of the tag = Pointer to the the tag value BOOL SetTagDoubleWait(Tag Tag_Name, double value); Set the value of the process tag with a value of the "double" data type. Tag_Name value = Name of the tag = Value of the tag WinCC Manual

385 08.97 Global Scripts BOOL SetTagDWordWait(Tag Tag_Name, DWORD value); Set the value of the process tag with a value of the "DWORD" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagFloatWait(Tag Tag_Name, float value); Set the value of the process tag with a value of the "float" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagMultiWait(const char* pformat,...) TRUE = no error occurred FALSE = an error occurred The values of multiple tags will be set in the indicated format. pformat = Format description like at the function printfs. Followed by the tag name and the corresponding value. Example: BOOL ok; ok=settagmultiwait("%d %s, "Tag1", 34, "Tag2", "newvalue"); WinCC Manual 4-133

386 Global Scripts BOOL SetTagRawWait(Tag Tag_Name, BYTE pvalue[], DWORD size); Set the value of the process tag with a value that is addressed by the "pvalue" pointer and has the "size" length. Tag_Name = Name of the tag pvalue = Pointer to a byte box that contains the value of the raw data tag size = Size of the box BOOL SetTagSByteWait(Tag Tag_Name, signed char value); Set the value of the process tag with a value of the "signed char" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagSDWordWait(Tag Tag_Name, long value); Set the value of the process tag with a value of the "long" data type. Tag_Name value = Name of the tag = Value of the tag BOOL SetTagSWordWait(Tag Tag_Name, short value); Set the value of the process tag with a value of the "short" data type. Tag_Name value = Name of the tag = Value of the tag WinCC Manual

387 08.97 Global Scripts BOOL SetTagValueWait(LPDM_VARKEY lpdmvarkey, LPVARIANT lpdmvalue, PDWORD dwstate, LPCMN_ERROR lpdmerror); Allows the transmission of a value in the form of a variant. Sets the pointer to the value of the "Variant" data type. lpdmvarkey = Pointer to the DM_VARKEY structure lpdmvalue = Pointer to the value of the "variant" data type dwstate = Status of the tag that is returned after the function is executed lpdmerror = Pointer to the structure that contains the error description BOOL SetTagWordWait(Tag Tag_Name, WORD value); Set the value of the process tag with a value of the "WORD" data type. Tag_Name value = Name of the tag = Value of the tag WinCC Manual 4-135

388 Global Scripts tag-set-state-wait Functions BOOL SetTagBitStateWait(Tag Tag_Name, short value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "short" data type. "lp_dwstate" contains the tag status after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagByteStateWait(Tag Tag_Name, BYTE value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "BYTE" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagCharStateWait(Tag Tag_Name, LPSTR value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "LPSTR" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Pointer to the tag value = Status of the tag after the function is executed WinCC Manual

389 08.97 Global Scripts BOOL SetTagDoubleStateWait(Tag Tag_Name, double value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "double" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagDWordStateWait(Tag Tag_Name, DWORD value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "DWORD" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagFloatStateWait(Tag Tag_Name, float value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "float" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual 4-137

390 Global Scripts BOOL SetTagMultiStateWait(DWORD* pdwstate, const char* pformat,...) TRUE = no error occurred FALSE = an error occurred The values and states of multiple tags will be stored in the indicated format. pdwstate = pformat = Field, in which the tag states are stored Format description like at the function printfs. Followed by the tag name and the value. Example: DWORD dwstate[3]; BOOL ok; ok=settagmultistatewait ("%d %s %f, &dwstate[0], "Tag1", 34, "Tag2", "newvalue", "Tag3", 4.67); BOOL SetTagRawStateWait(Tag Tag_Name, BYTE pvalue[], DWORD size, PDWORD lp_dwstate); Set the value of the process tag with a value that is addressed by the "pvalue" pointer and has a length of "size." Tag_Name pvalue size lp_dwstate = Name of the tag = Pointer to the value = Length of the value = Status of the tag after the function is executed BOOL SetTagSByteStateWait(Tag Tag_Name, signed char value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "signed char" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual

391 08.97 Global Scripts BOOL SetTagSDWordStateWait(Tag Tag_Name, long value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "long" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagSWordStateWait(Tag Tag_Name, short value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "short" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed BOOL SetTagWordStateWait(Tag Tag_Name, WORD value, PDWORD lp_dwstate); Set the value of the process tag with a value of the "WORD" data type. "lp_dwstate" contains the status of the tag after the function is executed. Tag_Name value lp_dwstate = Name of the tag = Value of the tag = Status of the tag after the function is executed WinCC Manual 4-139

392 Global Scripts wincc The "WinCC" function category is divided into the following functions: system The return value of the functions is one of the following error codes: TRUE: The function was executed without errors. FALSE: An error occurred wincc system BOOL DeactivateRTProject (); Deactivate the currently running project. BOOL ExitWinCC (); Exit WinCC. DWORD GetLanguage(); Language identifier for the language set at run time. Transmits the language that is set. The following assignments apply (Language identifier hexadecimal): German (Germany) = 0x407 English (USA) = 0x409 French (France) = 0x40C For additional language identifier s see section WinCC Manual

393 08.97 Global Scripts DWORD* InquireLanguage(DWORD* dwcount); Pointer to a box that contains the transmitted language identifier s. Transmits all languages that are configured in the text library for run time. Use dwcount to specify where the number of transmitted language identifiers should be stored. The following assignments apply (language identifier hexadecimal): German (Germany) = 0x407 English (USA) = 0x409 French (France) = 0x40C For additional language identifier s see section 6.1. dwcount = Pointer to the number of transmitted language identifiers BOOL SetLanguage(DWORD dwlocaleid); Sets the language that is current for the run time by means of the language identifier provided. The following assignments apply (language identifier hexadecimal): German (Germany) = 0x407 English (USA) = 0x409 French (France) = 0x40C For additional language identifiers see section 6.1. dwlocaleid = Language identifier WinCC Manual 4-141

394 Global Scripts WinCC Manual

395 08.97 Global Scripts 5 Actions Global Script actions are actions you can create and change yourself. They are only valid in the actual project in which they were created. Use Global Script actions at run time to control the process. They are executed by means of a trigger. Create a Global Script action with the Global Script editor. Start this editor in the Control Center. Use the following steps to create a Global Script action: 1. Formulate the function (see Section 2). 2. Expand the function information (see Section 2). 3. Set the trigger(s) as the starting events. 4. Compile the action (see Section 2). 5. Set the operator authorization. 6. Save the action and, if necessary, rename it (see Section 2). Now you have created your Global Script action. Global Script actions can be exported and imported. An imported action completely replaces the action in the active window. You can assign a level of authorization to your action. If a new action is created, the header file apdefap.h is integrated automatically by the project folder...\<projectname>\library. If there is no project function available, the header file from the folder...\aplib is integrated. This makes the standard and project functions available in the actions. In the case of multi-user system, there is a difference between global and local actions. Global actions are loaded in the project folder independently of the computer (...\<Projectname>\PAS). These are active on any computer. Local actions are loaded according to their computer in the project directory (...\<Projectname>\<Computername>\PAS). This means that local actions are only active on the corresponding computer. WinCC Manual 5-1

396 Global Scripts How to Set the Trigger: 1. If you have more than one editing window open at the same time, select the window in which the desired action is located. This selection makes the window active. 2. Click on the button to open the "Description" dialog box. 3. Switch to the "Trigger" tab. You can select from the following trigger types: Acyclic: The action is only triggered once at a defined point in time. Cyclic: The action is continuously triggered in a set time frame. Tag: The action is triggered when the value of a certain tag changes. 5-2 WinCC Manual