ChartControl.Legend Property

Gets the chart control’s legend and provides access to its settings.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v19.1.dll

Declaration

C#

public Legend Legend { get; set; }

VB.NET

Public Property Legend As Legend

Property Value

Type	Description
Legend	A Legend object that represents the chart control’s legend.

Remarks

For more information on the chart control’s legend, see the Legend object’s description.

Note

Using the ChartControlBase.Legends property instead of this property is recommended.

Example

The following example demonstrates how to create a 2D Side-by-Side Bar. To do this, it is necessary to assign the ChartControl.Diagram property to XYDiagram2D, and then add two series with points to the diagram’s Diagram.Series collection.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-2d-side-by-side-bar-chart-e1257.

Window1.xaml

<Window x:Class="SideBySideBar2DChart.Window1" 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" 
        Title="Window1" Height="350" Width="620">
    <Grid>
        <dxc:ChartControl Name="chartControl1">
            <dxc:ChartControl.Diagram>
                <dxc:XYDiagram2D>
                    <dxc:XYDiagram2D.Series>
                        <dxc:BarSideBySideSeries2D DisplayName="First Series" BarWidth="0.5">
                            <!--region #Model-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="1" />
                                <dxc:SeriesPoint Argument="B" Value="2" />
                                <dxc:SeriesPoint Argument="C" Value="3" />
                                <dxc:SeriesPoint Argument="D" Value="4" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                        <dxc:BarSideBySideSeries2D DisplayName="Second Series" BarWidth="0.5">
                            <!--region #Model2-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model2-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="4" />
                                <dxc:SeriesPoint Argument="B" Value="3" />
                                <dxc:SeriesPoint Argument="C" Value="2" />
                                <dxc:SeriesPoint Argument="D" Value="1" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                    </dxc:XYDiagram2D.Series>
                </dxc:XYDiagram2D>
            </dxc:ChartControl.Diagram>
            <dxc:ChartControl.Legend>
                <dxc:Legend />
            </dxc:ChartControl.Legend>
        </dxc:ChartControl>
    </Grid>
</Window>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Legend 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-create-a-movable-legend-at-runtime-e3739/CS/scratch/MainWindow.xaml#L31

</dxc:ChartControl.Diagram>
<dxc:ChartControl.Legend>
    <dxc:Legend x:Name="legend" Visibility="Visible">

how-to-create-a-chart-control-with-a-scrollable-legend-e3565/CS/MainWindow.xaml#L9

<!--region #legend-->
<dxc:ChartControl.Legend>
    <dxc:Legend>

dxgrid-how-to-embed-the-chartcontrol-into-the-gridcontrol-cell-e2234/CS/E2234/UnboundCheckColumn/Window1.xaml#L12

<dxc:ChartControl Name="pie" Grid.ColumnSpan="1" Grid.RowSpan="9" Grid.Column="5" Grid.Row="1" Background="Transparent" BorderBrush="Transparent">
    <dxc:ChartControl.Legend>
        <dxc:Legend HorizontalPosition="Right" VerticalPosition="Center" Background="Transparent" Margin="0,0,-90,0"></dxc:Legend>

displaying-chart-control-in-grid-details-e4042/CS/WpfApplication19/MainWindow.xaml#L34

</dxc:SimpleDiagram2D>
<dxc:ChartControl.Legend>
    <dxc:Legend Visibility="Visible" > </dxc:Legend>

how-to-create-a-nested-donut-chart-t100731/CS/NestedDonutChart/MainWindow.xaml#L39

</dxc:ChartControl.Diagram>
<dxc:ChartControl.Legend>
    <dxc:Legend />