Button

Element name

The element name can be changed. Standard name is "GenElemInst_x". "x" stands for a sequential number.

Element type

The element type is entered here. For three element groups it is possible to switch between the corresponding elements by changing the element type:

• rectangle, rounded rectangle and ellipse
• Polygon, polyline or Bézier curve
• dip switch, power switch, push switch, push switch with LED, rocker switch

X

Horizontal position in pixels – X=0 is the left edge of the window.

Y

Vertical position in pixels – Y=0 is the upper edge of the window.

Width

Width of the element in pixels

Height

Height of the element in pixels

X

Horizontal position of the element pivot in pixels

Y

Vertical position of the element pivot in pixels

Color

Select a frame and fill color for the default state. If the color switching variable is defined as FALSE, the element is in default state.

Alarm color

Select a frame and fill color for the element in alarm state. This is triggered, if the color switching variable is defined as TRUE.

Use color gradient

The checkbox is unticked by default. If it is ticked, the corresponding element is drawn with a color gradient.

Color gradient selection

The Gradient editor opens.

Button height

Height in pixels for the button in embossed view

Static ID

Static ID of the image file for the button. The ID (string) is defined in the image pool. The name of the image pool should be prefixed in order to make the entry unambiguous. For image files that are managed in the GlobalImagePool, it is not necessary to specify an image pool, since this image pool is always searched first. Click the button to open the input assistant with a list of all available image pools and their images.

Scaling type

Here you can specify how the image file responds to changes in the button size:

• Isotropic: The image retains its proportions; i.e. the height/width ratio is maintained, even if the height and width of the button are changed separately.
• Anisotropic: The image retains its proportions; i.e. the height/width ratio is maintained, even if the height and width of the button are changed separately.
• Unscaled: The image retains its original size, even if the size of the button changes.

Transparency

If this option is enabled, the bitmap is made transparent with the color set under "Transparency color".

Transparency color

Here you can set the color to be shown fully transparent in the image.

Requirement: Transparency is enabled

Horizontal alignment

Here you can define the horizontal alignment of the bitmap:

• Left
• Centered
• Right

Vertical alignment

Here you can define the vertical alignment of the bitmap:

• Top
• Centered
• Bottom

Text

Enter a text. It is used to label the element. The text can contain a formatting sequence, e.g. %s. The corresponding variable is defined in "Text variables".

Note: The text can also be entered directly. If the element is selected in the visualization editor, an input field can be opened by pressing the space bar.

Tooltip

Enter a text. It is used as a tooltip for the element and appears in the visualization only in online mode when the cursor is placed over an element. The text can contain a formatting sequence, e.g. %s. The corresponding variable is defined in "Text variables".

Font

Defines the font through selection from predefined fonts:

• Standard
• Heading
• Large heading
• Title
• Note

Press to opens the dialog for user-defined font properties.

Font color

Defines the font color for the element. Either from the selection list or via the dialog that opens when is clicked.

Motion

• X
• Y

X: The integer variable entered here defines the current x-position of the top left corner of the element (in pixels). It can be used to move the element in x-direction. (A positive value moves the element from left to right).

Y: The integer variable entered here defines the current y-position of the top left corner of the element (in pixels). It can be used to move the element in y-direction. (A positive value moves the element from top to bottom).

Rotation

The integer variable entered here defines the angle (angular degrees) for rotating the element around a rotation point.

Positive values = clockwise

Note: In contrast to the behavior with ‘internal rotation’ (see below), the element itself does not rotate. Click on the element to show the rotation point . It can be moved by pressing and holding the mouse button.

Scaling

The integer variable entered here defines the current scaling factor (percent). The element size is adjusted linearly according to this value. The value is implicitly divides by 1000, so that it is not necessary to use REAL variables in order to shrink the element. The scaling always refers to the rotation point (center). Click on the element to show the rotation point . It can be moved by pressing and holding the mouse button.

Internal rotation

The integer variable entered here defines the angle (angular degrees) by which the element is rotated around its rotation point; positive values=mathematically positive=clockwise. In contrast to "Rotation" (see above), the element itself rotates. Click on the element to show the rotation point (center) . It can be moved by pressing and holding the mouse button.

Top left movement

• X
• Y

• X: Integer variable, the value of which indicates the number of pixels by which the top left corner is moved in x-direction.
• Y: Integer variable, the value of which indicates the number of pixels by which the top left corner is moved in y-direction.

Bottom right movement

• X
• Y

• X: Integer variable, the value of which indicates the number of pixels by which the bottom right corner is moved in x-direction.
• Y: Integer variable, the value of which indicates the number of pixels by which the bottom right corner is moved in y-direction.

Text variable

Variable (of default data type) containing the information to be displayed. The type must match the formatting sequence in the "Texts" setting.

Tooltipvariable

Variable of type String containing the tooltip text to be displayed. The entry in the property "Texts" must contain a formatting sequence.

Text list

Name of the text list, as used in the project tree, as a string

Example: 'TL_ErrorList'

Textindex

Index (ID) of the text, as defined in the text list, as a string. It can be specified directly in a static manner or as a string variable.

Tooltipindex

Index (ID) of the tooltip text, as defined in the text list, as a string. It can be specified directly in a static manner or as a string variable.

Font name

Specification of a variable of the type String that contains the font name that is to be used to label the element. (name specified as in the standard font dialog)

Example: MAIN.sFont (sFont := ‘Arial’;)

Size

Variable of type INT containing the size of the element text in pixels, as in the default dialog ‘Font’.

Example: MAIN.nHeight (nHeight := 16;)

Flags

Variable of type DWORD for defining the font display via one of the flag values listed below. A combined definition can be achieved by adding the respective flag values and specifying the sum.

• 1: italics
• 2: bold
• 4: underlined
• 8: deleted

Example:

MAIN.nFlag (nFlag := 6;)

The text is shown bold and underlined.

Character set

The character set to be used for the font can be defined via the default font number. This number can be specified via a DWORD variable (see also the definition in the default font dialog)

Color

Variable of type DWORD for defining the color of the element text.

Flags for the text alignment

Variable of type DWORD for defining the text alignment via one of the flag values listed below. A combined definition can be achieved by adding the respective flag values and specifying the sum.

• 0: top left
• 1: centered horizontally
• 2: right
• 4: centered vertically
• 8: below

Example

MAIN.nFlag (nFlag := 5;)

The text is displayed centered horizontally and vertically.

Color change

Boolean variable, which controls the switching of the element color between "normal state" (variable = FALSE) and "alarm state" (variable = TRUE).

Normal state

Variable of type DWORD for defining the element color. It overwrites the value that is currently defined in "Colors". The value in the project variable is used, if the variable defined in "Color change" is FALSE.

Alarm state

Variable of type DWORD for defining the element color in alarm state. It overwrites the value that is currently defined in "Colors". The value in the project variable is used, if the variable defined in "Color change" is TRUE.

Invisibility

Specification of a boolean variable. If this returns TRUE, the element is invisible in online mode.

Input disabled

Specification of a boolean variable. If TRUE is returned, inputs for the element have no effect. Also, the element itself is greyed out in the visualization, to indicate that no user inputs are possible.

If the visualization uses the user management, the elements for user groups with access right "only visible" are grayed out.

Boolean value

Boolean variable, which controls the button display as "pressed" if the variable is TRUE, or as "not pressed" if the variable is FALSE.

Image ID

Project variable of the type String that contains the image ID with which the element is to be displayed. The ID is defined in the image pool. The name of the image pool should be prefixed in order to make the entry unambiguous. For image files that are managed in the "GlobalImagePool", it is not necessary to specify an image pool, since this image pool is always searched first.

OnDialogClosed

This event is triggered if one of the dialog boxes that were opened for user inputs is closed within a visualization.

Note: This property is not limited to the element, for which it is configured, but applies within the entire visualization. It therefore does not respond to each dialog closing action. Currently there is no way to define such a property for the entire visualization. It therefore has to be assigned to one of its elements.

OnMouseClick

This mouse event is triggered when the cursor points to an element and a full mouse click (pressing and releasing the mouse button) is executed on this item.

OnMouseDown

This mouse event is triggered when the mouse button is pressed while the cursor points to an element. It is irrelevant where on the visualization the mouse button is released again.

OnMouseEnter

This mouse event is triggered when the cursor is dragged to the element. It is irrelevant whether the mouse button is pressed or released.

OnMouseLeave

This mouse event is triggered when the cursor leaves the element. It is irrelevant whether the mouse button is pressed or released.

OnMouseMove

This mouse event is triggered when the cursor is moved within the element. It is irrelevant whether the mouse button is pressed or released.

OnMouseUp

This mouse event occurs when the mouse button is released on the element. The mouse button was pressed prior to that outside of the element.

Variable

Boolean variable whose value is TRUE if the mouse button is pressed while the cursor points to the element. The value becomes FALSE again when the mouse button is released or the cursor leaves the element.

FALSE keys

If this option is enabled, the key behavior described above is reversed for the corresponding variable. That is, when the mouse button pressed, the variable value is set to FALSE. When the button is, the variable value is set to TRUE.

Switch on enter if mouse trapped

If this option is enabled, the variable value behaves as described under ‘Variables’, as long as the cursor is within the element area. If the cursor leaves the element area while the mouse button is pressed, the variable is set to FALSE. However, it is automatically set to TRUE again, if the cursor returns to the element area without the mouse button being released. In other words, the system takes into account that the mouse is "trapped" as long as the mouse button is pressed, even if the cursor leaves the element area.

Variable

Boolean variable whose value switches between TRUE and FALSE with each mouse click on the element. No switching occurs if the cursor is moved away from the element while the mouse button is pressed. Can be used to cancel a switching action.

Switch on release, if mouse trapped

If this option is enabled, the variable value behaves as described under ‘Variables’, as long as the cursor is within the element area. If the cursor leaves the element area while the mouse button is pressed and the mouse button is then released, the variable is switched anyway. In other words, the system takes into account that the mouse is “trapped” as long as the mouse button is pressed, even if the cursor leaves the element area.

Key

Assigning a key. A selection list contains all currently supported keys, e.g. M.

Event(s)

Definition of the event to be executed, if the key or key and modifier are used. Possible values that are available in a selection list:

• No action
• MouseDown action when the key is pressed
• MouseUp action when the key is released
• MouseDown/MouseUp action when the key is pressed/released

Shift

If this option is enabled, the key has to be used in combination with the Shift key.

Control

If this option is enabled, the key has to be used in combination with the Ctrl key.

Alt

If this option is enabled, the key has to be used in combination with the Alt key.

Not set. All rights.

The default message is set, if the element is shown as available for all groups.

Rights are issued: Limited rights.

The message is set, if the element is shown with limited behavior for at least one group.