Legend.MaxHorizontalPercentage Property

Gets or sets the legend's maximum possible width (in percents).

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.2.dll

Declaration

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public double MaxHorizontalPercentage { get; set; }
<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property MaxHorizontalPercentage As Double

Property Value

Type Description
Double

A Double value which represents the maximum width of a legend (in percents).

Remarks

The MaxHorizontalPercentage is the diagram's area width percentage (or the chart's area width percentage, if the Legend is situated outside the diagram - refer to the Legend.AlignmentHorizontal and Legend.AlignmentVertical topics for more information).

The following images demonstrate the MaxHorizontalPercentage property in action.

MaxHorizontalPercentage = 100 MaxHorizontalPercentage = 60
MaxHorizontalPercentage_100 MaxHorizontalPercentage_60

For more information, refer to Legends.

Examples

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