Nevron .NET Vision Documentation
Legend Appearance

Legend Fill Style

As with all visual objects in the component the legend has an associated fill style allowing you to control its filling. The following code applies a gradient fill style to the legend:

C#
Copy Code
NLegend legend = chartControl.Legends[0];
legend.FillStyle = new NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.White, Color.Gray);
Visual Basic
Copy Code
Dim legend As NLegend = legendsCollection(0)
legend.FillStyle = New NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.White, Color.Gray)
Legend Grid Lines

The legend grid lines visually separates the data items horizontally and vertically. The following picture shows the different legend grid lines:


The legend grid lines style is controlled through the HorizontalBorderStyle, VerticalBorderStyle, OuterLeftBorderStyle, OuterTopBorderStyle, OuterRightBorderStyle and OuterBottomBorderStyle properties of the NLegend object. The following code will change the colors of the different grid lines:

C#
Copy Code
NLegend legend = chartControl.Legends[0];

legend.HorizontalBorderStyle.Color = Color.Gray;
legend.VerticalBorderStyle.Color = Color.Black;
legend.OuterLeftBorderStyle.Color = Color.Red;
legend.OuterTopBorderStyle.Color = Color.Yellow;
legend.OuterRightBorderStyle.Color = Color.Green;
legend.OuterBottomBorderStyle.Color = Color.Blue;
Visual Basic
Copy Code
Dim legend As NLegend = chartControl.Legends(0)

legend.HorizontalBorderStyle.Color = Color.Gray
legend.VerticalBorderStyle.Color = Color.Black
legend.OuterLeftBorderStyle.Color = Color.Red
legend.OuterTopBorderStyle.Color = Color.Yellow
legend.OuterRightBorderStyle.Color = Color.Green
legend.OuterBottomBorderStyle.Color = Color.Blue
Legend Shadow Style

The legend also has an associated shadow style controlling the legend shadow. The following code enables the legend shadow and modifies its offset:

C#
Copy Code
NLegend legend = chartControl.Legends[0];

legend.ShadowStyle.Type = ShadowType.GaussianBlur;
legend.ShadowStyle.Offset = new NPointL(5, 5);
Visual Basic
Copy Code
Dim legend As NLegend = chartControl.Legends(0)

legend.ShadowStyle.Type = ShadowType.GaussianBlur
legend.ShadowStyle.Offset = New NPointL(5, 5)
Legend Interlacing

The legend interlace stripes are automatically generated based on the interlace styles added to the InterlaceStyles collection of the legend. Each interlace style is represented by a NLegendInterlaceStyle object controlling the interlace stripes appearance and orientation (row / column). Furthermore the interlace stripes have Z order - stipes generated by interlace styles on top of the collection appear below interlace stripes generated by the styles afterwards. The following code creates two row interlace styles with gradient filling:

C#
Copy Code
NLegend legend = chartControl.Legends[0];

// switch to manual mode
legend.Mode = LegendMode.Manual;

// feed some data
for (int i = 0; i < 60; i++)
{
        NLegendItemCellData ldi = new NLegendItemCellData();
        ldi.Text = "Legend Data Item " + i.ToString();
        ldi.MarkShape = LegendMarkShape.None;
        ldi.MarkLineStyle.Width = new NLength(0);
        legend.Data.Items.Add(ldi);
}

// apply expand strategy
legend.Data.ExpandMode = LegendExpandMode.ColsFixed;
legend.Data.ColCount = 4;

// apply row interlacing
NLegendInterlaceStyle rowInterlaceStyle = new NLegendInterlaceStyle();
rowInterlaceStyle.Type = LegendInterlaceStyleType.Row;
rowInterlaceStyle.FillStyle = new NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.SpringGreen, Color.Teal);
rowInterlaceStyle.Interval = 2;
rowInterlaceStyle.Length = 2;
legend.InterlaceStyles.Add(rowInterlaceStyle);

// apply row interlacing
rowInterlaceStyle = new NLegendInterlaceStyle();
rowInterlaceStyle.Type = LegendInterlaceStyleType.Row;
rowInterlaceStyle.FillStyle = new NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.LightBlue, Color.RoyalBlue);
rowInterlaceStyle.Begin = 2;
rowInterlaceStyle.Interval = 2;
rowInterlaceStyle.Length = 2;
legend.InterlaceStyles.Add(rowInterlaceStyle);
Visual Basic
Copy Code
Dim legend As NLegend = chartControl.Legends(0)

' switch to manual mode
legend.Mode = LegendMode.Manual

' feed some data
For i As Integer = 0 To 59
    Dim ldi As New NLegendItemCellData
    ldi.Text = "Legend Data Item " + i.ToString()
    ldi.MarkShape = LegendMarkShape.None
    ldi.MarkLineStyle.Width = New NLength(0)

    legend.Data.Items.Add(ldi)
Next i

' apply expand strategy
legend.Data.ExpandMode = LegendExpandMode.ColsFixed
legend.Data.ColCount = 4

' apply row interlacing
Dim rowInterlaceStyle As New NLegendInterlaceStyle
rowInterlaceStyle.Type = LegendInterlaceStyleType.Row
rowInterlaceStyle.FillStyle = New NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.SpringGreen, Color.Teal)
rowInterlaceStyle.Interval = 2
rowInterlaceStyle.Length = 2
legend.InterlaceStyles.Add(rowInterlaceStyle)

' apply row interlacing
rowInterlaceStyle = New NLegendInterlaceStyle
rowInterlaceStyle.Type = LegendInterlaceStyleType.Row
rowInterlaceStyle.FillStyle = New NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.LightBlue, Color.RoyalBlue)
rowInterlaceStyle.Begin = 2
rowInterlaceStyle.Interval = 2
rowInterlaceStyle.Length = 2
legend.InterlaceStyles.Add(rowInterlaceStyle)

This code will produce the following legend appearance:

Now lets add a column interlace style with that appears on top of the row interlace styles and highlights the first row with a white to red vertical gradient:

C#
Copy Code
// apply column interlacing
NLegendInterlaceStyle columnInterlaceStyle = new NLegendInterlaceStyle();
columnInterlaceStyle.Type = LegendInterlaceStyleType.Col;
columnInterlaceStyle.FillStyle = new NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.White, Color.Red);
columnInterlaceStyle.Infinite = false;
columnInterlaceStyle.End = 1;
legend.InterlaceStyles.Add(columnInterlaceStyle);
Example Title
Copy Code
' apply column interlacing
Dim columnInterlaceStyle As New NLegendInterlaceStyle
columnInterlaceStyle.Type = LegendInterlaceStyleType.Col
columnInterlaceStyle.FillStyle = New NGradientFillStyle(GradientStyle.Horizontal, GradientVariant.Variant1, Color.White, Color.Red)
columnInterlaceStyle.Infinite = False
columnInterlaceStyle.End = 1
legend.InterlaceStyles.Add(columnInterlaceStyle)

The legend appearance will now change to:

Related Examples

Windows Forms \ Panels \ Legend

Web Forms \ Panels \ Legend

See Also

 

 


©2017. Nevron Software LLC.

Send Feedback