Legend.Direction Property

Gets or sets the direction of items in the legend.

Namespace: DevExpress.Xpf.TreeMap

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

NuGet Package: DevExpress.Wpf.TreeMap

Declaration

C#

public LegendDirection Direction { get; set; }

VB.NET

Public Property Direction As LegendDirection

Property Value

Type	Description
LegendDirection	The direction of items in the legend.

Available values:

Name	Description
TopToBottom	Legend items are positioned vertically from the top to the bottom of the legend.
BottomToTop	Legend items are positioned vertically from the bottom to the top of the legend.
LeftToRight	Legend items are positioned horizontally from the left to the right of the legend.
RightToLeft	Legend items are positioned horizontally from the right to the left of the legend.

Remarks

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

• Initialize the treemap’s Legend property with a Legend object.

• Initialize the Legend.Title property with a LegendTitle to add the legend title. Specify the following title options:

  • Content
  • FontSize
  • FontWeight

• Configure the options below to customize the legend position and indents:

  • Direction
  • HorizontalPosition
  • VerticalPosition
  • Padding
  • Margin

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

  • BorderBrush
  • BorderThickness

XAML

<Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:TreemapExample"
        xmlns:dxtm="http://schemas.devexpress.com/winfx/2008/xaml/treemap" 
        x:Class="TreemapExample.MainWindow"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">
    <Grid>
            <dxtm:TreeMapControl x:Name="treemap">
                <dxtm:TreeMapControl.Colorizer>
                    <dxtm:TreeMapPaletteColorizer ColorizeGroups="True"/>
                </dxtm:TreeMapControl.Colorizer>
                <dxtm:TreeMapControl.Legend>
                    <dxtm:Legend HorizontalPosition="Center" VerticalPosition="BottomOutside" 
                                 Margin="10" Height="80" Padding="4" Direction="TopToBottom"
                                 BorderBrush="DarkGray" BorderThickness="1">
                        <dxtm:Legend.Title>
                            <dxtm:LegendTitle Content="Field of Activity" FontSize="16" FontWeight="Bold"/>
                        </dxtm:Legend.Title>
                    </dxtm:Legend>
                </dxtm:TreeMapControl.Legend>
                <!-- Data binding settings are skipped. -->
            </dxtm:TreeMapControl>
        </Border>
    </Grid>
</Window>