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.GridAlignment Property

Gets or sets the time-span measurement unit that defines the alignment of grid lines and axis labels.

Namespace: DevExpress.Xpf.Charts

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

NuGet Package: DevExpress.Wpf.Charts

#Declaration

public TimeSpanGridAlignment GridAlignment { get; set; }

#Property Value

Type Description
TimeSpanGridAlignment

A measurement unit that defines how to align the axis major grid lines and labels.

Available values:

Name Description
Millisecond

Specifies the millisecond measurement unit.

Second

Specifies the second measurement unit.

Minute

Specifies the minute measurement unit.

Hour

Specifies the hour measurement unit.

Day

Specifies the day measurement unit.

#Property Paths

You can access this nested property as listed below:

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

#Remarks

The following images show charts with different grid alignments (GridSpacing is set to 1).

Value Image
GridAlignment = “Hour”
GridAlignment = “Day”

Disable the AutoGrid property before you specify GridAlignment.

#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