Skip to main content
A newer version of this page is available. .

LegendAlignmentVertical Enum

Lists the values that specify the legend’s vertical alignment within the Chart control.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.2.dll

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

Declaration

[ResourceFinder(typeof(XtraChartsResFinder), "PropertyNamesRes")]
public enum LegendAlignmentVertical

Members

Name Description
TopOutside

The legend is positioned at the top of the Chart control.

LegendAlgnVert_TopOutside

Top

The legend is positioned level with the top of the Diagram.

LegendAlgnVert_Top

Center

The legend is centered vertically.

LegendAlgnVert_Center

Bottom

The legend is positioned level with the bottom of the Diagram.

LegendAlgnVert_Bottom

BottomOutside

The legend is positioned at the bottom of the Chart control.

LegendAlgnVert_BottomOutsid

Related API Members

The following properties accept/return LegendAlignmentVertical values:

Library Related API Members
Cross-Platform Class Library Legend.AlignmentVertical
WinForms Controls LegendModel.AlignmentVertical

Remarks

The values listed by this enumeration are used to set the Legend.AlignmentVertical property.

For more information, refer to Legends.

Example

This example demonstrates how a chart’s Legend can be accessed and customized at runtime.

To control whether series, indicators, Constant Lines and Strips should be shown in the legend, use their SeriesBase.ShowInLegend, Indicator.ShowInLegend, ConstantLine.ShowInLegend and Strip.ShowInLegend properties.

Legend legend = chartControl1.Legend;

// Display the chart control's legend.
legend.Visible = true;

// Define its margins and alignment relative to the diagram.
legend.Margins.All = 8;
legend.AlignmentHorizontal = LegendAlignmentHorizontal.RightOutside;
legend.AlignmentVertical = LegendAlignmentVertical.Top;

// Define the layout of items within the legend.
legend.Direction = LegendDirection.LeftToRight;
legend.EquallySpacedItems = true;
legend.HorizontalIndent = 8;
legend.VerticalIndent = 8;
legend.TextVisible = true;
legend.TextOffset = 8;
legend.MarkerVisible = true;
legend.MarkerSize = new Size(20, 20);
legend.Padding.All = 4;

// Define the limits for the legend to occupy the chart's space.
legend.MaxHorizontalPercentage = 50;
legend.MaxVerticalPercentage = 50;

// Customize the legend appearance.
legend.BackColor = Color.Beige;
legend.FillStyle.FillMode = FillMode.Gradient;
((RectangleGradientFillOptions)legend.FillStyle.Options).Color2 = Color.Bisque;

legend.Border.Visible = true;
legend.Border.Color = Color.DarkBlue;
legend.Border.Thickness = 2;

legend.Shadow.Visible = true;
legend.Shadow.Color = Color.LightGray;
legend.Shadow.Size = 2;

// Customize the legend text properties.
legend.Antialiasing = false;
legend.Font = new Font("Arial", 9, FontStyle.Bold);
legend.TextColor = Color.DarkBlue;
See Also