Class

RadRangeSelector

Initializes a new instance of the RadRangeSelector class with default settings. Sets up event wiring and disables item tooltips by default.

Declaration

public RadRangeSelector()

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.

Declaration

[Browsable(true)]
public RadControl AssociatedControl { get; set; }

Property Value

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.

Declaration

[Browsable(true)]
public override bool AutoSize { get; }

Property Value

Overrides RadControl.AutoSize

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.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides Control.DefaultSize

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.

Declaration

[Browsable(true)]
public float EndRange { get; set; }

Property Value

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.

Declaration

[Browsable(false)]
public Orientation Orientation { get; set; }

Property Value

Gets the main RadRangeSelectorElement that provides the core functionality and visual representation. This element encapsulates all range selection logic, thumb controls, and visual rendering.

Declaration

public RadRangeSelectorElement RangeSelectorElement { get; }

Property Value

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.

Declaration

[Browsable(true)]
public float RangeSelectorViewZoomEnd { get; set; }

Property Value

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.

Declaration

[Browsable(true)]
public float RangeSelectorViewZoomStart { get; set; }

Property Value

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.

Declaration

[Browsable(true)]
public bool ShowButtons { get; set; }

Property Value

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.

Declaration

public override bool ShowItemToolTips { get; set; }

Property Value

Overrides RadControl.ShowItemToolTips

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.

Declaration

[Browsable(true)]
public float StartRange { get; set; }

Property Value

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.

Declaration

[Browsable(true)]
public UpdateMode UpdateMode { get; set; }

Property Value

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.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadControl.CreateChildItems(RadElement)

Creates and returns a new instance of RadRangeSelectorElement. Override this method to provide a custom range selector element implementation.

Declaration

protected virtual RadRangeSelectorElement CreateRangeSelectorElement()

Returns

Releases the unmanaged resources used by the RadRangeSelector and optionally releases the managed resources. Unwires all event handlers before disposing the control.

Declaration

protected override void Dispose(bool disposing)

Parameters

Overrides RadControl.Dispose(bool)

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.

Declaration

protected override void InitializeRootElement(RootRadElement rootElement)

Parameters

Overrides RadControl.InitializeRootElement(RootRadElement)

Called when the control is loaded with the specified desired size. Applies themes to the element tree to ensure proper visual styling.

Declaration

protected override void OnLoad(Size desiredSize)

Parameters

Overrides RadControl.OnLoad(Size)

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.

Declaration

protected override void OnRightToLeftChanged(EventArgs e)

Parameters

Overrides RadControl.OnRightToLeftChanged(EventArgs)

Raises the ScaleInitializing event with the specified event arguments. This method is called when a scale element is being initialized, providing access for customization.

Declaration

public virtual void OnScaleInitializing(ScaleInitializingEventArgs e)

Parameters

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.

Declaration

public virtual void OnSelectionChanged(EventArgs e)

Parameters

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.

Declaration

public virtual void OnSelectionChanging(RangeSelectorSelectionChangingEventArgs e)

Parameters

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.

Declaration

public virtual void OnThumbLeftValueChanged(EventArgs e)

Parameters

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.

Declaration

public virtual void OnThumbLeftValueChanging(ValueChangingEventArgs e)

Parameters

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.

Declaration

public virtual void OnThumbRightValueChanged(EventArgs e)

Parameters

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.

Declaration

public virtual void OnThumbRightValueChanging(ValueChangingEventArgs e)

Parameters

Unwires event handlers from the range selector element and associated control. Unsubscribes from all previously wired events to prevent memory leaks.

Declaration

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.

Declaration

protected virtual void WireEvents()

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.

Declaration

public event ScaleInitializingEventHandler ScaleInitializing

Event Value

Occurs 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.

Declaration

public event EventHandler SelectionChanged

Event Value

Occurs 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.

Declaration

public event RangeSelectorSelectionChangingEventHandler SelectionChanging

Event Value

Occurs 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.

Declaration

public event EventHandler ThumbLeftValueChanged

Event Value

Occurs 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.

Declaration

public event ValueChangingEventHandler ThumbLeftValueChanging

Event Value

Occurs 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.

Declaration

public event EventHandler ThumbRightValueChanged

Event Value

Occurs 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.

Declaration

public event ValueChangingEventHandler ThumbRightValueChanging

Event Value