ChartDataSeries Object

The following illustration shows five Chart Data Series on C1Chart.

From a developer’s perspective, this is one of the most important properties in C1Chart. All other properties can be set at design time using the Chart Wizard, Chart Properties designer, or loaded from predefined chart layout files. In most cases, however, the data being plotted is added using code, and to do that you need to use the SeriesList property.

The SeriesList property returns a ChartDataSeriesCollection object that allows you to add and remove series from the chart, and to retrieve individual series. For example, the following code clears all the data in the group and then adds three new series to it.

· Visual Basic

Dim cdc As ChartDataSeriesCollection = C1Chart1.ChartGroups(0).ChartData.SeriesList

cdc.Clear()

Dim i As Integer

For i = 0 To 2

cdc.AddNewSeries()

cdc(i).Label = "Series " + i.ToString()

Next i

· C#

ChartDataSeriesCollection cdc = c1Chart1.ChartGroups[0].ChartData.SeriesList;

cdc.Clear();

for (int i = 0; i < 3; i++)

{

cdc.AddNewSeries();

cdc[i].Label = "Series " + i.ToString();

}

· Delphi

var

cdc: ChartDataSeriesCollection;

i: Integer;

begin

cdc := C1Chart1.ChartGroups[0].ChartData.SeriesList;

cdc.Clear();

for i := 0 to 2 do

begin

cdc.AddNewSeries();

cdc[i].Label = 'Series ' + i.ToString();

end;

After executing this code, the first ChartGroup will contain three ChartDataSeries objects, each with a different label.

The ChartDataSeries objects have the following main properties:

Property	Description
Display	Determines whether the series is visible and how missing values (“data holes”) should be displayed.
Label	Contains the text that is displayed in the legend (if LegendEntry is set to True).
LegendEntry	Determines whether the series Label should be displayed in the legend.
LineStyle	Contains properties that determine the color, thickness, and pattern used to display the series (the color is used for lines, areas, bars, and pie slices).
SymbolStyle	Contains properties that determine the shape, size, and color of the symbols used to mark the data points in the series.
PointData	Returns a ChartDataArray object used to get or set the X, Y coordinates of each data point in the series.
X, Y	Return ChartDataArray objects used to get or set individual coordinates of each data point in the series. Some chart types have additional data arrays (for example, “HiLoOpenClose” also has Y1, Y2, and Y3).

The PointData, X, and Y properties allow you to set and retrieve the data used to display each individual series.

Most chart types require you to provide X and Y values for each point. The exceptions are pie charts (which do not require X values) and specialized charts such as Bubble, HiLo, Gantt, and HiLoClose, which require additional Y values.