Legend Class

Represents a chart control’s legend.

Namespace: DevExpress.WinUI.Charts

Assembly: DevExpress.WinUI.Charts.v23.2.dll

NuGet Package: DevExpress.WinUI

Declaration

C#

public class Legend :
    ChartElement

VB.NET

Public Class Legend
    Inherits ChartElement

Related API Members

The following members return Legend objects:

• ChartBase.Legend

Remarks

An object of the Legend type is returned via the ChartBase.Legend property.

The legend identifies chart elements by markers coupled with text.

A series (or its data points) is represented in the legend if the SeriesBase.ShowInLegend property is enabled.

To control a legend’s alignment within a chart, use the Legend.HorizontalPosition and Legend.VerticalPosition properties.

A legend and its items are customized via the Legend.ItemTemplate and Legend.ReverseItems properties.

Example

This example creates a Cartesian chart with 3 Stacked Bar series, populates them with data, and adjusts common settings.

XAML

<Window

    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:CartesianChart"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:Charts="using:DevExpress.WinUI.Charts"
    x:Class="CartesianChart.MainWindow"
    mc:Ignorable="d">

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
        <Charts:CartesianChart Margin="50">
            <Charts:CartesianChart.Legend>
                <Charts:Legend BorderThickness="0" Margin="0,-5,0,-5"/>
            </Charts:CartesianChart.Legend>
            <Charts:CartesianChart.Series>
                <Charts:Series DisplayName="Illinois">
                    <Charts:Series.View>
                        <Charts:BarSeriesView StackedMode="Stacked"/>
                    </Charts:Series.View>
                    <Charts:Series.Data>
                        <Charts:PointDataCollection ArgumentScaleType="Qualitative">
                            <Charts:PointData Argument="1998" Value="423.721"/>
                            <Charts:PointData Argument="2001" Value="476.851"/>
                            <Charts:PointData Argument="2004" Value="528.904"/>
                        </Charts:PointDataCollection>
                    </Charts:Series.Data>
                </Charts:Series>
                <Charts:Series DisplayName="Indiana">
                    <Charts:Series.View>
                        <Charts:BarSeriesView StackedMode="Stacked"/>
                    </Charts:Series.View>
                    <Charts:Series.Data>
                        <Charts:PointDataCollection ArgumentScaleType="Qualitative">
                            <Charts:PointData Argument="1998" Value="178.719" />
                            <Charts:PointData Argument="2001" Value="195.769" />
                            <Charts:PointData Argument="2004" Value="227.271" />
                        </Charts:PointDataCollection>
                    </Charts:Series.Data>
                </Charts:Series>
                <Charts:Series DisplayName="Michigan" >
                    <Charts:Series.View>
                        <Charts:BarSeriesView StackedMode="Stacked"/>
                    </Charts:Series.View>
                    <Charts:Series.Data>
                        <Charts:PointDataCollection ArgumentScaleType="Qualitative">
                            <Charts:PointData Argument="1998" Value="308.845" />
                            <Charts:PointData Argument="2001" Value="335.793" />
                            <Charts:PointData Argument="2004" Value="372.576" />
                        </Charts:PointDataCollection>
                    </Charts:Series.Data>
                </Charts:Series>
            </Charts:CartesianChart.Series>
        </Charts:CartesianChart>
    </Grid>
</Window>

Inheritance

Object

DependencyObject

UIElement

FrameworkElement

Control

ChartElement

Legend