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
- borderColor : QColor
- brush : QBrush
- markerShape : MarkerShape
- markerSize : qreal
Ö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.

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.
| Konstante | Wert | Beschreibung |
|---|---|---|
QScatterSeries::MarkerShapeCircle | 0 | Die Markierung ist ein Kreis. Dies ist der Standardwert. |
QScatterSeries::MarkerShapeRectangle | 1 | Die Markierung ist ein Rechteck. |
QScatterSeries::MarkerShapeRotatedRectangle | 2 | Die Markierung ist ein gedrehtes Rechteck. |
QScatterSeries::MarkerShapeTriangle | 3 | Die Markierung ist ein Dreieck. |
QScatterSeries::MarkerShapeStar | 4 | Die Markierung ist ein Stern. |
QScatterSeries::MarkerShapePentagon | 5 | Die 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.