Properties

Updated over 6 months ago

Property	Description
TrackBarElement	Gets the instance of RadTrackBarElement wrapped by this control. RadTrackBarElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadTrackBar.
Minimum and Maximum	Specify the lower end and upper end of the range which thumbs can scroll over. It is possible to specify a negative value for the Minimum.
Value	Gets or sets the value of the thumb in SingleThumb mode of RadTrackBar
TickStyle	Controls whether the tick marks are drawn on one or both sides of the control. The default value is Both. Setting TickStyle to None will disable the ticks. Setting TickStyle to Both will enable ticks on both sides. Setting TickStyle to TopLeft will show only the ticks on the top side, when the Orientation is Horizontal. If the Orientation is set to Vertical, only the ticks on the left side will be shown. Setting TickStyle to BottomRight will show only the ticks on the down side, when the Orientation is Horizontal. If the Orientation is set to Vertical, only the ticks on the right side will be shown.
Orientation	Gets or Sets the orientation of the RadTrackBar.
LargeChange	Gets or sets the change in value that one click of the mouse outside of the slider makes. Let's say that the position of your thumb is at the beginning of the RadTrackBar (at position 0), the value of this property is 5 and you click on tick number 14. The thumb will reposition itself to tick number 5, following the step determined by the LargeChange property. However, if the LargeChange has value 0, the thumb will move to position 14.
SmallChange	Gets or Sets the number of positions that the trackbar moves in response to keyboard arrow keys and the trackbar buttons.
TextOrientation	Gets or Sets the orientation of the text associated with TrackBar. Whether it should appear horizontal or vertical.
LabelStyle	Gets or Sets whether the RadTrackBar's labels should be drawn.The default value is None. TopLeft value will show only the labels on the top side, when the Orientation is Horizontal. If the Orientation is set to Vertical, only the labels on the left side will be shown. BottomRight value will show only the labels on the bottom side, when the Orientation is Horizontal. If the Orientation is set to Vertical, only the labels on the right side will be shown. BottomRight - will show only the labels on the bottom side, when the Orientation is Horizontal. If the Orientation is set to Vertical, only the labels on the right side will be shown.
ShowButtons	Controls the visibility of the navigation buttons in RadTrackBar. By default these buttons are not displayed. To show them, set the property to true.
LargeTickFrequency	Sets the spacing between the large tick marks. The default value is 5.
SmallTickFrequency	Sets the spacing between the small tick marks. The default value is 1.
TrackBarMode	Determinates in which mode the control will operate. Each WinForms RadTrackBar mode has different functionality and behavior.
Ranges	Gets the TrackBarRangeCollection.
SnapMode	Controls the way the thumb is moving in RadTrackBar. When this property is set to SnapToTicks the thumb is moving only at tick positions. When the value is set to None the slider is moving freely.
ThumbSize	Gets or Sets TrackBar's Size.
ShowSlideArea	Controls whether the line down the middle of the control where the slider rides is drawn. The default value is true.

As of R3 2019 SP1 RadTrackBar offers the SnapFrequency property. Its default value is TrackBarSnapFrequency.Default in order to keep the existing behavior unchanged. The other possible value is TrackBarSnapFrequency.Ticks aiming to provide snap-to-ticks behavior if the SnapMode property is set to SnapToTicks. Thus, you can slide the thumb smoothly snapping to the small/large ticks.

Events

Event	Description
ValueChanged	Occurs after the user drags the thumb and drops it somewhere on the slider area, or when the Value property is set. In this event, you can get the value of RadTrackBar from its Value property.
LabelFormatting	Occurs when a Label needs to be formatted.
TickFormatting	Occurs when a Tick needs to be formatted.

Formatting ticks

C#

void radTrackBar1_TickFormatting(object sender, TickFormattingEventArgs e)
{
    e.TickElement.Line1.BackColor = Color.Red;
}

VB.NET

Private Sub radTrackBar1_TickFormatting(sender As Object, e As TickFormattingEventArgs)
    e.TickElement.Line1.BackColor = Color.Red
End Sub

Formatting labels

C#

void radTrackBar1_LabelFormatting(object sender, LabelFormattingEventArgs e)
{
    e.LabelElement.ForeColor = Color.Red;
}

VB.NET

Private Sub radTrackBar1_LabelFormatting(sender As Object, e As LabelFormattingEventArgs)
    e.LabelElement.ForeColor = Color.Red
End Sub

See Also

• Properties
• Methods
• Events