SeriesBase.SeriesPointsSorting Property

Gets or sets the sort order of the series' points.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public SortingMode SeriesPointsSorting { get; set; }
<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property SeriesPointsSorting As SortingMode

Property Value

Type Description
SortingMode

A SortingMode enumeration value.

Remarks

Series points can be sorted based on either their arguments or data values, specified by the SeriesBase.SeriesPointsSortingKey property. Use the SeriesPointsSorting property to choose a mode for sorting data points within the series.

When there are multiple series available in a chart's collection, and point sorting is applied to either of these series, points are sorted within all existing series.

The following images demonstrate the three modes available for the SeriesPointsSorting property, with the series points sorted by their values.

SeriesPointsSorting = None

SeriesPointsSorting = Ascending

SeriesPointsSortingKey = Value_1

SeriesPointsSorting = Descending

SeriesPointsSortingKey = Value_1

SeriesPointSorting_none

SeriesPointSorting_ascend

SeriesPointSorting_descend

For more information, refer to Sorting Data.

Examples

The following properties allow you to sort series points within a series.

Property Description
SeriesBase.SeriesPointsSortingKey Specifies the point sort order.
SeriesBase.SeriesPointsSorting 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
    }
}
See Also