Visualization element ‘Image switcher’

Symbol: fea67f7df817c67ec0a8640e004d4488_ce9c5921828a7570c0a8640e000975cb

Tag: Lamps/Switches/images

This element displays one of three referenced images. Mouse actions change the displayed image. The images are defined in the Image settings element properties. The effects of mouse clicks are defined in the Element behavior property.

Element properties

Element name

Optional

Tip: Assign individual names for elements so that they are found faster in the element list.

Example: ImageSwitcher_1

Element type Image switcher

Element property ‘Position’

The position defines the location and size of the element in the visualization window. These are based on the Cartesian coordinate system. The origin is located at the upper left corner of the window. The positive horizontal x-axis runs to the right. The positive vertical y-axis runs downwards.

X

X coordinate of the upper left corner of the element

Specified in pixels.

Example: 10.

Y

Y coordinate of the upper left corner of the element

Specified in pixels.

Example: 10.

Width

Specified in pixels.

Example: 150

Height

Specified in pixels.

Example: 30

Note

You can also change the values by dragging the box symbols ( fea67f7df817c67ec0a8640e004d4488_7b449e02d0393877c0a8640e01fd8c9e ) to other positions in the editor.

See also

Variable

Variable (BOOL).

The value of the variable changes according to user input and it is independent of the Element behavior element property.

Image settings

Image “on”

Image ID from an image pool. The image can be selected using the input assistant.

The image is used if the variable of the Variable property has the value TRUE.

Image “off”

Image ID from an image pool. The image can be selected using the input assistant.

The image is used if the variable of the Variable property has the value FALSE.

Image “clicked”

Image ID from an image pool. The image is selected using the input assistant.

In runtime mode, the visualization displays the referenced image when the element is clicked (and the mouse button is held down).

Requirement: The Element behavior is Image toggler.

Transparency fea67f7df817c67ec0a8640e004d4488_9a3f06830c0506c5c0a8640e012f0ace : The Transparent color is selected.
Transparent color

The image pixels that have the transparent color are displayed as transparent.

Requirement: Transparency is activated.

  • fea67f7df817c67ec0a8640e004d4488_2be833ef7deb1e6ec0a8640e0056e76c The Color dialog box opens.
  • fea67f7df817c67ec0a8640e004d4488_379d3b8945773148c0a8640e0139d9cb : A drop-down list with color names opens.
Scaling type

Defines how an image fits in the element frame.

  • Fixed: The original size of the image is retained, regardless of the dimensions of the element.
  • Isotropic: The entire image is shown in the element frame, either larger or smaller. As a result, the proportion of height and width are retained.
  • Anisotropic: The image resizes automatically to the dimensions of the element frame, filling the entire element frame. As a result, the proportions are not retained.
Horizontal alignment

Horizontal alignment of the image within the element frame or element

  • Left
  • Centered
  • Right

Requirement: Scaling type is Isotropic.

Vertical alignment

Vertical alignment of the image within the element frame or element

  • Top
  • Centered
  • Bottom

Requirement: Scaling type is Isotropic.

Element behavior  
Tap FALSE

fea67f7df817c67ec0a8640e004d4488_9a3f06830c0506c5c0a8640e012f0ace : While the mouse button is pressed, the image of the Image property is displayed and the Variable property gets the value FALSE instead of the value TRUE, and back.

Requirement: Image tapper is selected in the Element behavior property.

Element property ‘Texts’

Tooltip String display as tooltip for the element. Example: Valid access.

Element property ‘State variables’

The variables control the element behavior dynamically.

Invisible

Variable (BOOL). Toggles the visibility of the element.

TRUE: The element is not visible at runtime.

Deactivate inputs

Variable (BOOL). Toggles the operability of the element.

TRUE: User inputs do not have any effect in runtime more. The element is shown as deactivated.

Element property ‘Access rights’

Requirement: User management is set up for the visualization.

Access rights

Opens the Access rights dialog box for changing the access rights for the element.

Status messages:

  • Not set. All rights.: Access rights for all user groups : operable
  • Rights are assigned: limited rights: Access is restricted for at least one group.

See also