Skip to main content

ScrollingRange.MaxValue Property

OBSOLETE

This property is obsolete now. Use AxisBase.WholeRange.MaxValue instead.

Gets or sets the maximum value to display on an Axis, when the diagram is scrolled.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[Browsable(false)]
[Obsolete("This property is obsolete now. Use AxisBase.WholeRange.MaxValue instead.")]
[TypeConverter(typeof(AxisRangeMaxValueTypeConverter))]
[XtraSerializableProperty(XtraSerializationVisibility.Hidden)]
public object MaxValue { get; set; }

Property Value

Type Description
Object

A Object that specifies the maximum value to display on an axis, when the diagram is scrolled.

Remarks

Use the MaxValue property to specify or obtain the maximum value to display on an axis, when the diagram is scrolled.

Note that the MaxValue and ScrollingRange.Auto properties are interdependent: changing one property will reset the other property.

Note

Dealing with Qualitative or DateTime scale types, it may be required to determine the maximum value more precisely than allowed by these scale types. For example, for an axis whose AxisBase.DateTimeMeasureUnit property is set to Year, it may be required to restrict its scrolling range by a Month. For this, you can use the ScrollingRange.MaxValueInternal property, which stores the internal, numeric representation of Qualitative and DateTime values.

For more information, refer to Visual Ranges and Whole Ranges .

Example

This example demonstrates how to use the AxisBase.VisualRange property to define the visible range of an axis, and the AxisBase.WholeRange property to define its whole range.

For more information on axis range, refer to Visual Ranges and Whole Ranges .

using DevExpress.XtraCharts;
using System;
using System.Windows.Forms;

namespace WindowsFormsApplication1 {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {

            // Create a chart control.
            ChartControl chartControl1 = new ChartControl();

            // Add the chart to the form.
            chartControl1.Dock = DockStyle.Fill;
            this.Controls.Add(chartControl1);

            // Create a bar series and add points to it.
            Series series1 = new Series("Series 1", ViewType.Bar);
            series1.Points.Add(new SeriesPoint("A", new double[] { 26.25 }));
            series1.Points.Add(new SeriesPoint("B", new double[] { 1.52 }));
            series1.Points.Add(new SeriesPoint("C", new double[] { 22.21 }));
            series1.Points.Add(new SeriesPoint("D", new double[] { 15.35 }));
            series1.Points.Add(new SeriesPoint("E", new double[] { 4.15 }));

            // Add the series to the chart.
            chartControl1.Series.Add(series1);

            // Cast the chart's diagram to the XYDiagram type, to access its axes.
            XYDiagram diagram = (XYDiagram)chartControl1.Diagram;

            // Enable the diagram's scrolling.
            diagram.EnableAxisXScrolling = true;
            diagram.EnableAxisYScrolling = true;

            // Define the whole range for the X-axis. 
            diagram.AxisX.WholeRange.Auto = false;
            diagram.AxisX.WholeRange.SetMinMaxValues("A", "D");

            // Disable the side margins 
            // (this has an effect only for certain view types).
            diagram.AxisX.VisualRange.AutoSideMargins = false;

            // Limit the visible range for the X-axis.
            diagram.AxisX.VisualRange.Auto = false;
            diagram.AxisX.VisualRange.SetMinMaxValues("B", "C");

            // Define the whole range for the Y-axis. 
            diagram.AxisY.WholeRange.Auto = false;
            diagram.AxisY.WholeRange.SetMinMaxValues(1, 26);
        }
    }
}
See Also