Back to Devexpress

ColorListLegend.SortOrder Property

windowsforms-devexpress-dot-xtramap-dot-colorlistlegend-6db47279.md

latest4.3 KB
Original Source

ColorListLegend.SortOrder Property

Gets or sets the sort order of the color list legend items.

Namespace : DevExpress.XtraMap

Assembly : DevExpress.XtraMap.v25.2.dll

NuGet Package : DevExpress.Win.Map

Declaration

csharp
[DefaultValue(LegendItemsSortOrder.Descending)]
public LegendItemsSortOrder SortOrder { get; set; }
vb
<DefaultValue(LegendItemsSortOrder.Descending)>
Public Property SortOrder As LegendItemsSortOrder

Property Value

TypeDefaultDescription
LegendItemsSortOrderDescending

A LegendItemsSortOrder enumeration value, specifying

the color list items sort order.

|

Available values:

NameDescription
Ascending

Specifies an ascending sorting order. It means that the first added item will be at top of the legend.

| | Descending |

Specifies a descending sorting order. It means that the last added item will be at top of the legend.

|

Example

csharp
using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.XtraMap;

namespace ColorListLegend_SortOrder {
    public partial class Form1 : Form {
        ColorListLegend legend;

        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            legend = new ColorListLegend() { Alignment = LegendAlignment.TopRight };
            legend.CustomItems.Add(new ColorLegendItem() { 
                Color = Color.Orange, 
                Text = "First color" 
            });
            legend.CustomItems.Add(new ColorLegendItem() {
                Color = Color.LightGray,
                Text = "Second color"
            });
            legend.CustomItems.Add(new ColorLegendItem() {
                Color = Color.Coral,
                Text = "Third color"
            });
            mapControl.Legends.Add(legend);

            lbSortOrder.DataSource = Enum.GetValues(typeof(LegendItemsSortOrder));
        }

        private void lbSortOrder_SelectedIndexChanged(object sender, EventArgs e) {
            legend.SortOrder = (LegendItemsSortOrder)lbSortOrder.SelectedValue;
        }
    }
}
vb
Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.XtraMap

Namespace ColorListLegend_SortOrder
    Partial Public Class Form1
        Inherits Form

        Private legend As ColorListLegend

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
            legend = New ColorListLegend() With {.Alignment = LegendAlignment.TopRight}
            legend.CustomItems.Add(New ColorLegendItem() With {.Color = Color.Orange, .Text = "First color"})
            legend.CustomItems.Add(New ColorLegendItem() With {.Color = Color.LightGray, .Text = "Second color"})
            legend.CustomItems.Add(New ColorLegendItem() With {.Color = Color.Coral, .Text = "Third color"})
            mapControl.Legends.Add(legend)

            lbSortOrder.DataSource = System.Enum.GetValues(GetType(LegendItemsSortOrder))
        End Sub

        Private Sub lbSortOrder_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) Handles lbSortOrder.SelectedIndexChanged
            legend.SortOrder = DirectCast(lbSortOrder.SelectedValue, LegendItemsSortOrder)
        End Sub
    End Class
End Namespace

See Also

ColorListLegend Class

ColorListLegend Members

DevExpress.XtraMap Namespace