Auf dieser Seite

QScatterSeries Class

Die Klasse „QScatterSeries“ stellt Daten in Streudiagrammen dar. Mehr...

Header: #include <QScatterSeries>
In QML: ScatterSeries
Inherits: QXYSeries
Status: Deprecated

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Typen

enum MarkerShape { MarkerShapeCircle, MarkerShapeRectangle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, MarkerShapeStar, MarkerShapePentagon }

Eigenschaften

Öffentliche Funktionen

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)

Neu implementierte öffentliche Funktionen

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

Signale

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

Detaillierte Beschreibung

Die Streudaten werden im Diagramm als Punktwolke dargestellt. Für jeden Punkt werden zwei Werte angegeben, die seine Position auf der horizontalen und der vertikalen Achse bestimmen.

Streudiagramm, in dem drei Zeitreihen als Kreis-, Quadrat- und Sternsymbole über das Diagramm verteilt dargestellt werden

Der folgende Codeausschnitt veranschaulicht, wie ein einfaches Streudiagramm erstellt wird:

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

Weitere Informationen finden Sie unter „Diagramme mit Widgets – Galerie “ und „Erstellen von Streudiagrammen“.

Dokumentation zu Mitgliedstypen

enum QScatterSeries::MarkerShape

Dieser Enum-Wert beschreibt die Form, die beim Rendern von Marker-Elementen verwendet wird.

KonstanteWertBeschreibung
QScatterSeries::MarkerShapeCircle0Die Markierung ist ein Kreis. Dies ist der Standardwert.
QScatterSeries::MarkerShapeRectangle1Die Markierung ist ein Rechteck.
QScatterSeries::MarkerShapeRotatedRectangle2Die Markierung ist ein gedrehtes Rechteck.
QScatterSeries::MarkerShapeTriangle3Die Markierung ist ein Dreieck.
QScatterSeries::MarkerShapeStar4Die Markierung ist ein Stern.
QScatterSeries::MarkerShapePentagon5Die Markierung ist ein Fünfeck.

Dokumentation zu den Eigenschaften

borderColor : QColor

Diese Eigenschaft enthält die Farbe, die zum Zeichnen der Markierungsränder verwendet wird.

Dies ist eine Komfort-Eigenschaft zum Ändern der Stiftfarbe.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void borderColorChanged(QColor color)

Siehe auch „ QScatterSeries::pen()“.

brush : QBrush

Diese Eigenschaft enthält den Pinsel, der zum Zeichnen der Markierungen der Streureihe verwendet wird.

Der Pinsel kann beispielsweise ein Bild sein, das mit QPainterPath erstellt wurde.

Zugriffsfunktionen:

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

markerShape : MarkerShape

Diese Eigenschaft enthält die Form des Markers, der zum Darstellen der Punkte in der Reihe verwendet wird.

Die Standardform ist „ MarkerShapeCircle “.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

void markerShapeChanged(QScatterSeries::MarkerShape shape)

Siehe auch „ MarkerShape “.

markerSize : qreal

Diese Eigenschaft gibt die Größe des Markers an, der zum Darstellen der Punkte in der Reihe verwendet wird.

Zugriffsfunktionen:

qreal markerSize() const
void setMarkerSize(qreal size)

Benachrichtigungssignal:

void markerSizeChanged(qreal size)

Siehe auch „ QXYSeries::setMarkerSize “.

Dokumentation zu den Member-Funktionen

[explicit] QScatterSeries::QScatterSeries(QObject *parent = nullptr)

Erstellt ein Serienobjekt, das ein untergeordnetes Objekt von parent ist.

[virtual noexcept] QScatterSeries::~QScatterSeries()

Löscht die Streudiagramm-Reihe.

Hinweis: Durch das Hinzufügen der Reihe zu QChart geht das Eigentumsrecht auf das Diagramm über.

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

Dieses Signal wird ausgelöst, wenn sich die Linienfarbe (Stiftfarbe) auf „ color “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ borderColor “.

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

Dieses Signal wird ausgelöst, wenn sich die Füllfarbe (Pinsel) in „ color “ ändert.

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

Dieses Signal wird ausgegeben, wenn sich die Markerform in „ shape “ ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft „ markerShape “.

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

Dieses Signal wird ausgelöst, wenn sich die Größe des Markers auf „ size “ ändert.

Hinweis: Notifier -Signal für die Eigenschaft „ markerSize “.

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

Implementiert neu: QXYSeries::setBrush(const QBrush &brush).

Siehe auch brush().

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

Implementiert: ` QXYSeries::setPen` (const QPen &pen).

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QAbstractSeries::type “ neu.

© 2026 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.