Scale Settings

Dec 17, 2020
2 minutes to read

TrackBar supports full scale customization. You can customize value selection look-and-feel, the scale layout and appearance.

Value Selection Look-And-Feel

Value selection look-and-feel scale settings include:

TrackBarSettings.Properties .MinValue (TrackBarProperties.MinValue) and TrackBarSettings.Properties .MaxValue (TrackBarProperties.MaxValue). Limit a value span visualized by the scale.
TrackBarSettings.Properties .LargeTickInterval (TrackBarProperties.LargeTickInterval). Specifies the large ticks placing interval.
TrackBarSettings.Properties .SmallTickFrequency (TrackBarProperties.SmallTickFrequency). Defines how frequently small ticks should fill a single interval between large ticks.
TrackBarSettings.Properties .LargeTickStartValue (TrackBarProperties.LargeTickStartValue) and TrackBarSettings.Properties .LargeTickEndValue (TrackBarProperties.LargeTickEndValue). Define the span where large tick marks should be placed.

The table below demonstrates how different properties affect scale appearance.

Scale View

Affected Properties

| | --- | --- | |

MinValue = 0

MaxValue = 50

LargeTickStartValue = 0

LargeTickEndValue = 50

SmallTickFrequency = 5

LargeTickInterval = 10

| |

MinValue = 0

MaxValue = 50

LargeTickStartValue = 5

LargeTickEndValue = 45

SmallTickFrequency = 5

LargeTickInterval = 10

| |

MinValue = 0

MaxValue = 11

LargeTickStartValue = 0.5

LargeTickEndValue = 10.5

SmallTickFrequency = 1

LargeTickInterval = 2

| |

MinValue = -10

MaxValue = 30

LargeTickStartValue = 0

LargeTickEndValue = 30

SmallTickFrequency = 8

LargeTickInterval = 10

The TrackBarSettings.Properties .Step (TrackBarProperties.Step) property defines the minimal value (increment/decrement) by which end-users can change the drag handle position.

Scale Layout And Appearance

TrackBar supports scale layout customization. Here are the properties that affect it:

TrackBarSettings.Properties .ScalePosition (TrackBarProperties.ScalePosition). Specifies where the scale is displayed: on one or both sides along the track.
TrackBarSettings.Properties .ScaleLabelHighlightMode (TrackBarProperties.ScaleLabelHighlightMode). Allows you to define how the scale labels should be highlighted.
TrackBarSettings.Properties .ValueToolTipPosition (TrackBarProperties.ValueToolTipPosition). Defines the place where a value tooltip will appear when an end-user changes the drag handle position.

The table below demonstrates how different properties affect a scale layout.

Scale Layout

Affected Properties

| | --- | --- | |

ScaleLabelHighLightMode = AlongBarHighLight

ValueToolTipPosition = RightOrBottom

ScalePosition = LeftOrTop

| |

ScaleLabelHighLightMode = HandlePosition

ValueToolTipPosition = LeftOrTop

ScalePosition = Both

| |

ScaleLabelHighLightMode = None

ValueToolTipPosition = None

ScalePosition = RightOrBottom

Note that the scale style can be flexibly customized with the TrackBarSettings.Properties .ScaleStyle (TrackBarProperties.ScaleStyle) property.