Skip to main content
All docs
V25.1
  • 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.v25.1.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