Integration with a Range Control

  • 3 minutes to read

When you deal with a large amount of data, you need a handy tool allowing you to track data changes and providing all interaction capabilities (scrolling, zooming, etc.).

A good solution is to use the benefits of two controls: XtraCharts for Windows Forms and a Range control (allows you to select a range of data).

As a result, you will get a tool that simplifies comparison and analysis of different chart series with all support data interaction.

For more information on the Range control, see the Range Control section.

This document consists of the following sections:

Connection to a Range Control

To provide integration, you don't need to write any lines of code. Just locate a RangeControl in the DX.20.1: Common Controls toolbox tab and drop it onto a form with a ChartControl.

Then, a range control is automatically bound to a chart allowing you to see a chart series in the Range control's Viewport.

ControlsConnection

To make sure the binding is provided, you can see the RangeControl.Client property in the Properties windows that is automatically set to chartControl1.

RangeClient

Chart and Range Customization

This section describes properties that can be used to customize a Chart control's representation in a Range control and explains how they can be accessed at design time.

Specify Series Representation in a Range control

A RangeControlOptions object contains properties that specify the series appearance in a range control's viewport.

Use the XYDiagram2DSeriesViewBase.RangeControlOptions to get access to the range control options for a series.

RangeOptions

The properties that affect series appearance in a range control are detailed in the following table.

Member Description
RangeControlOptions.ViewType Gets or sets a value that specifies which view type (either Line or Area) should be used to represent an XYDiagram2D series in a Range Control.
RangeControlOptions.SeriesTransparency Gets or sets the transparency (0-255) to apply to a series displayed in a Range control.
RangeControlOptions.ValueLevel Specifies which level of data points should be used to represent a FinancialIndicator series in a Range Control.
RangeControlOptions.Visible Gets or sets a value indicating whether or not this series should be displayed in a Range Control.

In the image below, the first Line series is hidden in the viewport by setting the RangeControlOptions.Visible property to false, while the second Line series is displayed as an Area (RangeControlOptions.ViewType is set to Area) in the Range control.

SeriesAppearanceCustomization

Interaction Capabilities

When you run your application, you can execute the following actions:

  • Select ranges by using multiple techniques (a chart automatically adjusts axis ranges to a value corresponding to the interval);
  • Use animated range selection;
  • Zoom in and out;
  • Use the touch screen.

IntegrationCapabilities

For additional information on chart interaction, refer to the End-User Capabilities section.

Examples

See Also