Sur cette page

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

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.

Diagramme de dispersion représentant trois séries sous forme de marqueurs en forme de cercle, de carré et d'étoile répartis sur le graphique

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.

ConstanteValeurDescription
QScatterSeries::MarkerShapeCircle0Le marqueur est un cercle. Il s'agit de la valeur par défaut.
QScatterSeries::MarkerShapeRectangle1Le marqueur est un rectangle.
QScatterSeries::MarkerShapeRotatedRectangle2Le marqueur est un rectangle pivoté.
QScatterSeries::MarkerShapeTriangle3Le marqueur est un triangle.
QScatterSeries::MarkerShapeStar4Le marqueur est une étoile.
QScatterSeries::MarkerShapePentagon5Le 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.