RangeControl Class

Supports range selection for any data.

Assembly: DevExpress.XtraEditors.v18.2.dll

Declaration

C#
VB.NET

[SmartTagAction(typeof(RangeControlActions), "AddNumericClient", "Add Numeric Client")]
[SmartTagAction(typeof(RangeControlActions), "AddChartNumericClient", "Add Chart Numeric Client")]
[SmartTagAction(typeof(RangeControlActions), "AddChartDateTimeClient", "Add Chart Date-Time Client")]
[SmartTagFilter(typeof(RangeControlFilter))]
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "RangeControl")]
public class RangeControl :
    BaseStyleControl,
    ISupportXtraAnimation,
    IRangeControl,
    IMouseWheelSupport,
    ISupportInitialize,
    IDirectXClient

<SmartTagAction(GetType(RangeControlActions), "AddNumericClient", "Add Numeric Client")>
<SmartTagAction(GetType(RangeControlActions), "AddChartNumericClient", "Add Chart Numeric Client")>
<SmartTagAction(GetType(RangeControlActions), "AddChartDateTimeClient", "Add Chart Date-Time Client")>
<SmartTagFilter(GetType(RangeControlFilter))>
<ToolboxBitmap(GetType(ToolboxIconsRootNS), "RangeControl")>
Public Class RangeControl
    Inherits BaseStyleControl
    Implements ISupportXtraAnimation,
               IRangeControl,
               IMouseWheelSupport,
               ISupportInitialize,
               IDirectXClient

The following members return RangeControl objects:

Remarks

The Range Control allows end-users to select ranges of data using mouse and fingers (when using touch screens).

RangeControl-Video-SelectRange

In addition to simple scrolling, you can zoom data in and out:

RangeControl-Video-ZoomRange

Clients

Data for the Range Control is provided by a Range Control Client, which must be associated with the Range Control by using the RangeControl.Client property. The client also visualizes data in the Range Control’s viewport in a specific manner. Embedded into the Range Control, the client automatically gains support for range selection and zooming.

The following Range Control Clients are available out of the box.

NumericRangeControlClient - A RangeControl‘s client that supports numeric (integer, double, decimal or float) range selection.
NumericChartRangeControlClient - The RangeControl‘s client that renders a lightweight chart with a numeric horizontal axis.
DateTimeChartRangeControlClient - The RangeControl‘s client that renders a lightweight chart with a date-time horizontal axis.
SchedulerControl - When using this client, the Range Control allows end-users to select date ranges for the associated Scheduler Control. See Scheduler Range Control.
ChartControl - When using this client, the Range Control allows end-users to select ranges for the associated Chart Control. See Integration with a Range Control.

To embed a NumericRangeControlClient, NumericChartRangeControlClient or DateTimeChartRangeControlClient into the Range Control at design time, use the Range Control’s smart tag.

RangeControl-SmartTag

When required, you can implement your own Range Control Client that will display data in a custom manner within the Range Control. See the Custom Range Control Client topic to learn more.

RangeControl-CustomClient

Selection

The current selection can be obtained using the RangeControl.SelectedRange property. When displaying numeric ranges, you can specify the range bounds using the Range Control’s ClientOptions.Minimum and ClientOptions.Maximum properties.