New to Telerik UI for WPF? Start a free 30-day trial

DoubleRangeBase

Class

DoubleRangeBase inherits RangeBase and introduces two new fields - SelectionStart and SelectionEnd. SelectionStart cannot be greater than SelectionEnd and SelectionEnd cannot be less than SelectionStart.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.dll

Syntax:

public class DoubleRangeBase : RangeBase, IRangeSelector<double>

Inheritance: objectDoubleRangeBase

Derived Classes: RadSlider

Implements: IRangeSelector<double>

Constructors

DoubleRangeBase()

public DoubleRangeBase()

Fields

IsCoercionSuppressedProperty

DependencyProperty

Identifies the IsCoercionSuppressed dependency property.

public static readonly DependencyProperty IsCoercionSuppressedProperty

IsSelectionRangeEnabledProperty

DependencyProperty

Identifies the IsSelectionRangeEnabled dependency property.

public static readonly DependencyProperty IsSelectionRangeEnabledProperty

MaximumRangeSpanProperty

DependencyProperty

Identifies the MaximumRangeSpan dependency property.

public static readonly DependencyProperty MaximumRangeSpanProperty

MinimumRangeSpanProperty

DependencyProperty

Identifies the MinimumRangeSpan dependency property.

public static readonly DependencyProperty MinimumRangeSpanProperty

SelectionChangedEvent

RoutedEvent

Identifies the Hover routed event.

public static readonly RoutedEvent SelectionChangedEvent

SelectionEndProperty

DependencyProperty

Identifies the SelectionEnd dependency property.

public static readonly DependencyProperty SelectionEndProperty

SelectionProperty

DependencyProperty

Identifies the SelectionProperty dependency property.

public static readonly DependencyProperty SelectionProperty

SelectionStartProperty

DependencyProperty

Identifies the SelectionStart dependency property.

public static readonly DependencyProperty SelectionStartProperty

Properties

IsCoercionSuppressed

bool

Gets or sets a value that indicates whether the slider should coerce the setting of related properties like Value, SelectionStart, SelectionEnd, Minimum, Maximum, MinimumRangeSpan and MaximumRangeSpan.

public bool IsCoercionSuppressed { get; set; }

Remarks:

If set to True, the coercion is done only when the user manipulates the slider and not if the related properties are set by code or through binding.

IsInitializing

bool

Gets or sets whether the control is initializing.

protected bool IsInitializing { get; set; }

IsSelectionRangeEnabled

bool

Gets or sets a value that indicates whether the RadSlider can displays a selection range. This is a dependency property.

public bool IsSelectionRangeEnabled { get; set; }

Remarks:

The SelectionStart and SelectionEnd properties define a selection range and must be set for the selection range to appear when IsSelectionRangeEnabled is set to true.

IsUserManipulationInProgress

bool

Gets or sets a value indicating whether this instance is user manipulation in progress.

protected bool IsUserManipulationInProgress { get; set; }

Property Value:

True if this instance is user manipulation in progress; otherwise, false.

MaximumRangeSpan

double

Gets or sets the maximum value distance between SelectionStart and SelectionEnd.

public double MaximumRangeSpan { get; set; }

Remarks:

The IsSelectionRangeEnabled property of RadSlider has to be set to True.

MinimumRangeSpan

double

Gets or sets the minimum value distance between SelectionStart and SelectionEnd.

public double MinimumRangeSpan { get; set; }

Remarks:

The IsSelectionRangeEnabled property of RadSlider has to be set to True.

Selection

SelectionRange<double>

Gets or sets the selection - SelectionStart and SelectionEnd.

public SelectionRange<double> Selection { get; set; }

Property Value:

The selection.

Implements: IRangeSelector<double>.Selection

SelectionEnd

double

Gets or sets the largest value of a specified selection.

public double SelectionEnd { get; set; }

Implements: IRangeSelector<double>.SelectionEnd

Remarks:

The value of the SelectionEnd property cannot be greater than the value of the property and cannot be less than the value of the property. The value of the SelectionEnd property must also be greater than or equal to the value of the SelectionStart property. If the value of the SelectionEnd property is greater than the value of the property or less than the value of the property, the value is set to the value of the or property respectively.

SelectionRange

double

Gets the difference between SelectionStart and SelectionEnd.

public double SelectionRange { get; }

Property Value:

The difference between SelectionStart and SelectionEnd.

SelectionStart

double

Gets or sets the smallest value of a specified selection.

public double SelectionStart { get; set; }

Implements: IRangeSelector<double>.SelectionStart

Remarks:

IsSelectionRangeEnabled must be True in order to use SelectionStart and SelectionEnd The value of the SelectionStart property cannot be less than the value of the Minimum property and cannot be greater than the value of the Maximum property. The value of the SelectionEnd property must also be greater than or equal to the value of the SelectionStart property. If SelectionStart is less than Minimum or greater than Maximum, SelectionStart is set to the value of Minimum or Maximum respectively.

Methods

ArrangeOverride(Size)

Size

Arranges the content of the DoubleRangeBase control and sets the IsArranged property to true.

protected override Size ArrangeOverride(Size finalSize)

Parameters:finalSizeSize

The final area within the parent that this element should use to arrange itself and its children.

Returns:

Size

The actual size used after arranging the element.

CoerceRangeSpanProperties()

Coerces the MinimumRangeSpan and MaximumRangeSpan properties based on the selection state of the control.

protected void CoerceRangeSpanProperties()

CoerceSelectionProperties()

Coerces the SelectionStart, SelectionEnd and Selection properties based on the selection state of the control.

protected void CoerceSelectionProperties()

OnApplyTemplate()

Called when the template of the DoubleRangeBase control is applied. This method is responsible for establishing the visual elements and bindings needed for the control's functionality.

public override void OnApplyTemplate()

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

protected override void OnInitialized(EventArgs e)

Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

OnIsSelectionRangeEnabledChanged()

Called when the IsSelectionRangeEnabled property changes value.

protected virtual void OnIsSelectionRangeEnabledChanged()

OnMaximumChanged(double, double)

Called when the property changes.

protected override void OnMaximumChanged(double oldMaximum, double newMaximum)

Parameters:oldMaximumdouble

Old value of the property.

newMaximumdouble

New value of the property.

OnMaximumRangeSpanChanged(double, double)

Called when MaximumRangeSpanChanged event occurs.

protected virtual void OnMaximumRangeSpanChanged(double oldValue, double newValue)

Parameters:oldValuedouble

The old value.

newValuedouble

The new value.

OnMinimumChanged(double, double)

Called when the property changes.

protected override void OnMinimumChanged(double oldMinimum, double newMinimum)

Parameters:oldMinimumdouble

Old value of the property.

newMinimumdouble

New value of the property.

OnMinimumRangeSpanChanged(double, double)

Called when MinimumRangeSpanChanged event occurs.

protected virtual void OnMinimumRangeSpanChanged(double oldValue, double newValue)

Parameters:oldValuedouble

The old value.

newValuedouble

The new value.

OnSelectionChanged()

Called when SelectionRange event occurs.

protected virtual void OnSelectionChanged()

OnSelectionEndChanged(double, double)

Called when SelectionEndChanged event occurs.

protected virtual void OnSelectionEndChanged(double oldValue, double newValue)

Parameters:oldValuedouble

The old value.

newValuedouble

The new value.

OnSelectionStartChanged(double, double)

Called when SelectionStartChanged event occurs.

protected virtual void OnSelectionStartChanged(double oldValue, double newValue)

Parameters:oldValuedouble

The old value.

newValuedouble

The new value.

Events

MaximumRangeSpanChanged

RoutedPropertyChangedEventHandler<double>

Occurs when MaximumRangeSpan property changes value.

public event RoutedPropertyChangedEventHandler<double> MaximumRangeSpanChanged

MinimumRangeSpanChanged

RoutedPropertyChangedEventHandler<double>

Occurs when MinimumRangeSpan property changes value.

public event RoutedPropertyChangedEventHandler<double> MinimumRangeSpanChanged

SelectionChanged

RadRoutedEventHandler

Occurs when the Selection property has changed.

public event RadRoutedEventHandler SelectionChanged

Implements: IRangeSelector<double>.SelectionChanged

SelectionEndChanged

RoutedPropertyChangedEventHandler<double>

Occurs when SelectionEnd property changes value.

public event RoutedPropertyChangedEventHandler<double> SelectionEndChanged

SelectionStartChanged

RoutedPropertyChangedEventHandler<double>

Occurs when SelectionStart property changes value.

public event RoutedPropertyChangedEventHandler<double> SelectionStartChanged