Legend.ItemTemplate Property

Gets or sets the DataTemplate that specifies how to represent an item in the legend.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Charts, DevExpress.Wpf.Charts

Declaration

C#

public DataTemplate ItemTemplate { get; set; }

VB.NET

Public Property ItemTemplate As DataTemplate

Property Value

Type	Description
DataTemplate	A DataTemplate object that contains the template for the legend items.

Example

The following markup configures legend items that belong to series:

XAML

<dxc:ChartControl.Legends>
    <dxc:Legend HorizontalPosition="Left" 
                VerticalPosition="Top" 
                Orientation="Vertical">
        <dxc:Legend.ItemTemplate>
            <DataTemplate>
                <dxc:LegendItemContainer>
                    <Grid Width="12" Height="12">
                        <Rectangle Stretch="Uniform" 
                                   Fill="Transparent"/>
                        <dxc:ChartContentPresenter Content="{Binding}" 
                                                   ContentTemplate="{Binding Path=MarkerTemplate}"/>
                    </Grid>
                    <TextBlock Text="{Binding Path=Text}" 
                               VerticalAlignment="Center" 
                               MaxWidth="250" 
                               Margin="4"
                               Foreground="{Binding Path=MarkerBrush}"/>
                </dxc:LegendItemContainer>
            </DataTemplate>
        </dxc:Legend.ItemTemplate>
    </dxc:Legend>
</dxc:ChartControl.Legends>

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ItemTemplate 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

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

<dxc:LegendItemsControl ReverseItems="True"
                        ItemTemplate="{TemplateBinding ItemTemplate}"
                        LegendItems="{Binding Path=Items, RelativeSource={RelativeSource TemplatedParent}}">