Skip to main content
All docs
V25.1
  • TimeSpanScaleOptions Class

    Settings of a scale when its type is time-span.

    Namespace: DevExpress.XtraCharts

    Assembly: DevExpress.XtraCharts.v25.1.dll

    NuGet Package: DevExpress.Charts

    #Declaration

    public class TimeSpanScaleOptions :
        ScaleOptionsBase,
        ITimeSpanScaleOptions,
        IScaleOptionsBase<TimeSpanMeasureUnitNative>,
        IScaleOptionsBase

    The following members return TimeSpanScaleOptions objects:

    #Example

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

    To do this, you can use the following code:

    private void Form1_Load(object sender, EventArgs e) {
        XYDiagram diagram = chartControl1.Diagram as XYDiagram;
        if (diagram != null) {
            diagram.AxisX.TimeSpanScaleOptions.ScaleMode = ScaleMode.Manual;
            diagram.AxisX.TimeSpanScaleOptions.MeasureUnit = TimeSpanMeasureUnit.Hour;
            diagram.AxisX.TimeSpanScaleOptions.AggregateFunction = AggregateFunction.Average;
            diagram.AxisX.TimeSpanScaleOptions.GridSpacing = 6;
            diagram.AxisX.TimeSpanScaleOptions.GridAlignment = TimeSpanGridAlignment.Hour;
        }             
    }
    

    The example uses the following API members:

    Member Description
    ScaleOptionsBase.ScaleMode Gets or sets the scale mode for an axis.
    TimeSpanScaleOptions.MeasureUnit Gets or sets the detail level for time-span values.
    ScaleGridOptionsBase.AggregateFunction Gets or sets the value indicating the aggregate function that should be used to relieve data.
    ScaleGridOptionsBase.GridSpacing Gets or sets the interval between grid lines and major tickmarks.
    See Also