QScatterSeries Class

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

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

Public Types

enum MarkerShape { MarkerShapeCircle, MarkerShapeRectangle }

Properties

Public Functions

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

Reimplemented Public Functions

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

Signals

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

Detailed Description

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.

ConstantValueDescription
QScatterSeries::MarkerShapeCircle0The marker is a circle. This is the default value.
QScatterSeries::MarkerShapeRectangle1The 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) override

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 override
virtual void setColor(const QColor &color) override

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:

QScatterSeries::MarkerShape markerShape() const
void setMarkerShape(QScatterSeries::MarkerShape shape)

Notifier signal:

void markerShapeChanged(QScatterSeries::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 = nullptr)

Constructs a series object that is a child of parent.

[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(QScatterSeries::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] QScatterSeries::~QScatterSeries()

Deletes the scatter series.

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

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

Reimplements: QXYSeries::setBrush(const QBrush &brush).

See also brush().

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

Reimplements: QXYSeries::setPen(const QPen &pen).

[override virtual] QAbstractSeries::SeriesType QScatterSeries::type() const

Reimplements an access function for property: QAbstractSeries::type.

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.