wpf-devexpress-dot-xpf-dot-charts-140d5bf7.md
Contains settings for a date-time axis data when its scale mode is manual.
Namespace : DevExpress.Xpf.Charts
Assembly : DevExpress.Xpf.Charts.v25.2.dll
NuGet Package : DevExpress.Wpf.Charts
public class ManualDateTimeScaleOptions :
DateTimeAggregationScaleOptionsBase
Public Class ManualDateTimeScaleOptions
Inherits DateTimeAggregationScaleOptionsBase
An object of the ManualDateTimeScaleOptions type is returned by the AxisX2D.DateTimeScaleOptions, AxisX3D.DateTimeScaleOptions, and RadarAxisX2D.DateTimeScaleOptions properties.
In this mode, the ManualDateTimeScaleOptions.GridAlignment and ManualDateTimeScaleOptions.MeasureUnit properties are available. These properties allow you to define the output format of date-time values shown by the axis labels.
For instance, you can use the ManualDateTimeScaleOptions.MeasureUnit property to determine the detail level for date-time values (e.g., Millisecond , Second , Minute , Hour , Day , etc.).
Data for each interval on the X-axis is aggregated using the function specified by the ManualDateTimeScaleOptions.AggregateFunction property. Although by default, the aggregate function is set to Average , it can be changed to Minimum , Maximum , Sum , etc.
To learn more, see Data Aggregation.
This example uses manual date-time scale options of the X-axis. It sets the AxisX2D.DateTimeScaleOptions property to ManualDateTimeScaleOptions and specifies GridAlignment, MeasureUnit, and AggregateFunction properties.
This example obtains data from the GbpUsdRate.xml file. Download GbpUsdRate.xml
<dx:ThemedWindow
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts"
x:Class="DXWPFCharts.MainWindow"
Title="MainWindow" Height="800" Width="1000">
<Grid>
<dxc:ChartControl>
<dxc:XYDiagram2D >
<dxc:XYDiagram2D.AxisX>
<dxc:AxisX2D GridLinesMinorVisible="True" GridLinesVisible="True" MinorCount="3">
<dxc:AxisX2D.Title>
<dxc:AxisTitle Content="Date"/>
</dxc:AxisX2D.Title>
<dxc:AxisX2D.DateTimeScaleOptions>
<dxc:ManualDateTimeScaleOptions AggregateFunction="Maximum" AutoGrid="False"
GridAlignment="Month" MeasureUnit="Day"
GridSpacing="3" GridOffset="1"/>
</dxc:AxisX2D.DateTimeScaleOptions>
</dxc:AxisX2D>
</dxc:XYDiagram2D.AxisX>
<dxc:LineSeries2D DataSource="{Binding Path=Rate}"
ArgumentDataMember="Argument" ValueDataMember="Value" />
</dxc:XYDiagram2D>
</dxc:ChartControl>
</Grid>
</dx:ThemedWindow>
using DevExpress.Xpf.Core;
using System;
using System.Collections.Generic;
using System.Globalization;
using System.Xml.Linq;
namespace DXWPFCharts {
public partial class MainWindow : ThemedWindow {
public MainWindow() {
InitializeComponent();
DataContext = new MyModel();
}
}
public class DateTimePoint {
double value;
DateTime argument;
public double Value {
get { return value; }
}
public DateTime Argument {
get { return argument; }
}
public DateTimePoint(DateTime argument, double value) {
this.argument = argument;
this.value = value;
}
}
public class MyModel {
List<DateTimePoint> rate = new List<DateTimePoint>();
public List<DateTimePoint> Rate {
get { return rate; }
}
public MyModel() {
LoadPoints(rate, LoadFromFile("GbpUsdRate.xml"));
}
XDocument LoadFromFile(string xmlFile) {
return XDocument.Load(xmlFile);
}
void LoadPoints(List<DateTimePoint> rate, XDocument document) {
if (rate != null && document != null) {
foreach (XElement element in document.Descendants("CurrencyRate")) {
DateTime argument = DateTime.Parse(element.Element("DateTime").Value);
double value = double.Parse(element.Element("Rate").Value, CultureInfo.InvariantCulture);
rate.Add(new DateTimePoint(argument, value));
}
}
}
}
}
Imports DevExpress.Xpf.Core
Imports System
Imports System.Collections.Generic
Imports System.Globalization
Imports System.Xml.Linq
Namespace DXWPFCharts
Public Class MainWindow
Inherits ThemedWindow
Public Sub New()
InitializeComponent()
DataContext = New MyModel()
End Sub
End Class
Public Class DateTimePoint
Private value As Double
Private argument As DateTime
Public ReadOnly Property Value As Double
Get
Return value
End Get
End Property
Public ReadOnly Property Argument As DateTime
Get
Return argument
End Get
End Property
Public Sub New(argument As DateTime, value As Double)
Me.argument = argument
Me.value = value
End Sub
End Class
Public Class MyModel
Private rate As List(Of DateTimePoint)
Public ReadOnly Property Rate As List(Of DateTimePoint)
Get
Return rate
End Get
End Property
Public Sub New()
rate = New List(Of DateTimePoint)()
LoadPoints(rate, LoadFromFile("GbpUsdRate.xml"))
End Sub
Private Function LoadFromFile(xmlFile As String) As XDocument
Return XDocument.Load(xmlFile)
End Function
Private Sub LoadPoints(rate As List(Of DateTimePoint), document As XDocument)
If rate IsNot Nothing AndAlso document IsNot Nothing Then
For Each element As XElement In document.Descendants("CurrencyRate")
Dim argument As DateTime = DateTime.Parse(element.Element("DateTime").Value)
Dim value As Double = Double.Parse(element.Element("Rate").Value, CultureInfo.InvariantCulture)
rate.Add(New DateTimePoint(argument, value))
Next
End If
End Sub
End Class
End Namespace
Tip
To use automatic date-time scale options, set the AxisX2D.DateTimeScaleOptions property to AutomaticDateTimeScaleOptions and select the appropriate AutomaticDateTimeScaleOptions.AggregateFunction.
Object DispatcherObject DependencyObject Freezable ChartDependencyObject ScaleOptionsBase DateTimeScaleOptionsBase DateTimeAggregationScaleOptionsBase ManualDateTimeScaleOptions IntervalDateTimeScaleOptions
See Also