ChartControlBase.Legends Property

Returns the collection of chart legends.

Namespace: DevExpress.Xpf.Charts

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

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public LegendCollection Legends { get; }

VB.NET

Public ReadOnly Property Legends As LegendCollection

Property Value

Type	Description
LegendCollection	A collection of Legend objects.

Example

To add an additional legend to a chart, add a newly created Legend object to the ChartControlBase.Legends collection.

Dock it to the required pane or chart using the Legend.DockTarget property. Then, position the legend using the LegendBase.HorizontalPosition and LegendBase.VerticalPosition properties. Assign the legend to a chart element whose legend item should be displayed in the legend, binding the Legend property of a series, an indicator, a constant line or a strip to the legend object.

Note

Note that a legend will not be visualized until it is bound to an element’s Legend property.

MainWindow.xaml

<dxc:ChartControl.Legends>
    <dxc:Legend x:Name="indicatorLegend"
                DockTarget="{Binding ElementName=indicatorPane}"
                HorizontalPosition="Left"
                VerticalPosition="Top"/>
</dxc:ChartControl.Legends>
            <dxc:MovingAverageConvergenceDivergence ShowInLegend="True" 
                                                    Name="MACD"
                                                    LegendText="MACD"
                                                    dxc:XYDiagram2D.IndicatorAxisY="{Binding ElementName=indicatorAxisY}"
                                                    dxc:XYDiagram2D.IndicatorPane="{Binding ElementName=indicatorPane}"
                                                    Legend="{Binding ElementName=indicatorLegend}"/>

Related GitHub Examples

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

XAML

wpf-bind-a-range-control-to-a-chart-control/CS/GoldPrices/MainWindow.xaml#L28

</dxc:ChartControl.Palette>
<dxc:ChartControl.Legends>
    <dxc:Legend Visible="False"/>

wpf-chart-create-3d-chart-with-automatically-generated-series/CS/Chart3D_Lesson3/MainWindow.xaml#L16

<dxc:Chart3DControl>
    <dxc:Chart3DControl.Legends>
        <dxc:Legend BorderBrush="Transparent" Background="Transparent"/>

wpf-chart-customize-the-crosshair-label-appearance/CS/CrosshairTemplateExample/MainWindow.xaml#L31

<!--endregion #PopupTemplateRegion-->
<dxc:ChartControl.Legends>
    <dxc:Legend/>

wpf-dashboard-how-to-obtain-clicked-item-data/CS/Dashboard_ClientDataCards_Wpf/DetailedChart.xaml#L13

<dxc:ChartControl x:Name="detailedChartControl">
    <dxc:ChartControl.Legends>
        <dxc:Legend/>

how-to-create-a-2d-side-by-side-bar-chart-e1257/CS/Window1.xaml#L37

</dxc:ChartControl.Diagram>
<dxc:ChartControl.Legends>
    <dxc:Legend HorizontalPosition="Right"/>