QScatterSeries Class
La classe QScatterSeries permet de représenter des données sous forme de graphiques de nuages de points. En savoir plus...
| Header: | #include <QScatterSeries> |
| In QML: | ScatterSeries |
| Inherits: | QXYSeries |
| Status: | Deprecated |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | MarkerShape { MarkerShapeCircle, MarkerShapeRectangle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, MarkerShapeStar, MarkerShapePentagon } |
Propriétés
- borderColor : QColor
- brush : QBrush
- markerShape : MarkerShape
- markerSize : qreal
Fonctions publiques
| 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) |
Fonctions publiques réimplémentées
| virtual void | setBrush(const QBrush &brush) override |
| virtual void | setPen(const QPen &pen) override |
| virtual QAbstractSeries::SeriesType | type() const override |
Signaux
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | markerShapeChanged(QScatterSeries::MarkerShape shape) |
| void | markerSizeChanged(qreal size) |
Description détaillée
Les données du nuage de points sont affichées sous forme d'un ensemble de points sur le graphique. Pour chaque point, deux valeurs sont spécifiées afin de déterminer sa position sur l'axe horizontal et sur l'axe vertical.

L'extrait de code suivant illustre comment créer un graphique de nuage de points basique :
QScatterSeries* series = new QScatterSeries();
series->append(0, 6);
series->append(2, 4);
...
chart->addSeries(series);Pour plus d’informations, consultez les sections « Graphiques avec la galerie de widgets » et « Création de graphiques en nuage de points ».
Documentation sur les types de membres
enum QScatterSeries::MarkerShape
Cette valeur d'énumération décrit la forme utilisée lors du rendu des marqueurs.
| Constante | Valeur | Description |
|---|---|---|
QScatterSeries::MarkerShapeCircle | 0 | Le marqueur est un cercle. Il s'agit de la valeur par défaut. |
QScatterSeries::MarkerShapeRectangle | 1 | Le marqueur est un rectangle. |
QScatterSeries::MarkerShapeRotatedRectangle | 2 | Le marqueur est un rectangle pivoté. |
QScatterSeries::MarkerShapeTriangle | 3 | Le marqueur est un triangle. |
QScatterSeries::MarkerShapeStar | 4 | Le marqueur est une étoile. |
QScatterSeries::MarkerShapePentagon | 5 | Le marqueur est un pentagone. |
Documentation sur les propriétés
borderColor : QColor
Cette propriété définit la couleur utilisée pour tracer les contours du marqueur.
Il s'agit d'une propriété pratique permettant de modifier la couleur du stylo.
Fonctions d'accès :
| QColor | borderColor() const |
| void | setBorderColor(const QColor &color) |
Signal de notification :
| void | borderColorChanged(QColor color) |
Voir également QScatterSeries::pen().
brush : QBrush
Cette propriété contient le pinceau utilisé pour dessiner les marqueurs de la série de points.
Le pinceau peut être une image créée à l'aide d'QPainterPath, par exemple.
Fonctions d'accès :
| QBrush | brush() const |
| virtual void | setBrush(const QBrush &brush) override |
markerShape : MarkerShape
Cette propriété définit la forme du marqueur utilisé pour afficher les points de la série.
La forme par défaut est MarkerShapeCircle.
Fonctions d'accès :
| QScatterSeries::MarkerShape | markerShape() const |
| void | setMarkerShape(QScatterSeries::MarkerShape shape) |
Signal de notification :
| void | markerShapeChanged(QScatterSeries::MarkerShape shape) |
Voir aussi MarkerShape.
markerSize : qreal
Cette propriété indique la taille du marqueur utilisé pour afficher les points de la série.
Fonctions d'accès :
| qreal | markerSize() const |
| void | setMarkerSize(qreal size) |
Signal de notification :
| void | markerSizeChanged(qreal size) |
Voir également QXYSeries::setMarkerSize.
Documentation des fonctions membres
[explicit] QScatterSeries::QScatterSeries(QObject *parent = nullptr)
Crée un objet de série qui est un enfant de parent.
[virtual noexcept] QScatterSeries::~QScatterSeries()
Supprime la série de points.
Remarque : l'ajout de la série à QChart transfère la propriété à la courbe.
[signal] void QScatterSeries::borderColorChanged(QColor color)
Ce signal est émis lorsque la couleur du trait (stylo) passe à color.
Remarque : signalde notification pour la propriété borderColor.
[signal] void QScatterSeries::colorChanged(QColor color)
Ce signal est émis lorsque la couleur de remplissage (pinceau) passe à color.
[signal] void QScatterSeries::markerShapeChanged(QScatterSeries::MarkerShape shape)
Ce signal est émis lorsque la forme du marqueur passe à « shape ».
Remarque : signalde notification pour la propriété markerShape.
[signal] void QScatterSeries::markerSizeChanged(qreal size)
Ce signal est émis lorsque la taille du marqueur passe à « size ».
Remarque : signalde notification pour la propriété markerSize.
[override virtual] void QScatterSeries::setBrush(const QBrush &brush)
Réimplémente : QXYSeries::setBrush(const QBrush &brush).
Voir également brush().
[override virtual] void QScatterSeries::setPen(const QPen &pen)
Réimplémente : QXYSeries::setPen(const QPen &pen).
[override virtual] QAbstractSeries::SeriesType QScatterSeries::type() const
Réimplémente une fonction d'accès pour la propriété : QAbstractSeries::type.
© 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.