The slider object displays a numerical value on a linear scale, similar to a linear bargraph. The handle can be used to change the value by sliding it left and right / down and up.
Additionally, certain behavior can be configured to change the value by pressing a position on the scale.
The slider shares a lot of common properties with other objects. See here for a description. Here only the slider specific properties are described.
Axis Orientation
A slider can either be vertical or horizontal. Depending on this property the drawing of the slider itself and the value changes accordingly.
Default value: Horizontal
Possible values: Vertical or Horizontal
Number Of Ticks (Theme dependent)
As the name of this property implies, the number of the ticks that shall be drawn if Ticks are enabled through the Tick Position property, can be configured with this property.
The ticks are evenly positioned along the length of the slide.
Default value: 5
Possible values: 0 ... 32767
Tick Width (Theme dependent)
Define the width of the ticks that shall be drawn with this property. Only has an effect if Ticks are enabled through the Tick Position property.
Default value: black (0, 0, 0)
Possible values: any 24Bit RGB color
Tick Position (Theme dependent)
Define the position of the ticks. This property also acts as an enable for the drawing of ticks.
Default value: Ticks Off (no ticks)
Possible values:
Ticks Off (no ticks)
Bottom/Right (ticks on the bottom for horizontal, on the right for vertical sliders)
Top/Left (ticks on the top for horizontal, on the left for vertical sliders)
Both ((ticks on the top and bottom for horizontal, on the left and right for vertical sliders)
Tick Color (Theme dependent)
Define the color of the ticks that shall be drawn with this property. Only has an effect if Draw Ticks is enabled.
Default value: dark gray (102,102,102,255)
Possible values: any 24Bit RGB color
Snap To Tick (Theme dependent)
When enabled, the value of the slider will be set to the nearest tick value after the user has set a value.
Default value: Disabled
Possible values: Disabled or Enabled
Handle Width (Theme dependent)
The width of the slider handle in px.
Default value: 30
Possible values: 0 .. object width
Note that a value of 0 results in the handle not being drawn.
Handle Height (Theme dependent)
The height of the slider handle in px.
Default value: 30
Possible values: 0 .. object height
Note that a value of 0 results in the handle not being drawn.
Handle Color (Theme dependent)
Define the color of the handle that shall be drawn with this property.
Default value: dark gray (102,102,102,255)
Possible values: any 24Bit RGB color
Needle Image (Theme dependent)
A image can be set for the handle. It will be moved at the horizontal or vertical axis of the slider according to it's value.
Please note that there is a little different behavior for SVG images. If an SVG image shall be used as needle, it needs to have the same size as the bargraph and the needle has to be placed directly in the middle of the needle SVG image. The preview in the design tool will also be different to the look at runtime.
Default value: No image
Possible image: Any image from file system
Draw Slide (Theme dependent)
When enabled, the slide of the slider will be drawn.
Default value: Enabled
Possible values: Disabled or Enabled
Unfilled Slide Color (Theme dependent)
Define the color of the unfilled section of the slide (i.e. the part above the value that the object currently shows.
Default value: white (255,255,255,255)
Possible values: any 24Bit RGB color
Slide Width (Theme dependent)
The width of the slider slide in px.
Default value: 8
Possible values: 0 .. object height / width (depending on the axis orientation of the slider)
Note that a value of 0 results in the handle not being drawn.
Slide press behavior
This property defines what should happen if the user taps on the slider
Default value: Off
Possible values:
Off (nothing happens)
Handle/value is incremented/decremented by tick distance
Handle jumps to clicked value (this is influenced by Snap To Tick property, with that enabled the slider will be set to the nearest tick value.