Qt 5.9 | Qt Charts | C++ Classes | QScatterSeries

Qt 5.9.3 Reference Documentation

# QScatterSeries Class

The QScatterSeries class presents data in scatter charts. More...

Header: | #include <QScatterSeries>
Instantiated By: | ScatterSeries
Inherits: | QXYSeries

- List of all members, including inherited members

## Public Types

enum | MarkerShape { MarkerShapeCircle, MarkerShapeRectangle }

## Properties

borderColor : QColor brush : QBrush color : QColor | markerShape : MarkerShape markerSize : qreal

- 7 properties inherited from QXYSeries
- 5 properties inherited from QAbstractSeries

## Public Functions

| QScatterSeries(QObject *parent = Q_NULLPTR)
| ~QScatterSeries()
QColor | borderColor() const
QBrush | brush() const
MarkerShape | markerShape() const
qreal | markerSize() const
void | setBorderColor(const QColor &color)
void | setMarkerShape(MarkerShape shape)
void | setMarkerSize(qreal size)

## Reimplemented Public Functions

virtual QColor | color() const
virtual void | setBrush(const QBrush &brush)
virtual void | setColor(const QColor &color)
virtual void | setPen(const QPen &pen)
virtual QAbstractSeries::SeriesType | type() const

- 39 public functions inherited from QXYSeries
- 15 public functions inherited from QAbstractSeries

## Signals

void | borderColorChanged(QColor color)
void | colorChanged(QColor color)
void | markerShapeChanged(MarkerShape shape)
void | markerSizeChanged(qreal size)

- 17 signals inherited from QXYSeries
- 4 signals inherited from QAbstractSeries

## Detailed Description

The QScatterSeries class presents data in scatter charts.

The scatter data is displayed as a collection of points on the chart. For each point, two values are specified that determine its position on the horizontal axis and the vertical axis.

The following code snippet illustrates how to create a basic scatter chart:

      QScatterSeries* series = new QScatterSeries();
      series->append(0, 6);
      series->append(2, 4);
      ...
      chart->addSeries(series);

For more information, see ScatterChart Example and Scatter Interactions Example.

## Member Type Documentation

### enum QScatterSeries::MarkerShape

This enum value describes the shape used when rendering marker items.

Constant | Value | Description
--- | --- | ---
`QScatterSeries::MarkerShapeCircle` | `0` | The marker is a circle. This is the default value.
`QScatterSeries::MarkerShapeRectangle` | `1` | The marker is a rectangle.

## Property Documentation

### borderColor : QColor

This property holds the color used to draw the marker borders.

This is a convenience property for modifying the color of the pen.

Access functions:

QColor | borderColor() const
void | setBorderColor(const QColor &color)

Notifier signal:

void | borderColorChanged(QColor color)

See also QScatterSeries::pen().

### brush : QBrush

This property holds the brush used to draw the scatter series markers.

The brush can be an image that can be created using QPainterPath, for example.

Access functions:

QBrush | brush() const
virtual void | setBrush(const QBrush &brush)

### color : QColor

This property holds the color used to fill the series markers.

This is a convenience property for modifying the color of the brush.

Access functions:

virtual QColor | color() const
virtual void | setColor(const QColor &color)

Notifier signal:

void | colorChanged(QColor color)

See also QScatterSeries::brush().

### markerShape : MarkerShape

This property holds the shape of the marker used to render the points in the series.

The default shape is MarkerShapeCircle.

Access functions:

MarkerShape | markerShape() const
void | setMarkerShape(MarkerShape shape)

Notifier signal:

void | markerShapeChanged(MarkerShape shape)

See also MarkerShape.

### markerSize : qreal

This property holds the size of the marker used to render the points in the series.

The default size is 15.0.

Access functions:

qreal | markerSize() const
void | setMarkerSize(qreal size)

Notifier signal:

void | markerSizeChanged(qreal size)

## Member Function Documentation

### QScatterSeries::QScatterSeries(QObject *parent = Q_NULLPTR)

Constructs a series object that is a child of parent.

### QScatterSeries::~QScatterSeries()

Deletes the scatter series.

Note: Adding the series to QChart transfers the ownership to the chart.

### `[signal]` void QScatterSeries::borderColorChanged(QColor color)

This signal is emitted when the line (pen) color changes to color.

Note: Notifier signal for property borderColor.

### `[signal]` void QScatterSeries::colorChanged(QColor color)

This signal is emitted when the fill (brush) color changes to color.

Note: Notifier signal for property color.

### `[signal]` void QScatterSeries::markerShapeChanged(MarkerShape shape)

This signal is emitted when the marker shape changes to shape.

Note: Notifier signal for property markerShape.

### `[signal]` void QScatterSeries::markerSizeChanged(qreal size)

This signal is emitted when the marker size changes to size.

Note: Notifier signal for property markerSize.

### `[virtual]` void QScatterSeries::setBrush(const QBrush &brush)

Reimplemented from QXYSeries::setBrush().

Note: Setter function for property brush.

See also brush().

### `[virtual]` void QScatterSeries::setPen(const QPen &pen)

Reimplemented from QXYSeries::setPen().

### `[virtual]` QAbstractSeries::SeriesType QScatterSeries::type() const

Reimplemented from QAbstractSeries::type().