ScaleOptionsBase.ScaleMode Property

Gets or sets the scale mode for an axis.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.2.dll

Declaration

public ScaleMode ScaleMode { get; set; }
Public Property ScaleMode As ScaleMode

Property Value

Type Description
ScaleMode

A scale mode.

Remarks

Use the ScaleMode property to define which scale mode should be used for an axis: manual, automatic, interval or continuous.

Note that when automatic mode is defined, the DateTimeScaleOptions.GridAlignment and DateTimeScaleOptions.MeasureUnit properties aren't available. You can change these properties in this mode using the ChartControl.AxisScaleChanged(WebChartControl.AxisScaleChanged or ChartControlSettings.AxisScaleChanged) event handler.

The following images demonstrate this property in action for the date-time data.

The property value

The resulting image

ScaleMode = Manual;

MeasureUnit = Quarter;

ManualScaleMode

ScaleMode = Automatic

AutomaticScaleMode

ScaleMode = Continuous

ContinuousScaleMode

ScaleMode = Interval

IntervalScaleMode

Examples

This example shows how to use DateTimeScaleOptions to reduce the number of visible series points.

Result

The following code configures the axis scale settings to resemble to the chart appearance above:

DateTimeScaleOptions dateTimeScaleOptions = ((XYDiagram)chartControl.Diagram).AxisX.DateTimeScaleOptions;

dateTimeScaleOptions.WorkdaysOnly = true;
dateTimeScaleOptions.ScaleMode = ScaleMode.Manual;
dateTimeScaleOptions.AggregateFunction = AggregateFunction.Average;
dateTimeScaleOptions.MeasureUnit = DateTimeMeasureUnit.Month;
dateTimeScaleOptions.GridAlignment = DateTimeGridAlignment.Quarter;
dateTimeScaleOptions.GridSpacing = 1;

The following table lists the API members the code above uses:

Member Description
AxisBase.DateTimeScaleOptions Stores the options that define the behavior of a scale when its type is date-time.
ScaleOptionsBase.ScaleMode Gets or sets the scale mode for an axis.
ScaleMode Lists the values that specify the scale mode for an axis.
DateTimeScaleOptions.MeasureUnit Gets or sets the detail level for date-time values.
DateTimeMeasureUnit Lists the values that specify the detail level for date-time values.
ScaleGridOptionsBase.GridOffset Gets or sets the offset of grid lines and major tickmarks.
ScaleGridOptionsBase.AggregateFunction Gets or sets the value indicating the aggregate function that should be used to relieve data.
AggregateFunction Lists the values that specify the aggregate function used for an axis.
DateTimeScaleOptions.GridAlignment Gets or sets the date-time measure unit to which the beginning of an axis' gridlines and labels should be aligned.
DateTimeGridAlignment Lists the values that specify the date-time measurement unit, to which the beginning of a diagram's gridlines and labels should be aligned.
ScaleGridOptionsBase.GridSpacing Gets or sets the interval between grid lines and major tickmarks.
See Also