Scale Settings
- 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.