New to Telerik UI for WinForms? Download free 30-day trial

Linear

RadChartView uses Linear axes to plot data containing numerical values. Valid only in the context of Cartesian Area, this axis is created by default when you add Bar, Line, Area and Scatter series. It automatically calculates the Maximum, Minimum and MajorStep properties, based on the incoming data. Here is a list of all LinearAxis properties:

  • ActualRange: The property provides the actual range (the minimum and maximum) used by the axis to plot data points.

  • DesiredTickCount: Gets or sets the user-defined number of ticks on the axis.

  • Minimum: Gets or sets the user-defined minimum of the axis. By default the axis calculates the minimum, depending on the minimum of the plotted data points. You can reset this property by setting it to Double.NegativeInfinity to restore the default behavior.

  • Maximum: Gets or sets the user-defined maximum of the axis. By default the axis calculates the maximum, depending on the maximum of the plotted data points. You can reset this property by setting it to Double.PositiveInfinity to restore the default behavior.

  • MajorStep: The property determines the major step between each axis tick. By default the axis calculates the major step, depending on the plotted data points. You can reset this property by setting it to 0 to restore the default behavior.

  • RangeExtendDirection: Gets or sets a value that specifies how the auto-range of this axis is extended so that each data point is visualized in the best way. Possible values are None, Positive, Negative, Both. None sets the range minimum to the minimum data point value and the range maximum to the maximum data point value. Positive extends the range maximum with one major step if necessary. Negative extends the range minimum with one major step if necessary. Both extend the range in both negative and positive direction.

  • HorizontalLocation: The property determines the horizontal location of the axis in relation to the plot area. Possible values are Top and Bottom, where Top displays the axis above the area and Bottom displays the axis below the area. The default value is Bottom.

  • VerticalLocation: The property determines the vertical location of the axis in relation to the plot area. Possible values are Left and Right, where Left displays the axis on the left of the area and Right displays the axis on the right of the area. The default value is Left.

  • ClipLabels: This property controls whether labels will be clipped to the size of the axes (width/height).

Additionally, LinearAxis inherits all properties of the Axis class.

Here is how to set properties of the LinearAxes:

LinearAxis Setup

ScatterSeries series = new ScatterSeries();
series.DataPoints.Add(new ScatterDataPoint(5, 5));
series.DataPoints.Add(new ScatterDataPoint(4, 2));
series.DataPoints.Add(new ScatterDataPoint(-1, 3));
series.DataPoints.Add(new ScatterDataPoint(11, 4));
radChartView1.Series.Add(series);
LinearAxis horizontalAxis = radChartView1.Axes.Get<LinearAxis>(0);
// or horizontalAxis = series.HorizontalAxis as LinearAxis;
horizontalAxis.Minimum = -5;
horizontalAxis.Maximum = 15;
horizontalAxis.MajorStep = 5;
LinearAxis verticalAxis = radChartView1.Axes.Get<LinearAxis>(1);
// or verticalAxis = series.VerticalAxis as LinearAxis;
verticalAxis.Minimum = 1;
verticalAxis.Maximum = 7;
verticalAxis.MajorStep = 2;
verticalAxis.HorizontalLocation = AxisHorizontalLocation.Right;

Dim series As New ScatterSeries()
series.DataPoints.Add(New ScatterDataPoint(5, 5))
series.DataPoints.Add(New ScatterDataPoint(4, 2))
series.DataPoints.Add(New ScatterDataPoint(-1, 3))
series.DataPoints.Add(New ScatterDataPoint(11, 4))
RadChartView1.Series.Add(series)
Dim horizontalAxis As LinearAxis = RadChartView1.Axes.[Get](Of LinearAxis)(0)
'or horizontalAxis = TryCast(series.HorizontalAxis, LinearAxis)
horizontalAxis.Minimum = -5
horizontalAxis.Maximum = 15
horizontalAxis.MajorStep = 5
Dim verticalAxis As LinearAxis = RadChartView1.Axes.[Get](Of LinearAxis)(1)
' or verticalAxis = TryCast(series.VerticalAxis, LinearAxis)
verticalAxis.Minimum = 1
verticalAxis.Maximum = 7
verticalAxis.MajorStep = 2
verticalAxis.HorizontalLocation = AxisHorizontalLocation.Right

Figure 1: LinearAxis Setup

WinForms RadChartView LinearAxis Setup

See Also

In this article