Represents the legend for the chart image.
Legend class represents a single chart legend. It contains visual appearance, position and content properties. Legend class is also responible for drawing and positionning of the legend.
Object Model
  _247.gif)    _247.gif)  |
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Class Legend Inherits ChartElement | |
| Visual Basic (Usage) |  Copy Code |
|---|---|
| |
| C# | |
|---|---|
public class Legend : ChartElement | |
Remarks
The Legend class encapsulates all the functionality of the Chart control's legend, and is exposed using the Legends Collection of the root Chart object.
There can be any number of legends for a chart image.
Legend items are either default or custom items, and are represented by LegendItem objects. Default items are by default automatically added to the legend, and are the names of the plotted data points for doughnut and pie charts. For all other chart types the default items are the names of the plotted data series.
Custom entries are not associated with data, and can be added, deleted and modified using the CustomItems property.
Legend symbols are either rectangles, dots or lines. This is set automatically by the Chart control, and depends on the plotted chart type.
The legend can be modified using the CustomizeLegend event (Enterprise Edition only).
Legends can:
-
Be displayed inside or outside of plotted chart areas.
-
Automatically fit their contents.
-
Use a pre-defined style (e.g. row, column or table).
-
Use hatching, gradient colors and background images.
-
Be sized and positioned anywhere within the chart image.
Inheritance Hierarchy
System.Object
Dundas.Charting.WebControl.ChartElement
Dundas.Charting.WebControl.Legend
Requirements
Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family