LegendBase.AlignmentVertical Property
Gets or sets the legend’s vertical alignment within the chart control.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v21.2.dll
Declaration
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public LegendAlignmentVertical AlignmentVertical { get; set; }Property Value
| Type | Description |
|---|---|
| LegendAlignmentVertical | A LegendAlignmentVertical enumeration member which specifies the legend’s vertical alignment within the chart control. |
Available values:
| Name | Description |
|---|---|
| TopOutside | The legend is positioned at the top of the Chart control.
|
| Top | The legend is positioned level with the top of the Diagram.
|
| Center | The legend is centered vertically.
|
| Bottom | The legend is positioned level with the bottom of the Diagram.
|
| BottomOutside | The legend is positioned at the bottom of the Chart control.
|
Remarks
To specify the legend’s horizontal alignment use the LegendBase.AlignmentHorizontal 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;