AxisBase.QualitativeScaleComparer Property

Gets or sets the comparer used to compare deferred-axis qualitative scale values.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

[Browsable(false)]
[XtraSerializableProperty(XtraSerializationVisibility.Hidden)]
public IComparer QualitativeScaleComparer { get; set; }

VB.NET

<Browsable(False)>
<XtraSerializableProperty(XtraSerializationVisibility.Hidden)>
Public Property QualitativeScaleComparer As IComparer

Property Value

Type	Description
IComparer	An object of the class implementing the IComparer interface.

Example

To implement a custom qualitative scale values sort order, assign an object of a class implementing the IComparer interface to the AxisBase.QualitativeScaleComparer property.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-sort-qualitative-values-in-a-custom-order-t316036

NumberComparer.cs

using System;
using System.Collections;

namespace QualitativeScaleCustomSortOrderSample {
    class NumberComparer : IComparer {
        public int Compare(object x, object y) {
            int iX = NumberConverter.ToInt(x);
            int iY = NumberConverter.ToInt(y);
            return iX - iY;
        }
    }

    class NumberConverter {
        public static int ToInt(object o) {
            string stringNumber = o as string;
            int number = 0;
            if (stringNumber == null) return -1;
            if (Int32.TryParse(stringNumber, out number))
                return number;
            switch (stringNumber.ToLower()) {
                case "one": return 1;
                case "two": return 2;
                case "three": return 3;
            }
            return number;
        }
    }
}

Form1.cs

private void OnLoad(object sender, EventArgs e) {
    XYDiagram diagram = chart.Diagram as XYDiagram;
    if (diagram == null) return;
    diagram.AxisX.QualitativeScaleComparer = new NumberComparer();
}

NumberComparer.vb

Imports System
Imports System.Collections

Namespace QualitativeScaleCustomSortOrderSample
    Friend Class NumberComparer
        Implements IComparer

        Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer Implements IComparer.Compare
            Dim iX As Integer = NumberConverter.ToInt(x)
            Dim iY As Integer = NumberConverter.ToInt(y)
            Return iX - iY
        End Function
    End Class

    Friend Class NumberConverter
        Public Shared Function ToInt(ByVal o As Object) As Integer
            Dim stringNumber As String = TryCast(o, String)
            Dim number As Integer = 0
            If stringNumber Is Nothing Then
                Return -1
            End If
            If Int32.TryParse(stringNumber, number) Then
                Return number
            End If
            Select Case stringNumber.ToLower()
                Case "one"
                    Return 1
                Case "two"
                    Return 2
                Case "three"
                    Return 3
            End Select
            Return number
        End Function
    End Class
End Namespace

Form1.vb

Private Overloads Sub OnLoad(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    Dim diagram As XYDiagram = TryCast(chart.Diagram, XYDiagram)
    If diagram Is Nothing Then
        Return
    End If
    diagram.AxisX.QualitativeScaleComparer = New NumberComparer()
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the QualitativeScaleComparer 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.

C#

how-to-sort-qualitative-values-in-a-custom-order-t316036/CS/QualitativeScaleCustomSortOrderSample/Form1.cs#L22

    if (diagram == null) return;
    diagram.AxisX.QualitativeScaleComparer = new NumberComparer();
}

how-to-sort-stacked-bars-by-total-values-using-qualitativescalecomparer-t585190/CS/Form1.cs#L38

var axisX = ((XYDiagram)chartControl1.Diagram).AxisX;
axisX.QualitativeScaleComparer = new TotalScaleValuesComparer(chartControl1);
axisX.Reverse = true;

VB.NET

how-to-sort-qualitative-values-in-a-custom-order-t316036/VB/QualitativeScaleCustomSortOrderSample/Form1.vb#L26

    End If
    diagram.AxisX.QualitativeScaleComparer = New NumberComparer()
End Sub

how-to-sort-stacked-bars-by-total-values-using-qualitativescalecomparer-t585190/VB/Form1.vb#L36

Dim axisX = CType(chartControl1.Diagram, XYDiagram).AxisX
axisX.QualitativeScaleComparer = New TotalScaleValuesComparer(chartControl1)
axisX.Reverse = True