ColorListLegend Class

A legend that displays the descriptions of colors used to paint a treemap or sunburst.

Namespace: DevExpress.XtraTreeMap

Assembly: DevExpress.XtraTreeMap.v25.1.dll

NuGet Package: DevExpress.TreeMap

Declaration

C#

public class ColorListLegend :
    LegendBase

VB.NET

Public Class ColorListLegend
    Inherits LegendBase

Remarks

You can use a ColorListLegend object to specify the HierarchicalChartControlBase.Legend property.

The following image shows a ColorListLegend in a sunburst chart:

Example

How to Add a Legend to a Treemap

This example adds a legend to a treemap and configures its title, border, and text settings.

• Create a ColorListLegend object.

• Use the LegendBase.Title property to access the legend title settings. Specify the following title options:

  • Text
  • TextColor
  • DXFont

• Configure the options below to customize the position and alignment of the legend and legend items:

  • TextOffset
  • Direction
  • HorizontalAlignment
  • VerticalAlignment

• The following properties allow you to customize the legend border’s color and width:

  • BorderColor
  • BorderWidth

• Use the treemap’s Legend property to assign the legend to the treemap.

C#

using DevExpress.XtraTreeMap;
using System;
using System.Drawing;
using System.Windows.Forms;
//...
    private void Form1_Load(object sender, EventArgs e) {
        //...

        // Create a legend.
        ColorListLegend legend = new ColorListLegend();

        // Specify the legend title, and the title's color and font.
        legend.Title.Text = "Field of Activity";
        legend.Title.TextColor = Color.Black;
        legend.Title.DXFont = new DXFont("Tahoma", 10);

        // Define the color for legend items.
        legend.TextColor = Color.Black;

        // Set the offset beween an item's marker and text.
        legend.TextOffset = 16;

        // Specify the legend alignment and position.
        legend.Direction = LegendDirection.LeftToRight;
        legend.HorizontalAlignment = LegendHorizontalAlignment.Center;
        legend.VerticalAlignment = LegendVerticalAlignment.BottomOutside;

        // Define whether to arrange items in left-aligned columns.
        legend.EquallySpacedItems = true;

        // Configure the border color and width.
        legend.BorderColor = Color.LightGray;
        legend.BorderWidth = 1;

        // Assign the legend to the treemap.
        treeMapControl1.Legend = legend;
    }

VB.NET

Imports DevExpress.XtraTreeMap
Imports System
Imports System.Drawing
Imports System.Windows.Forms
'...
    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
        '...
        ' Create a legend.
        Dim legend As ColorListLegend = New ColorListLegend()

        ' Specify the legend title, and the title's color and font.
        legend.Title.Text = "Field of Activity"
        legend.Title.TextColor = Color.Black
        legend.Title.DXFont = New DXFont("Tahoma", 10)

        ' Define the color for legend items.
        legend.TextColor = Color.Black

        ' Set the offset beween an item's marker and text.
        legend.TextOffset = 16

        ' Specify the legend alignment and position.
        legend.Direction = LegendDirection.LeftToRight
        legend.HorizontalAlignment = LegendHorizontalAlignment.Center
        legend.VerticalAlignment = LegendVerticalAlignment.BottomOutside

        ' Define whether to arrange items in left-aligned columns.
        legend.EquallySpacedItems = True

        ' Configure the border color and width.
        legend.BorderColor = Color.LightGray
        legend.BorderWidth = 1

        ' Assign the legend to the treemap.
        treeMapControl1.Legend = legend
    End Sub

Inheritance

Object

LegendBase

ColorListLegend