SeriesBase.SeriesPointsSortingKey Property
Gets or sets a value that specifies the values of the data points that the series should be sorted by.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v24.2.dll
NuGet Package: DevExpress.Charts
#Declaration
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public SeriesPointKey SeriesPointsSortingKey { get; set; }
#Property Value
Type | Description |
---|---|
Series |
A Series |
Available values:
Name | Description |
---|---|
Argument | Specifies that sorting is performed by the argument values of a series’ data points. |
Value_1 | Specifies that series points are sorted based on the first data value within the Series |
Value_2 | Specifies that series points are sorted based on the second data value within the Series |
Value_3 | Specifies that series points are sorted based on the third data value within the Series |
Value_4 | Specifies that series points are sorted based on the fourth data value within the Series |
Value_5 | Specifies that series points are sorted based on the fifth data value within the Series |
Value_6 | Specifies that series points are sorted based on the sixth data value within the Series |
#Remarks
Series points can be sorted based upon either their arguments or data values. Use the SeriesPointsSortingKey property to specify which values of the series’ data points should be used to sort the series data.
The sort order can be specified via the SeriesBase.SeriesPointsSorting property.
Note
Since, for some series view types, multiple values for each data point are required, there are four value modes for the Series
property. So, at runtime, to sort by values points of a series whose view type supports only a single value, choose the Series
#Example
The following properties allow you to sort series points within a series.
Property | Description |
---|---|
Series |
Specifies the point sort order. |
Series |
Specifies the value by which series points should be sorted. |
using DevExpress.XtraCharts;
using System;
using System.Windows.Forms;
namespace SeriesPointsSorting {
public partial class Form1 : Form {
public Form1() {
InitializeComponent();
}
#region #SeriesPointSorting
private void Form1_Load(object sender, EventArgs e) {
this.gSPTableAdapter.Fill(this.gspDataSet.GSP);
SeriesBase seriesTemplate = chart.SeriesTemplate;
seriesTemplate.SeriesPointsSorting = SortingMode.Ascending;
seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1;
}
#endregion #SeriesPointSorting
}
}
#Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SeriesPointsSortingKey property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.