Skip to main content

NumericScaleOptions.MeasureUnit Property

Gets or sets the detail level for numeric values.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

[XtraSerializableProperty]
public NumericMeasureUnit MeasureUnit { get; set; }

Property Value

Type Description
NumericMeasureUnit

A NumericMeasureUnit enumeration value which represents the axis’ detail level.

Available values:

Name Description
Ones

Specifies ones as the measurement unit for numeric values.

Tens

Specifies tens as the measurement unit for numeric values.

Hundreds

Specifies hundreds as the measurement unit for numeric values.

Thousands

Specifies thousands as the measurement unit for numeric values.

Millions

Specifies millions as the measurement unit for numeric values.

Billions

Specifies billions as the measurement unit for numeric values.

Custom

The measurement unit for numeric values is specified by the NumericScaleOptions.CustomMeasureUnit property.

Property Paths

You can access this nested property as listed below:

Object Type Path to MeasureUnit
AxisBase
.NumericScaleOptions .MeasureUnit

Remarks

This property is available when the SeriesBase.ArgumentScaleType is set to either Auto or Numeric, the SeriesBase.ValueScaleType property is set to Numeric, and the ScaleOptionsBase.ScaleMode property is set to Manual.

NumericScaleOptions.MeasureUnit = Thousands NumericScaleOptions.MeasureUnit = Hundreds
NumericAggregation_Thousands NumericAggregation_Hundreds

Note

To access NumericScaleOptions, use the AxisBase.NumericScaleOptions property.

To define a numeric measurement unit to which the beginning of a diagram’s gridlines and labels should be aligned, use the NumericScaleOptions.GridAlignment property.

Example

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

Result

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

NumericScaleOptions numericScaleOptions = ((XYDiagram)chartControl.Diagram).AxisX.NumericScaleOptions;

numericScaleOptions.ScaleMode = ScaleMode.Manual;
numericScaleOptions.MeasureUnit = NumericMeasureUnit.Hundreds;
numericScaleOptions.GridOffset = 5;
numericScaleOptions.AggregateFunction = AggregateFunction.Average;
numericScaleOptions.GridAlignment = NumericGridAlignment.Thousands;
numericScaleOptions.GridSpacing = 1;

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

Member Description
AxisBase.NumericScaleOptions Stores the options that define the behavior of a scale when its type is numeric.
ScaleOptionsBase.ScaleMode Gets or sets the scale mode for an axis.
ScaleMode Lists the values that specify the scale mode for an axis.
NumericScaleOptions.MeasureUnit Gets or sets the detail level for numeric values.
NumericMeasureUnit Lists the values that specify the detail level for numeric 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.
NumericScaleOptions.GridAlignment Gets or sets the numeric measure unit to which the beginning of an axis’ gridlines and labels should be aligned.
NumericGridAlignment Lists the values that specify the numeric-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