Visualization Element ‘Tab’

Symbol:

Tag: Common controls

This element displays selected visualizations in tabs. The tabs can be used by means of the tab header without having to configure an input configuration. A visualization user switches between visualizations by clicking the tab header.

Element properties

Element name	Optional Tip: Assign individual names for elements so that they are found faster in the element list. Example: Component_1.
Element type	tab control
Tab width	Width of the tab header (in pixels). If there is not space for all tab headers, then a scrollbar is added.

Scaling type

The method with which the height and width of the referencedvisualization are scaled. Isotropic: The visualization is scaled to the size of the element. The visualization retains its proportions with a fixed height/width ratio. Anisotropic: The visualization is scaled to the size of the element. The height and width are adapted to the element independently of each other. Fixed: the visualization is displayed in its original size without taking into account the size of the element. Fixed and scrollable: The visualization is displayed fixed in the element. If it is larger than the element, the element will be provided with scrollbars. Please note: assign variables to the properties Scroll position variable horizontal or Scroll position variable vertical. You can then edit the data of the scrollbar position in the application.

Element property ‘Scrollbar settings’

The properties include variables for the position of the scroll boxes in the scrollbars. You can process the data for the scroll box position in the application.

Requirement: The Scaling type property is Fixed and scrollable.
Scroll position variable horizontal	Variable (integer data type, also array). Includes the position of the horizontal or vertical scroll box. The array contains the position for each display variant. If the visualization is running on multiple display variants, then the position changes are disconnected from each other. Example: PLC_PRG.iScrollHor[CURRENTCLIENTID] PLC_PRG.iScrollVer[CURRENTCLIENTID] In this example, the variable is declared as an array: iScrollHor: ARRAY[0..20] OF INT; iScrollVer: ARRAY[0..20] OF INT; CURRENTCLIENTID indicates the current display variant.
Scroll position variable, vertical

See also

• Unit conversion: cds_unit_conversion

Show background image

: The non-animated elements of the referenced visualization are displayed as background images in order to optimize the performance of the visualization. Result: At runtime, the elements can be displayed in any order. : Deactivates the background display in order to prevent the behavior described above.

Element property ‘Referenced visualizations’

Referenced visualizations	Clicking Configure opens the Frame Configuration dialog box for selecting a visualization. Selected visualization references are listed here as subordinate properties.
Name pf the visualization reference (example: PLC_PRG.S1)
Heading	Tab caption (example: Panel)
Image ID	Image ID in the format <name of image pool>.<ID>, (example: image_pool.1 for the image with ID 1 in the image pool named image_pool)
Interface parameter of the visualization reference Example: iX	If the visualization has an interface, then their parameters are displayed here as subordinate properties. Variable (data type conforms to data type of the interface parameter). Includes the initialization value for the instantiation of the visualization.

See also

• Command ‘Interface Editor’
• Creating Structured Operating Interfaces

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 ( ) to other positions in the editor.

See also

• Positioning Elements, Adapting Size and Layer

Element property ‘Switch frame variable’

Variable

Variable (integer data type). Specifies the index of the active visualization. Example: PLC_PRG.uiActiveVisuID. Tip: The Frame Configuration dialog box includes a list of selected visualizations. The visualizations are ordered automatically in numeric order in the list.

See also

• Command ‘Frame selection’

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.