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.
Inherited Members
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.dll
Syntax
[TelerikToolboxCategory("Input")]
public class RadSlider : DoubleRangeBase, IRangeSelector<double>, ISupportInitialize
Constructors
RadSlider()
Fields
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
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
|
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
|
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
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()
Called when the control begins Initializing.
Declaration
public virtual 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()
Called when the control is Initialized.
Declaration
public virtual 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
|
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. |
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>
|