ChartDirector 6.3 (C++ Edition)



ScatterLayer *addScatterLayer(DoubleArray xData, DoubleArray yData, const char *name = 0, int symbol = SquareShape, int symbolSize = 5, int fillColor = -1, int edgeColor = -1);


Adds a scatter chart layer to the XYChart.

A scatter chart can be considered as a special configuration of a line chart, in the data symbols are enabled and the line width is set to zero. Therefore only the data symbols are visible and the chart appears as scattered.


xData(Mandatory)An array of numbers representing the x values of the data points. If no explicit x coordinates are used in the chart (eg. using an enumerated x-axis), an empty array may be used for this argument.
yData(Mandatory)An array of numbers representing the y values of the data points.
name""The name of the data set. The name will be used in the legend box, if one is available. An empty string means the data set has no name.
symbolSquareShapeOne of the predefined symbol constants to specify the symbol to use. (See Shape Specification for available built-in shapes.)
symbolSize5The width and height of the symbol in pixels.
fillColor-1The color used to fill the symbol. -1 means that the color is automatically selected from the palette.
edgeColor-1The edge color used to draw the edge of the symbol. -1 means using LineColor as the edge color.

Return Value

A ScatterLayer object representing the scatter layer created.