Class
RadRangeBase

Represents an abstract base class for controls that define a range of values, supporting properties such as Minimum, Maximum, SmallChange, LargeChange, and current Value. This class enables functionality for manipulating the value within defined limits and supports automatic reverse behavior when the value reaches either endpoint. It provides robust event handling for value changes, enabling easy data binding and client-side control of the range's behavior in UI applications.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.dll

Syntax:

cs-api-definition
public abstract class RadRangeBase : Control

Inheritance: objectRadRangeBase

Derived Classes: RadNumericUpDown

Constructors

RadRangeBase()

Initializes a new instance of the RadRangeBase class.

Declaration

cs-api-definition
protected RadRangeBase()

Fields

AutoReverseProperty

Identifies the AutoReverse dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty AutoReverseProperty

Field Value

DependencyProperty

LargeChangeProperty

Identifies the LargeChange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty LargeChangeProperty

Field Value

DependencyProperty

MaximumProperty

Identifies the Maximum dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MaximumProperty

Field Value

DependencyProperty

MinimumProperty

Identifies the Minimum dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinimumProperty

Field Value

DependencyProperty

SmallChangeProperty

Identifies the SmallChange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SmallChangeProperty

Field Value

DependencyProperty

ValueProperty

Identifies the Value dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ValueProperty

Field Value

DependencyProperty

Properties

AutoReverse

Gets or sets the value that specifies whether the control will change its value to its minimum when it reaches its maximum, or vice versa.

Declaration

cs-api-definition
public bool AutoReverse { get; set; }

Property Value

bool

LargeChange

Gets or sets a value to be added to or subtracted from the Value of a RadRangeBase control.

Declaration

cs-api-definition
public double LargeChange { get; set; }

Property Value

double

Maximum

Gets or sets the highest possible RadRangeBase.Value of the range element.

Declaration

cs-api-definition
public double Maximum { get; set; }

Property Value

double

Minimum

Gets or sets the lowest possible RadRangeBase.Value of the range element.

Declaration

cs-api-definition
public double Minimum { get; set; }

Property Value

double

SmallChange

Gets or sets the value to be added to or subtracted from the RadRangeBase.Value.

Declaration

cs-api-definition
public double SmallChange { get; set; }

Property Value

double

Value

Gets or sets the current setting of the range control, which may be coerced.

Declaration

cs-api-definition
[SuppressMessage("Microsoft.Naming", "CA1721:PropertyNamesShouldNotMatchGetMethods")]
public double? Value { get; set; }

Property Value

double?

Methods

ChangeValue(double)

Adds the provided delta to the current value.

Declaration

cs-api-definition
protected virtual void ChangeValue(double delta)

Parameters

delta

double

The amount to add to Value.

OnMaximumChanged(double, double)

Called when the RadRangeBase.Maximum property changes.

Declaration

cs-api-definition
protected virtual void OnMaximumChanged(double oldMaximum, double newMaximum)

Parameters

oldMaximum

double

Old value of the RadRangeBase.Maximum property.

newMaximum

double

New value of the RadRangeBase.Maximum property.

OnMinimumChanged(double, double)

Called when the RadRangeBase.Minimum property changes.

Declaration

cs-api-definition
protected virtual void OnMinimumChanged(double oldMinimum, double newMinimum)

Parameters

oldMinimum

double

Old value of the RadRangeBase.Minimum property.

newMinimum

double

New value of the RadRangeBase.Minimum property.

OnValueChanged(RadRangeBaseValueChangedEventArgs)

Raises the RadRangeBase.ValueChanged routed event.

Declaration

cs-api-definition
protected virtual void OnValueChanged(RadRangeBaseValueChangedEventArgs e)

Parameters

e

RadRangeBaseValueChangedEventArgs

ToString()

Returns a string that represents this instance.

Declaration

cs-api-definition
public override string ToString()

Returns

string

A string that represents this instance.

Events

ValueChanged

Occurs when the range value changes.

Declaration

cs-api-definition
public event EventHandler<RadRangeBaseValueChangedEventArgs> ValueChanged

Event Value

EventHandler<RadRangeBaseValueChangedEventArgs>