Skip to main content

ManualDateTimeScaleOptions.GridSpacing Property

Gets or sets the date-time grid step in grid alignment units.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v23.1.dll

NuGet Package: DevExpress.Wpf.Charts


public double GridSpacing { get; set; }

Property Value

Type Description

A Double value which specifies the date-time grid step.


This property manages label placement along the X-axis.

By default, the GridSpacing is set to the default value, so the grid step is calculated automatically. To change the grid step interval for axis labeling, set the ManualDateTimeScaleOptions.AutoGrid to false, and specify the GridSpacing property value.

The table below shows the GridSpacing property in action for random data.

ManualDateTimeScaleOptions.GridSpacing = 2 ManualDateTimeScaleOptions.GridSpacing = 4
ManualDateTime_GridSpacing_2 ManualDateTime_GridSpacing_4


This example demonstrates how to use the manual date-time scale options of the X-axis.

Data aggregation is enabled automatically for the date-time scale on the X-axis in both automatic and manual scale options.

When the AxisX2D.DateTimeScaleOptions property is set to ManualDateTimeScaleOptions, you can define the ManualDateTimeScaleOptions.GridAlignment, ManualDateTimeScaleOptions.MeasureUnit and ManualDateTimeScaleOptions.AggregateFunction properties manually.

To use the automatic date-time scale options, set the AxisX2D.DateTimeScaleOptions property to AutomaticDateTimeScaleOptions, and select the appropriate AutomaticDateTimeScaleOptions.AggregateFunction.

To prevent the axis scale from being divided into intervals (and thus prevent chart data from being aggregated), set the ManualDateTimeScaleOptions.AggregateFunction property to None.

View Example

        Title="MainWindow" Height="400" Width="525">
            <dxc:XYDiagram2D >
                    <dxc:AxisX2D GridLinesMinorVisible="True" GridLinesVisible="True">
                            <dxc:ManualDateTimeScaleOptions AggregateFunction="Maximum" AutoGrid="False"
                                                            GridAlignment="Year" MeasureUnit="Month" 
                                                            GridSpacing="3" GridOffset="1"/>
                <dxc:LineSeries2D DataSource="{Binding Path=Rate}" 
                                  ArgumentDataMember="Argument" ValueDataMember="Value"  />

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the GridSpacing property.


The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also