All docs
V19.2
19.2
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.

ManualTimeSpanScaleOptions Class

Contains settings for a time-span axis when its scale mode is manual. This scale mode allows you to specify a measurement unit.

Namespace: DevExpress.Xpf.Charts

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

Declaration

public class ManualTimeSpanScaleOptions :
    TimeSpanAggregationScaleOptionsBase
Public Class ManualTimeSpanScaleOptions
    Inherits TimeSpanAggregationScaleOptionsBase

Remarks

You can use an ManualTimeSpanScaleOptions object to specify the following properties:

When an x-axis scale is manual, you can aggregate data based on a given MeasureUnit.

To form a custom measurement unit, use MeasureUnitMultiplier. For instance, by setting the MeasureUnit to Hour and the MeasureUnitMultiplier to 3, you configure a measurement unit of three hours.

Use the AggregateFunction property to define an arithmetic operation used to aggregate points. The default function is Average. The AggregateFunction enum lists all the available functions. If predefined functions do not meet your requirements, set AggregateFunction to Custom and use the CustomAggregateFunction property to set a custom function object.

The following options allows you to fine-tune grid parameters that affect the position of grid lines, tick marks and axis labels.

The grid alignment and grid spacing are automatically calculated when the AutoGrid property is enabled.

Examples

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

<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>
See Also