Visualization Element ‘Group box’

Symbol:

Tag: Common controls

This element provides visual grouping of visualization elements. The group box can be nested many times.

Note

You can add elements by dragging to the group box. The appearance of the cursor changes (a small plus sign is shown). When you click the Shift key at the same time, the element is not added.

You can remove elements from the group box by dragging them out of the group box.

Element properties

Element name	Optional Tip: Assign individual names for elements so that they are found faster in the element list. Example: Parameter_Axis_1
Element type	Group box
Clipping	: Elements are clipped that protrude beyond the size of the group box.

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 ‘Texts’

The properties contains character strings for labeling the element.

CODESYS accepts the specified texts automatically into the GlobalTextList text list. Therefore, these texts can be localized.

Text	Character string (without single straight quotation marks) for the labeling the element. Example: Axis 1.
Tooltip	Character string (without single straight quotation marks) that is displayed as the tooltip of an element. Example: Parameters of Axis 1.

See also

• Designing Visualizations with Elements

Element property ‘Text properties’

The properties contain fixed values for the text properties.

Font	Example: Default : The Font dialog box opens. : Drop-down list with style fonts.
Font color	Example: Black : The Color dialog box opens. : Drop-down list with style colors.
Transparency	Whole number (value range from 0 to 255). This determines the transparency of the respective color. Example: 255: The color is opaque. 0: The color is completely transparent. Please note: If the color is a style color and already has a transparency value, then this property is write-protected.

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.

See also

• Designing Visualizations with Elements