RadRangeSelector
A range selector control that allows users to select a range within a data set by manipulating thumb controls. The RadRangeSelector provides visual range selection capabilities with associated control integration, supporting both horizontal and vertical orientations with customizable update modes and scale elements.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadRangeSelector : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportInitializeInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadRangeSelector...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadRangeSelector class with default settings. Sets up event wiring and disables item tooltips by default.
public RadRangeSelector()Properties
Gets or sets the control that is associated with this range selector for synchronized range operations. The associated control will be updated when the range selection changes, typically used with chart controls. Setting this to null removes the association, and setting it to another RadRangeSelector is ignored.
[Browsable(true)]
public RadControl AssociatedControl { get; set; }Gets or sets a value indicating whether the range selector control automatically adjusts its size to fit its content. When enabled, the control will resize itself based on its content requirements and layout constraints.
[Browsable(true)]
public override bool AutoSize { get; }Overrides:
Gets the default size of the range selector control when no explicit size is specified. The default dimensions are optimized for typical range selection scenarios.
protected override Size DefaultSize { get; }The default Size of 400x150 pixels for the control.
Overrides:
Gets or sets the ending value of the selected range within the range selector. This value represents the position of the right thumb in horizontal orientation or the top thumb in vertical orientation.
[Browsable(true)]
public float EndRange { get; set; }Gets or sets the orientation of the range selector, determining whether it displays horizontally or vertically. Changing the orientation automatically swaps the width and height dimensions of the control.
[Browsable(false)]
public Orientation Orientation { get; set; }Gets the main RadRangeSelectorElement that provides the core functionality and visual representation. This element encapsulates all range selection logic, thumb controls, and visual rendering.
public RadRangeSelectorElement RangeSelectorElement { get; }Gets or sets the end position of the zoom view within the range selector's viewport. This property controls which portion of the associated data is visible in the range selector's background view.
[Browsable(true)]
public float RangeSelectorViewZoomEnd { get; set; }Gets or sets the start position of the zoom view within the range selector's viewport. This property controls which portion of the associated data is visible in the range selector's background view.
[Browsable(true)]
public float RangeSelectorViewZoomStart { get; set; }Gets or sets a value indicating whether the range selector's thumb handles are visible and can be manipulated by users. When disabled, users cannot interact with the thumb controls to change the selected range.
[Browsable(true)]
public bool ShowButtons { get; set; }Gets or sets a value indicating whether ToolTips are shown for the RadItem objects contained in the range selector. By default, tooltips are disabled for range selector elements to prevent interference with range selection operations.
public override bool ShowItemToolTips { get; set; }Overrides:
Gets or sets the starting value of the selected range within the range selector. This value represents the position of the left thumb in horizontal orientation or the bottom thumb in vertical orientation.
[Browsable(true)]
public float StartRange { get; set; }Gets or sets the update mode that determines when the associated control is updated during range selection operations. Immediate updates the control continuously during thumb movement, while Deferred updates only when the thumb is released.
[Browsable(true)]
public UpdateMode UpdateMode { get; set; }Methods
Creates the child elements by instantiating the main RadRangeSelectorElement and adding it to the element tree. This establishes the core visual and functional structure of the range selector.
protected override void CreateChildItems(RadElement parent)The parent RadElement that will contain the child elements.
Overrides:
Creates and returns a new instance of RadRangeSelectorElement. Override this method to provide a custom range selector element implementation.
protected virtual RadRangeSelectorElement CreateRangeSelectorElement()A new RadRangeSelectorElement instance.
Releases the unmanaged resources used by the RadRangeSelector and optionally releases the managed resources. Unwires all event handlers before disposing the control.
protected override void Dispose(bool disposing)true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides:
Initializes the root element by setting vertical stretch behavior and calling the base implementation. This ensures the range selector can properly fill its container vertically.
protected override void InitializeRootElement(RootRadElement rootElement)The root RootRadElement to initialize.
Overrides:
Overrides the right-to-left change notification to prevent default processing. The range selector handles right-to-left layout changes through its internal element structure.
Raises the ScaleInitializing event with the specified event arguments. This method is called when a scale element is being initialized, providing access for customization.
public virtual void OnScaleInitializing(ScaleInitializingEventArgs e)A ScaleInitializingEventArgs that contains the event data including the scale element being initialized.
Raises the SelectionChanged event with the specified event arguments. This method is called when the entire selection range has been successfully changed to notify any registered event handlers.
Raises the SelectionChanging event with the specified event arguments. This method is called when the entire selection range is about to change, allowing handlers to validate or cancel the change.
public virtual void OnSelectionChanging(RangeSelectorSelectionChangingEventArgs e)A RangeSelectorSelectionChangingEventArgs that contains the event data and allows cancellation of the change.
Raises the ThumbLeftValueChanged event with the specified event arguments. This method is called when the left thumb value has been successfully changed to notify any registered event handlers.
Raises the ThumbLeftValueChanging event with the specified event arguments. This method is called before the left thumb value changes, allowing handlers to validate or cancel the change.
public virtual void OnThumbLeftValueChanging(ValueChangingEventArgs e)A ValueChangingEventArgs that contains the event data and allows cancellation of the change.
Raises the ThumbRightValueChanged event with the specified event arguments. This method is called when the right thumb value has been successfully changed to notify any registered event handlers.
Raises the ThumbRightValueChanging event with the specified event arguments. This method is called before the right thumb value changes, allowing handlers to validate or cancel the change.
public virtual void OnThumbRightValueChanging(ValueChangingEventArgs e)A ValueChangingEventArgs that contains the event data and allows cancellation of the change.
Unwires event handlers from the range selector element and associated control. Unsubscribes from all previously wired events to prevent memory leaks.
protected virtual void UnwireEvents()Wires event handlers to the range selector element's events if the element exists. Subscribes to thumb value changing/changed events, selection events, and scale initialization events.
protected virtual void WireEvents()Events
Occurs when a scale element within the range selector is being initialized. This event provides access to scale elements during their creation, allowing for customization of scale appearance and behavior.
public event ScaleInitializingEventHandler ScaleInitializingOccurs when the entire selection range has been changed successfully. This event is fired after all selection changes are complete and the range selector is in a consistent state.
public event EventHandler SelectionChangedOccurs when the entire selection range is about to change, providing an opportunity to cancel the change. This event is triggered when both thumbs move simultaneously or when the selected range is modified programmatically.
public event RangeSelectorSelectionChangingEventHandler SelectionChangingOccurs when the value of the left thumb has been changed successfully. This event is fired after the value change is complete and all related processing has been finished.
public event EventHandler ThumbLeftValueChangedOccurs when the value of the left thumb is about to change, providing an opportunity to cancel or modify the change. This event allows validation and conditional approval of left thumb movements before they are applied.
public event ValueChangingEventHandler ThumbLeftValueChangingOccurs when the value of the right thumb has been changed successfully. This event is fired after the value change is complete and all related processing has been finished.
public event EventHandler ThumbRightValueChangedOccurs when the value of the right thumb is about to change, providing an opportunity to cancel or modify the change. This event allows validation and conditional approval of right thumb movements before they are applied.
public event ValueChangingEventHandler ThumbRightValueChanging