Class RadSlider

Slider control lets the user select from a range of values by moving a slider. Slider is used to enable to user to gradually modify a value (range selection). Slider is an easy and natural interface for users, because it provides good visual feedback.

Inheritance
System.Object
DoubleRangeBase
RadSlider
PanZoomBar
TimelineScrollBar
Inherited Members
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.dll

Syntax

[TelerikToolboxCategory("Input")]
[Themable]
public class RadSlider : DoubleRangeBase, IRangeSelector<double>, ISupportInitialize, IThemable

Constructors

RadSlider()

Initializes a new instance of the RadSlider class.

Declaration
public RadSlider()

Fields

ActiveThumbProperty

Identifies the ActiveThumb dependency property.

Declaration
public static readonly DependencyProperty ActiveThumbProperty
Field Value
System.Windows.DependencyProperty

AlternateThumbStyleProperty

Identifies the AlternateThumbStyle dependency property.

Declaration
public static readonly DependencyProperty AlternateThumbStyleProperty
Field Value
System.Windows.DependencyProperty

AutoToolTipContentTemplateProperty

Identifies the AutoToolTipTemplate dependency property.

Declaration
public static readonly DependencyProperty AutoToolTipContentTemplateProperty
Field Value
System.Windows.DependencyProperty

AutoToolTipPlacementProperty

Identifies the AutoToolTipPlacement dependency property.

Declaration
public static readonly DependencyProperty AutoToolTipPlacementProperty
Field Value
System.Windows.DependencyProperty

DecreaseHandleStyleProperty

Identifies the HandleStyle dependency property.

Declaration
public static readonly DependencyProperty DecreaseHandleStyleProperty
Field Value
System.Windows.DependencyProperty

DelayProperty

Identifies the Delay dependency property.

Declaration
public static readonly DependencyProperty DelayProperty
Field Value
System.Windows.DependencyProperty

EnableSideTicksProperty

Identifies the EnableSideTicks dependency property.

Declaration
public static readonly DependencyProperty EnableSideTicksProperty
Field Value
System.Windows.DependencyProperty

HandlesVisibilityProperty

Identifies the HandlesVisibility dependency property.

Declaration
public static readonly DependencyProperty HandlesVisibilityProperty
Field Value
System.Windows.DependencyProperty

IncreaseHandleStyleProperty

Identifies the HandleStyle dependency property.

Declaration
public static readonly DependencyProperty IncreaseHandleStyleProperty
Field Value
System.Windows.DependencyProperty

IsDeferredDraggingEnabledProperty

Identifies the IsDeferredDraggingEnabled dependency property.

Declaration
public static readonly DependencyProperty IsDeferredDraggingEnabledProperty
Field Value
System.Windows.DependencyProperty

IsDirectionReversedProperty

Identifies the IsDirectionReversed dependency property.

Declaration
public static readonly DependencyProperty IsDirectionReversedProperty
Field Value
System.Windows.DependencyProperty

IsMouseWheelEnabledProperty

Identifies the IsMouseWheelEnabled dependency property.

Declaration
public static readonly DependencyProperty IsMouseWheelEnabledProperty
Field Value
System.Windows.DependencyProperty

IsMoveToPointEnabledProperty

Identifies the IsMoveToPointEnabled dependency property.

Declaration
public static readonly DependencyProperty IsMoveToPointEnabledProperty
Field Value
System.Windows.DependencyProperty

IsSnapToTickEnabledProperty

Identifies the IsSnapToTickEnabled dependency property.

Declaration
public static readonly DependencyProperty IsSnapToTickEnabledProperty
Field Value
System.Windows.DependencyProperty

MiddleThumbClickModeProperty

Identifies the MiddleThumbClickMode dependency property.

Declaration
public static readonly DependencyProperty MiddleThumbClickModeProperty
Field Value
System.Windows.DependencyProperty

OrientationProperty

Identifies the Orientation dependency property.

Declaration
public static readonly DependencyProperty OrientationProperty
Field Value
System.Windows.DependencyProperty

RepeatIntervalProperty

Identifies the RepeatInterval dependency property.

Declaration
public static readonly DependencyProperty RepeatIntervalProperty
Field Value
System.Windows.DependencyProperty

ResultTicksProperty

Identifies the Ticks dependency property.

Declaration
public static readonly DependencyProperty ResultTicksProperty
Field Value
System.Windows.DependencyProperty

SelectionMiddleThumbStyleProperty

Identifies the SelectionMiddleThumbStyleProperty dependency property.

Declaration
public static readonly DependencyProperty SelectionMiddleThumbStyleProperty
Field Value
System.Windows.DependencyProperty

StepActionProperty

Identifies the StepAction dependency property.

Declaration
public static readonly DependencyProperty StepActionProperty
Field Value
System.Windows.DependencyProperty

ThumbStyleProperty

Identifies the ThumbStyle dependency property.

Declaration
public static readonly DependencyProperty ThumbStyleProperty
Field Value
System.Windows.DependencyProperty

ThumbToolTipStyleProperty

Identifies the ThumbToolTipStyle dependency property.

Declaration
public static readonly DependencyProperty ThumbToolTipStyleProperty
Field Value
System.Windows.DependencyProperty

ThumbVisibilityProperty

Identifies the ThumbVisibility dependency property.

Declaration
public static readonly DependencyProperty ThumbVisibilityProperty
Field Value
System.Windows.DependencyProperty

TickBarStyleProperty

Identifies the TickBarStyle dependency property.

Declaration
public static readonly DependencyProperty TickBarStyleProperty
Field Value
System.Windows.DependencyProperty

TickFrequencyProperty

Identifies the TickFrequency dependency property.

Declaration
public static readonly DependencyProperty TickFrequencyProperty
Field Value
System.Windows.DependencyProperty

TickPlacementProperty

Identifies the TickPlacement dependency property.

Declaration
public static readonly DependencyProperty TickPlacementProperty
Field Value
System.Windows.DependencyProperty

TicksProperty

Identifies the Ticks dependency property.

Declaration
public static readonly DependencyProperty TicksProperty
Field Value
System.Windows.DependencyProperty

TickTemplateProperty

Identifies the TickTemplate dependency property.

Declaration
public static readonly DependencyProperty TickTemplateProperty
Field Value
System.Windows.DependencyProperty

TickTemplateSelectorProperty

Identifies the TickTemplateSelector dependency property.

Declaration
public static readonly DependencyProperty TickTemplateSelectorProperty
Field Value
System.Windows.DependencyProperty

TrackStyleProperty

Identifies the TrackStyle dependency property.

Declaration
public static readonly DependencyProperty TrackStyleProperty
Field Value
System.Windows.DependencyProperty

Properties

ActiveThumb

Gets or sets the thumb from slider thumbs, that is active at the moment.

Declaration
public SliderThumbBase ActiveThumb { get; set; }
Property Value
SliderThumbBase

AlternateThumbStyle

Gets or sets the style for the right Thumb used internally by the slider, in case of SelectionRangeEnabled is True.

Declaration
public Style AlternateThumbStyle { get; set; }
Property Value
System.Windows.Style

AutoToolTipContentTemplate

Gets or sets the template used to display the content of the RadSlider's tooltip.

Declaration
public DataTemplate AutoToolTipContentTemplate { get; set; }
Property Value
System.Windows.DataTemplate

AutoToolTipPlacement

Gets or sets whether a tooltip that contains the current value of the RadSlider displays when the Thumb is pressed. If a tooltip is displayed, this property also specifies the placement of the tooltip.

Declaration
public AutoToolTipPlacement AutoToolTipPlacement { get; set; }
Property Value
AutoToolTipPlacement

DecreaseHandleStyle

Gets or sets the style for the Decrease Repeat button used internally by the slider.

Declaration
public Style DecreaseHandleStyle { get; set; }
Property Value
System.Windows.Style

Delay

Gets or sets the Delay property of the Increase and Decrease handles.

Declaration
public int Delay { get; set; }
Property Value
System.Int32

Remarks

Each click on any of the handles increases/decreases the value by the amount that is set to the System.Windows.Controls.Primitives.RangeBase.SmallChange property.

EnableSideTicks

Gets or sets a value indicating whether side ticks are enabled.

Declaration
public bool EnableSideTicks { get; set; }
Property Value
System.Boolean

True if side ticks are enabled; otherwise, false.

HandlesVisibility

Gets or sets the Visibility property of the Increase and Decrease handles.

Declaration
public Visibility HandlesVisibility { get; set; }
Property Value
System.Windows.Visibility

Remarks

Each click on any of the handles increases/decreases the value by the amount that is set to the System.Windows.Controls.Primitives.RangeBase.SmallChange property.

IncreaseHandleStyle

Gets or sets the style for the Increase Repeat button used internally by the slider.

Declaration
public Style IncreaseHandleStyle { get; set; }
Property Value
System.Windows.Style

IsDeferredDraggingEnabled

Gets or sets a value that indicates whether the content is stationary when the user drags the Thumb of RadSlider. This is dependency property.

Declaration
public bool IsDeferredDraggingEnabled { get; set; }
Property Value
System.Boolean

IsDirectionReversed

Gets or sets the direction of increasing value. This is a dependency property.

Declaration
public bool IsDirectionReversed { get; set; }
Property Value
System.Boolean

Remarks

The value of this property determines the direction of increasing value of a RadRadSlider.

For example, when you move the thumb control up on a vertical RadSlider when the IsDirectionReversed property is set to false, the Value of the RadSlider increases. If the value of the IsDirectionReversed property is changed to true, the System.Windows.Controls.Primitives.RangeBase.Value of the RadSlider decreases as the thumb moves up.

IsMouseWheelEnabled

Gets or sets whether the wheel of the mouse can be used for sliding the thumb. This is dependency property.

Declaration
public bool IsMouseWheelEnabled { get; set; }
Property Value
System.Boolean

IsMoveToPointEnabled

Gets or sets a value that indicates whether the thumb of a RadSlider moves immediately to the location of the mouse click that occurs while the mouse pointer pauses on the RadSlider track. This is a dependency property.

Declaration
public bool IsMoveToPointEnabled { get; set; }
Property Value
System.Boolean

Remarks

When this property is set to false and a mouse click occurs along the RadSlider away from the thumb, the thumb moves in the direction of the mouse click. Instead of moving immediately to the mouse click location, the thumb moves a distance that is defined by the RepeatInterval property for each mouse click. The effect of multiple mouse clicks can be emulated by pressing and holding the left mouse button until the thumb is repositioned to the desired location.

IsSnapToTickEnabled

Gets or sets a value that indicates whether the RadSlider automatically moves the thumb to the closest tick mark. This is a dependency property.

Declaration
public bool IsSnapToTickEnabled { get; set; }
Property Value
System.Boolean

MiddleThumbClickMode

Gets or sets a value that determines the click action of the Middle Thumb of RadSlider. This is dependency property.

Declaration
public MiddleThumbClickMode MiddleThumbClickMode { get; set; }
Property Value
MiddleThumbClickMode

Remarks

The MiddleThumbClickMode actions will take effect only in there is no drag action of the middle thumb. If the middle thumb is dragged, then no click mode action will be performed.

Orientation

Gets or sets the orientation of a RadSlider. This is a dependency property.

Declaration
public Orientation Orientation { get; set; }
Property Value
System.Windows.Controls.Orientation

RepeatInterval

Gets or sets the RepeatInterval property of the Increase and Decrease handles.

Declaration
public int RepeatInterval { get; set; }
Property Value
System.Int32

Remarks

Each click on any of the handles increases/decreases the value by the amount that is set to the System.Windows.Controls.Primitives.RangeBase.SmallChange property.

ResultTicks

Gets or sets the style for the border track used internally by the slider.

Declaration
public ObservableCollection<double> ResultTicks { get; }
Property Value
System.Collections.ObjectModel.ObservableCollection<System.Double>

SelectionMiddleThumbStyle

Gets or sets the style for the middle Thumb used internally by the slider, in case of SelectionRangeEnabled is True.

Declaration
public Style SelectionMiddleThumbStyle { get; set; }
Property Value
System.Windows.Style

StepAction

This property determines how the slider will behave when in range mode. Setting this property to ChangeRange will move only the corresponding thumb when Large or Small step is performed. Setting the property to MoveRange will move the whole range when Large or Small change has been performed.

Declaration
public StepAction StepAction { get; set; }
Property Value
StepAction

Thumbs

Gets the collection that contains all the thumbs in the control.

Declaration
public ObservableCollection<SliderThumbBase> Thumbs { get; }
Property Value
System.Collections.ObjectModel.ObservableCollection<SliderThumbBase>

ThumbStyle

Gets or sets the style for the Thumbs used internally by the slider.

Declaration
public Style ThumbStyle { get; set; }
Property Value
System.Windows.Style

ThumbToolTipStyle

Gets or sets the style for the ToolTip of the Thumb used internally by the slider.

Declaration
public Style ThumbToolTipStyle { get; set; }
Property Value
System.Windows.Style

Remarks

The AutoToolTipPlacement property controls the Thumb ToolTip of the RadSlider.

ThumbVisibility

Gets or sets the visibility of the thumb(s) in RadSlider.

Declaration
public Visibility ThumbVisibility { get; set; }
Property Value
System.Windows.Visibility

TickBarStyle

Gets or sets the style for the RadTickBar used internally by the slider.

Declaration
public Style TickBarStyle { get; set; }
Property Value
System.Windows.Style

TickFrequency

Gets or sets the interval between tick marks. This is a dependency property.

Declaration
public double TickFrequency { get; set; }
Property Value
System.Double

TickPlacement

Gets or sets the position of tick marks with respect to the track of the RadSlider. This is a dependency property.

Declaration
public TickPlacement TickPlacement { get; set; }
Property Value
TickPlacement

Ticks

Gets or sets the positions of the tick marks to display for a RadSlider. This is a dependency property.

Declaration
public DoubleCollection Ticks { get; set; }
Property Value
System.Windows.Media.DoubleCollection

TickTemplate

Gets or sets the TickTemplate that will be used to represent a single tick on the TickBar.

Declaration
public DataTemplate TickTemplate { get; set; }
Property Value
System.Windows.DataTemplate

TickTemplateSelector

Gets or sets the TickTemplateSelector that will be used to pick a template for the tick marks.

Declaration
public DataTemplateSelector TickTemplateSelector { get; set; }
Property Value
System.Windows.Controls.DataTemplateSelector

TrackStyle

Gets or sets the style for the track used internally by the slider.

Declaration
public Style TrackStyle { get; set; }
Property Value
System.Windows.Style

Methods

BeginInit()

Declaration
public override void BeginInit()

ChangeVisualState()

Changes the visual state of the control.

Declaration
protected virtual void ChangeVisualState()

ChangeVisualState(Boolean)

Changes the visual state of the control.

Declaration
protected virtual void ChangeVisualState(bool useTransitions)
Parameters
System.Boolean useTransitions

EndInit()

Declaration
public override void EndInit()

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate.

Declaration
public override void OnApplyTemplate()
Overrides

OnCreateAutomationPeer()

Creates new SliderAutomationPeer when needed.

Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
System.Windows.Automation.Peers.AutomationPeer

OnInitialized(EventArgs)

Raises the System.Windows.FrameworkElement.Initialized event. This method is invoked whenever System.Windows.FrameworkElement.IsInitialized is set to true internally.

Declaration
protected override void OnInitialized(EventArgs e)
Parameters
System.EventArgs e

The System.Windows.RoutedEventArgs that contains the event data.
Overrides

OnIsFocusedChanged()

Called when the is focused changes.

Declaration
protected virtual void OnIsFocusedChanged()

OnIsSelectionRangeEnabledChanged()

Called when the IsSelectionRangeEnabled property changes value.

Declaration
protected override void OnIsSelectionRangeEnabledChanged()
Overrides

OnKeyDown(KeyEventArgs)

Declaration
protected override void OnKeyDown(KeyEventArgs e)
Parameters
System.Windows.Input.KeyEventArgs e

OnMaximumChanged(Double, Double)

Called when the Maximum property changes.

Declaration
protected override void OnMaximumChanged(double oldMaximum, double newMaximum)
Parameters
System.Double oldMaximum

Old value of the Maximum property.
System.Double newMaximum

New value of the Maximum property.
Overrides

OnMaximumRangeSpanChanged(Double, Double)

Called when MaximumRangeSpanChanged event occurs.

Declaration
protected override void OnMaximumRangeSpanChanged(double oldValue, double newValue)
Parameters
System.Double oldValue

The old value.
System.Double newValue

The new value.
Overrides

OnMinimumChanged(Double, Double)

Called when the Minimum property changes.

Declaration
protected override void OnMinimumChanged(double oldMinimum, double newMinimum)
Parameters
System.Double oldMinimum

Old value of the Minimum property.
System.Double newMinimum

New value of the Minimum property.
Overrides

OnMinimumRangeSpanChanged(Double, Double)

Called when MinimumRangeSpanChanged event occurs.

Declaration
protected override void OnMinimumRangeSpanChanged(double oldValue, double newValue)
Parameters
System.Double oldValue

The old value.
System.Double newValue

The new value.
Overrides

OnMouseWheel(MouseWheelEventArgs)

Invoked when an unhandled System.Windows.Input.Mouse.MouseWheel attached event reaches an element in its route that is derived from this class. Implement this method to add class handling for this event.

Declaration
protected override void OnMouseWheel(MouseWheelEventArgs e)
Parameters
System.Windows.Input.MouseWheelEventArgs e

The System.Windows.Input.MouseWheelEventArgs that contains the event data.

OnOrientationChanged()

Called when the Orientation property changes value.

Declaration
protected virtual void OnOrientationChanged()

OnSelectionEndChanged(Double, Double)

Called when SelectionEnd changes value.

Declaration
protected override void OnSelectionEndChanged(double oldValue, double newValue)
Parameters
System.Double oldValue

The old value.
System.Double newValue

The new value.
Overrides

OnSelectionStartChanged(Double, Double)

Called when SelectionStart changes value.

Declaration
protected override void OnSelectionStartChanged(double oldValue, double newValue)
Parameters
System.Double oldValue

The old value.
System.Double newValue

The new value.
Overrides

OnValueChanged(Double, Double)

Called when the Value property changes.

Declaration
protected override void OnValueChanged(double oldValue, double newValue)
Parameters
System.Double oldValue

Old value of the Value property.
System.Double newValue

New value of the Value property.

ResetTheme()

Resets the theme.

Declaration
public void ResetTheme()

UpdateTrackLayout()

This method will take the current min, max, and value to calculate and layout the current control measurements.

Declaration
protected virtual void UpdateTrackLayout()

Events

DragCompleted

Occurs when the Thumb control loses mouse capture.

Declaration
public event EventHandler<RadDragCompletedEventArgs> DragCompleted
Event Type
System.EventHandler<RadDragCompletedEventArgs>

DragDelta

Occurs when the mouse moves while the thumb is still on focus.

Declaration
public event EventHandler<RadDragDeltaEventArgs> DragDelta
Event Type
System.EventHandler<RadDragDeltaEventArgs>

DragStarted

Occurs when a thumb starts dragging.

Declaration
public event EventHandler<RadDragStartedEventArgs> DragStarted
Event Type
System.EventHandler<RadDragStartedEventArgs>

Extension Methods