Point Series

In This Topic

Point Charts display data as points in a Cartesian coordinate system. The data for the point chart can contain Y, XY, or XYZ coordinates. Optionally, each data point can also contain color and size data that differentiates it from the rest of the data points in the chart. The following images show an XY and XYZ scatter point charts:

Creating a Point Series

Point series are represented by the NPointSeries type. An instance of this type must be added to the series collection of a Cartesian chart:

C#	Copy Code
NPointSeries point = new NPointSeries(); chart.Series.Add(point);

Passing Data

Point series accept data points of type NPointDataPoint. The following code snippet shows how to add data to a point series:

C#	Copy Code
// enable x values point.UseXValues = true; // add data point NPointDataPoint pointDataPoint = new NPointDataPoint(); pointDataPoint.Value = 10; pointDataPoint.X = 10; point.DataPoints.Add(pointDataPoint);

Copy Code

// enable x values
point.UseXValues = true;
// add data point
NPointDataPoint pointDataPoint = new NPointDataPoint();
pointDataPoint.Value = 10;
pointDataPoint.X = 10;
point.DataPoints.Add(pointDataPoint);

Controlling the Points Shape

The point series allows you to modify the point shape of all the data points in the series as well as individual data points. The following code snippet shows how to create a point series where all points use ellipse shape except the first one which uses a rectangle:

C#	Copy Code
NPointSeries point = new NPointSeries(); chart.Series.Add(point); // disable data labels point.DataLabelStyle = new NDataLabelStyle(false); // enable x values point.UseXValues = true; // change the default shape to ellipse point.Shape = ENPointShape3D.Ellipse; // add data point 1 NPointDataPoint dataPoint0 = new NPointDataPoint(0, 0); dataPoint0.Shape = ENPointShape3D.Rectangle; point.DataPoints.Add(dataPoint0); // add data point 1 point.DataPoints.Add(new NPointDataPoint(10, 10)); // add data point 2 point.DataPoints.Add(new NPointDataPoint(20, 20));

Copy Code

NPointSeries point = new NPointSeries();
chart.Series.Add(point);
// disable data labels
point.DataLabelStyle = new NDataLabelStyle(false);
// enable x values
point.UseXValues = true;
// change the default shape to ellipse
point.Shape = ENPointShape3D.Ellipse;
// add data point 1
NPointDataPoint dataPoint0 = new NPointDataPoint(0, 0);
dataPoint0.Shape = ENPointShape3D.Rectangle;
point.DataPoints.Add(dataPoint0);
// add data point 1
point.DataPoints.Add(new NPointDataPoint(10, 10));
// add data point 2
point.DataPoints.Add(new NPointDataPoint(20, 20));

Controlling the Points Size

The point size is controlled from the Size property of the NPointSeries. The following code modifies the size so that points are 10dips wide and tall:

C#	Copy Code
point.Size = 10;