Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ContinuousTimeSpanScaleOptions.GridSpacing Property

Gets or sets a value that specifies the distance between major tickmarks and grid lines.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v24.2.dll

NuGet Package: DevExpress.Wpf.Charts

#Declaration

public double GridSpacing { get; set; }

#Property Value

Type Description
Double

A value that specifies the grid spacing in grid alignment units.

#Property Paths

You can access this nested property as listed below:

Object Type Path to GridSpacing
AxisY2D
.TimeSpanScaleOptions .GridSpacing
AxisY3D
.TimeSpanScaleOptions .GridSpacing
CircularAxisY2D
.TimeSpanScaleOptions .GridSpacing

#Remarks

The following images show charts with different grid spacing values (GridAlignment is set to Hour).

Value Image
GridSpacing = “3”
GridSpacing = “4”

Disable the AutoGrid property before you specify GridSpacing.

#Example

This example shows how to configure a continuous time-span scale options of an x-axis.

<Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:TimeSpanExample"
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" 
        x:Class="TimeSpanExample.MainWindow"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">
    <Window.DataContext>
        <local:ChartViewModel/>
    </Window.DataContext>
    <Grid>
        <dxc:ChartControl>
            <dxc:XYDiagram2D>
                <dxc:XYDiagram2D.AxisX>
                    <dxc:AxisX2D>
                        <dxc:AxisX2D.TimeSpanScaleOptions>
                            <dxc:ContinuousTimeSpanScaleOptions GridAlignment="Hour" 
                                                                GridSpacing="3" 
                                                                AutoGrid="False"/>
                        </dxc:AxisX2D.TimeSpanScaleOptions>
                    </dxc:AxisX2D>
                </dxc:XYDiagram2D.AxisX>
                <!-- Other diagram settings. -->
            </dxc:XYDiagram2D>
        </dxc:ChartControl>
    </Grid>
</Window>

Related API:

Member Description
AxisX2D.TimeSpanScaleOptions Gets or sets options of the time-span scale used by the argument axis.
ContinuousTimeSpanScaleOptions Contains settings for an axis with a continuous time-span scale.
ContinuousTimeSpanScaleOptions.GridAlignment Gets or sets the time-span measurement unit that defines the alignment of grid lines and axis labels.
ContinuousTimeSpanScaleOptions.GridSpacing Gets or sets a value that specifies the distance between major tickmarks and grid lines.
ContinuousTimeSpanScaleOptions.AutoGrid Gets or sets a value that specifies whether the GridSpacing and GridAlignment property values are automatically calculated.
See Also