Visualization Element: Round Slider

Symbol:

Category: Measurement Controls

A round slider is a control which allows a value to be set over a circular path. The visualization user moves a handle or knob along a circle or arc. The current value of the element is adjusted accordingly as the knob is pushed and moved along the arc scale of the slider.

Element properties

Are all element properties available?

All properties are available only after you select the Advanced option or the All categories filter in Properties.

Element name	`GenElemInst_5` Name assignment Assign individual names for elements so that they are found faster in the element list.
Type of element	Round Slider

Position

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

X	The X-coordinate (in pixels) of the upper left corner of the element Example: `10`
Y	The Y-coordinate (in pixels) of the upper left corner of the element Example: `10`
Width	Specified in pixels Example: `150`
Height	Specified in pixels Example: `30`

Tip

You can change the values by dragging the box symbols to other positions in the editor.

Value

Variable	Variable (numeric data type) Example: `PLC_PRG.iRoundSlider` When executed, the variable value contains the position where the user has moved the slider.
Value Format	Text with placeholder and format specification for displaying the current variable value Example: `%d`, `Value: %d`
Position	Sets the position in the interior area of the element for the text defined in the Value Format property Top Center Bottom
Font	Font for text output Example: Default : List box with style fonts : The Font dialog opens.
Font color	Font color for text output Example: Black : List box with style colors : The Color dialog opens.

Arc

Arc scale of the rotary control

Use gradient color	: The element is drawn with a color gradient. The setting in the Arc color property is ignored.
Gradient setting	Clicking on the row will open the gradient editor for color configuration.
Arc color	Sets the color of the currently selected area. This setting is not used if the Use gradient color option has been enabled. List box with style colors The color dialog opens. Example: Black
Transparency	Specifies the transparency value in the range from 0 (fully transparent) to 255 (opaque) and as a result determines the transparency of the respective color. Read-only transparency The property is read-only when the color is a style color with a predefined transparency value.
Arc background color	Background color which is displayed List box with style colors The color dialog opens.
Transparency	Specifies the transparency value in the range from 0 (fully transparent) to 255 (opaque) and as a result determines the transparency of the respective color. Read-only transparency The property is read-only when the color is a style color with a predefined transparency value.
Arc width	Fixed value for arc width (in pixels) Example: `20` To make the display more dynamic, you can specify a variable instead of a fixed value. To do this, double-click in the value field. Then the symbol will be displayed. Clicking it will reveal the Variable property on a separate line directly below it.
Variable	Variable for arc width To change the property programmatically at runtime, you can specify a variable. In this case, a value specified in the property above will not have any effect. Clicking the symbol will provide help with the input. After double-clicking in the field, the symbol will be displayed. Clicking the symbol will remove this element property which is responsible for dynamic display.
Arc ending	Round Rectangle
Value start	Fixed start value of the arc scale Example: `0` To make the display more dynamic, you can specify a variable instead of a fixed value. To do this, double-click in the value field. Then the symbol will be displayed. Clicking it will reveal the Variable property on a separate line directly below it.
Variable	Variable (optional) for the start value To change the property programmatically at runtime, you can specify a variable. In this case, a value specified in the property above will not have any effect. Clicking the symbol will provide help with the input. After double-clicking in the field, the symbol will be displayed. Clicking the symbol will remove this element property which is responsible for dynamic display.
Value end	Fixed end value of the arc scale Example: `100` To make the display more dynamic, you can specify a variable instead of a fixed value. To do this, double-click in the value field. Then the symbol will be displayed. Clicking it will reveal the Variable property on a separate line directly below it.
Variable	Variable (optional) for the end value To change the property programmatically at runtime, you can specify a variable. In this case, a value specified in the property above will not have any effect. Clicking the symbol will provide help with the input. After double-clicking in the field, the symbol will be displayed. Clicking the symbol will remove this element property which is responsible for dynamic display.
Start angle	Fixed value for the start angle (in degrees) The start angle defines the position on the circle where the arc scale of the rotary control begins. The angle (in degrees) is measured clockwise from the positive X-axis (3 o'clock) and determines the visual starting point of the control. Possible values are in the range 0–359. Example: `135` To make the display more dynamic, you can specify a variable instead of a fixed value. To do this, double-click in the value field. Then the symbol will be displayed. Clicking it will reveal the Variable property on a separate line directly below it.
Variable	Variable (optional) for the start angle To change the property programmatically at runtime, you can specify a variable. In this case, a value specified in the property above will not have any effect. Clicking the symbol will provide help with the input. After double-clicking in the field, the symbol will be displayed. Clicking the symbol will remove this element property which is responsible for dynamic display.
Rotation angle	Fixed value for the rotation angle The value indicates the angular range of the rotary control in a clockwise direction, starting from the defined start angle. A larger swivel angle increases the rotation range around the circle. Valid values are in the range 0–359. Example: `270` To make the display more dynamic, you can specify a variable instead of a fixed value. To do this, double-click in the value field. Then the symbol will be displayed. Clicking it will reveal the Variable property on a separate line directly below it.
Variable	Variable (optional) for the rotation angle To change the property programmatically at runtime, you can specify a variable. In this case, a value specified in the property above will not have any effect. Clicking the symbol will provide help with the input. After double-clicking in the field, the symbol will be displayed. Clicking the symbol will remove this element property which is responsible for dynamic display.

Unit

Show	: The unit of the value is displayed on the element.
Text	Text for the unit Example: `m`
Font	: List box with style fonts Example: Element-RoundSlider-UnitFont : The Font dialog opens. Here you can specify a font in detail.
Font color	: List box with style colors Example: Gray : The Color dialog opens. Here you can specify a color in detail.

Slider knob

Show	: The slider knob is displayed on the arc scale.
Fill color	: List box with style colors Example: Element-RoundSlider_SliderFillcolor : The Color dialog opens. Here you can specify a color in detail.
Transparency	Specifies the transparency value in the range from 0 (fully transparent) to 255 (opaque) and as a result determines the transparency of the respective color. Read-only transparency The property is read-only when the color is a style color with a predefined transparency value.

Description

Show	: Displays the description of the element.
Position	Top Center Bottom
Text	Text which is display on the element and describes the purpose, for example Example: `Fill level 1`
Font	List box with style fonts Example: Element-RoundSlider-DescriptionFont The Font dialog opens. Here you can specify a font in detail.
Font color	List box with style colors Example: Gray The Color dialog opens. Here you can specify a color in detail.

Image

Position

Top
Center
Bottom

Size

Image size (in pixels)

Example: 30

Static ID

References an image from the image pool

<image pool>.<ID>
Double-clicking in the value field will open the line editor. Clicking the symbol will provide help when selecting an image from the image pool.

Center

The properties contain fixed values for the coordinates of the point of rotation. The rotation point is displayed in the editor as the symbol and is used as the center for rotation and scaling.

Tip

You can also change the values by dragging the symbol to another position in the editor.

Editable X-coordinate of the point of rotation

Double-clicking in the value field will open the line editor.

Editable Y-coordinate of the point of rotation

Double-clicking in the value field will open the line editor.

Absolute movement

The properties contain IEC variables for controlling the position of the element dynamically. The reference point is the upper left corner of the element. At runtime, the entire element is moved.

Movement
X	Variable (numeric data type) for the X-position (in pixels) Example: `PLC_PRG.iPos_X`. Container variable: `Container.Width` For more information, see the following: Optimally Adjusting the Position and Size Increasing this value at runtime moves the element to the right.
Y	Variable (numeric data type) for the Y-position (in pixels) Example: `PLC_PRG.iPos_Y`. Container variable: `Container.Height` For more information, see the following: Optimally Adjusting the Position and Size Increasing this value at runtime moves the element downwards.
Rotation	Variable (numeric data type) for the angle of rotation (in degrees) Example: `PLC_PRG.iAngle1`. The midpoint of the element rotates at the Center point. This rotation point is shown as the symbol. At runtime, the alignment of the element remains the same with respect to the coordinate system of the visualization. Increasing the value rotates the element to the right.
Scaling	Variable (integer data type) to trigger a centric stretching Example: `PLC_PRG.iScaling` The reference point is the Center property. The value `1` shrinks the element by a factor of `0.001`. The value `1000` returns the element to its original size.
Interior rotation	Variable (numeric data type) for the angle of rotation (in degrees) Example: `PLC_PRG.iAngle2`. At runtime, the element rotates about the point of rotation specified in Center according to the value of the variable. In addition, the alignment of the element rotates according to the coordinate system of the visualization. Increasing the value in the code rotates clockwise. The rotation point is shown as the symbol. Note If a static angle of rotation is specified in the Position → Angle property, then the static angle of rotation is added to the variable angle of rotation (offset) when the visualization is executed.

Tip

You can combine the variables to a Unit conversion.

Tip

The X, Y, Rotation, and Interior rotation properties are supported by the "Client Animation" functionality.

Animation

Tip

These properties are available only when you have selected the Support client animations and overlay of native elements option in the Visualization Manager.

Animation duration

Variable for the duration (in milliseconds) in which the element runs an animation

Variable (integer value)
Example: Menu.tContent with VAR tContent : INT := 500; END_VAR
Integer literal
Example: 500

. Animatable properties

Absolute movement, Movement, X, Y
Absolute movement, Rotation
Absolute movement, Interior rotation
Absolute movement, Exterior rotation

The animated movement is executed when at least one value of an animatable property has changed. The movement then executed is not jerky, but is smooth within the specified animation duration. The visualization element travels to the specified position while rotating dynamically. The transitions are smooth.

Move to foreground

Variable (BOOL) for setting the element in the foreground

TRUE: At runtime, the visualization element is displayed in the foreground.

FALSE: At runtime, the visualization element is displayed in the layer where it was inserted in the visualization editor.

Example: bIsInForeground with VAR bIsInForeground : BOOL := FALSE; END_VAR

State variables

The variables control the element behavior dynamically.

Invisible

Variable (BOOL) for toggling the visibility of the element

TRUE: The element is not visible at runtime.

Example: bIsVisible with VAR bIsVisible : BOOL := FALSE; END_VAR

Deactivate inputs

Variable (BOOL) for toggling the operability of the element

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

Tip

The Invisible property is supported by the "Client Animation" functionality.

Permissions

Note

Available only when a user management is set up for visualization.

Access Rights button

Opens the Access Rights dialog. There you can edit the access privileges for the element.

. Status messages:

Not set. Full rights.: Access rights for all user groups : operable
Rights are set: Limited rights: Access is restricted for at least one group.

In this section:

Visualization Element: Round Slider

Element properties

Are all element properties available?

Name assignment

Position

Tip

Value

Arc

Read-only transparency

Read-only transparency

Unit

Slider knob

Read-only transparency

Description

Image

Center

Tip

Absolute movement

Note

Tip

Tip

Animation

Tip

State variables

Tip

Permissions

Note

Search results