ComponentOne Chart for .NET (2.0) Search HelpCentral 

Defining the Legend Element

The following graphic illustrates the Legend element in C1Chart.

The legend element displays information about each data series of the chart. The chart legend displays the mapping between the physical colors and the data series. The legend is controlled by the Legend property, which returns a Legend object with the following main properties:

Property

Description

Text

Contains text displayed in the legend title.

Style

Contains properties that set the font, orientation, colors, and border of the legend.

Compass

Determines the position of the legend.

Visible

Determines whether the legend is visible.

Orientation

Determines whether the legend items should be displayed in the horizontal or vertical direction.

Reversed

Controls the order that the ChartGroups appear in the legend. The order in which items of a ChartGroup appear in the legend is controlled by the LegendReversed property of each ChartGroup.

C1Chart sizes and positions the legend automatically, based on its contents and the Compass and Orientation properties. To customize the legend position, the SizeDefault and LocationDefault properties can be modified (negative values activate the automatic sizing and positioning).

Note that the Legend property does not control the text for each legend item. It is determined by the label attached to each series. For example, Label contains the text and LegendEntry determines whether the series label should be displayed in the legend.

Creating the legend element

The legend element can be created programmatically through its Legend object or they can be created at design time through the Chart's Properties window, Chart Properties designer, or by Chart's SmartDesigner.

The simplest way of creating them is through the Chart's SmartDesigner. For more information on creating a chart legend through the Chart's SmartDesigner, see Add a Chart Legend.


Send comments about this topic to ComponentOne.
Copyright © ComponentOne LLC. All rights reserved.