AxisX2D.TimeSpanScaleOptions Property

Gets or sets options of the time-span scale used by the argument axis.

Namespace: DevExpress.Xpf.Charts

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

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public TimeSpanScaleOptionsBase TimeSpanScaleOptions { get; set; }

VB.NET

Public Property TimeSpanScaleOptions As TimeSpanScaleOptionsBase

Property Value

Type	Description
TimeSpanScaleOptionsBase	The time-span scale options of the argument axis.

Remarks

You can use the following time-span options to specify the TimeSpanScaleOptions property:

• AutomaticTimeSpanScaleOptions - the scale measurement unit is automatically calculated. The automatic aggregation is enabled. You can change an AutomaticTimeSpanScaleOptions.AggregateFunction.
• ContinuousTimeSpanScaleOptions - the axis scale is not divided into intervals. For this reason, aggregation cannot be applied.
• ManualTimeSpanScaleOptions - the axis scale is divided into intervals specified by the ManualTimeSpanScaleOptions.MeasureUnit. You can aggregate data.

Example

The following example shows how to group minute-by-minute data into data points with a greater measurement unit (“Hour”).

• Use the ManualTimeSpanScaleOptions.MeasureUnit property to specify the measurement unit that should be greater than the initial data measurement unit.

• To change an arithmetic function used for computing point aggregates, use ManualTimeSpanScaleOptions.AggregateFunction.

• Optionally, you can specify the ManualTimeSpanScaleOptions.GridAlignment, ManualTimeSpanScaleOptions.GridSpacing, and ManualTimeSpanScaleOptions.GridOffset properties.

XAML

<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:ManualTimeSpanScaleOptions GridAlignment="Hour" 
                                                            GridSpacing="4"
                                                            MeasureUnit="Hour"
                                                            AggregateFunction="Average"
                                                            GridOffset="2"
                                                            AutoGrid="False"/>
                        </dxc:AxisX2D.TimeSpanScaleOptions>                           
                    </dxc:AxisX2D>
                </dxc:XYDiagram2D.AxisX>
                <!-- Other diagram settings. -->
            </dxc:XYDiagram2D>
        </dxc:ChartControl>
    </Grid>
</Window>