QAreaSeries Class
La classe QAreaSeries permet d'afficher des données sous forme de graphiques en aires. En savoir plus...
| Header: | #include <QAreaSeries> |
| In QML: | AreaSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
|
|
Fonctions publiques
| QAreaSeries(QObject *parent = nullptr) | |
| QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr) | |
| virtual | ~QAreaSeries() |
| QColor | borderColor() const |
| QBrush | brush() const |
| QColor | color() const |
| QLineSeries * | lowerSeries() const |
| QPen | pen() const |
| bool | pointLabelsClipping() const |
| QColor | pointLabelsColor() const |
| QFont | pointLabelsFont() const |
| QString | pointLabelsFormat() const |
| bool | pointLabelsVisible() const |
| bool | pointsVisible() const |
| void | setBorderColor(const QColor &color) |
| void | setBrush(const QBrush &brush) |
| void | setColor(const QColor &color) |
| void | setLowerSeries(QLineSeries *series) |
| void | setPen(const QPen &pen) |
| void | setPointLabelsClipping(bool enabled = true) |
| void | setPointLabelsColor(const QColor &color) |
| void | setPointLabelsFont(const QFont &font) |
| void | setPointLabelsFormat(const QString &format) |
| void | setPointLabelsVisible(bool visible = true) |
| void | setPointsVisible(bool visible = true) |
| void | setUpperSeries(QLineSeries *series) |
| QLineSeries * | upperSeries() const |
Fonctions publiques réimplémentées
| virtual QAbstractSeries::SeriesType | type() const override |
Signaux
| void | borderColorChanged(QColor color) |
| void | clicked(const QPointF &point) |
| void | colorChanged(QColor color) |
| void | doubleClicked(const QPointF &point) |
| void | hovered(const QPointF &point, bool state) |
| void | pointLabelsClippingChanged(bool clipping) |
| void | pointLabelsColorChanged(const QColor &color) |
| void | pointLabelsFontChanged(const QFont &font) |
| void | pointLabelsFormatChanged(const QString &format) |
| void | pointLabelsVisibilityChanged(bool visible) |
| void | pressed(const QPointF &point) |
| void | released(const QPointF &point) |
Description détaillée
Une série de surface sert à représenter des données quantitatives. Elle repose sur une série de lignes, en ce sens que la surface délimitée par les lignes de délimitation est mise en évidence par une couleur. La série de surface étant basée sur la série de lignes, le constructeur QAreaSeries nécessite une instance de QLineSeries, qui définit la limite supérieure de la surface. Par défaut, le graphique de surface est tracé en utilisant le bas de la zone de tracé comme limite inférieure. Au lieu du bas de la zone de tracé, la limite inférieure peut être spécifiée par une autre ligne. Dans ce cas, QAreaSeries doit être initialisé avec deux instances d'QLineSeries.
Remarque : les termes « limite supérieure » et « limite inférieure » peuvent prêter à confusion dans les cas où la valeur de la limite inférieure est supérieure à celle de la limite supérieure. L'essentiel est que la zone comprise entre ces deux lignes de délimitation soit remplie.
Consultez la galerie « Graphiques avec widgets » pour découvrir comment créer un graphique en aires simple.
Documentation sur les propriétés
borderColor : QColor
Cette propriété définit la couleur de la ligne (du trait) de la série. Il s'agit d'une propriété pratique permettant de modifier la couleur du trait.
Fonctions d'accès :
| QColor | borderColor() const |
| void | setBorderColor(const QColor &color) |
Signal de notification :
| void | borderColorChanged(QColor color) |
Voir également QAreaSeries::pen().
color : QColor
Cette propriété définit la couleur de remplissage (pinceau) de la série. Il s'agit d'une propriété pratique permettant de modifier la couleur du pinceau.
Fonctions d'accès :
| QColor | color() const |
| void | setColor(const QColor &color) |
Signal de notification :
| void | colorChanged(QColor color) |
Voir également QAreaSeries::brush().
[read-only] lowerSeries : QLineSeries*
Cette propriété contient la série de lignes la plus basse parmi les deux utilisées pour définir les limites d'une série de zones.
Remarque : si l'objet « QAreaSeries » a été créé sans paramètre « lowerSeries », cette propriété est nulle.
Fonctions d'accès :
| QLineSeries * | lowerSeries() const |
pointLabelsClipping : bool
Cette propriété définit le découpage des étiquettes des points de données. Valeur par défaut : True. Lorsque le découpage est activé, les étiquettes situées au bord de la zone de tracé sont coupées.
Fonctions d'accès :
| bool | pointLabelsClipping() const |
| void | setPointLabelsClipping(bool enabled = true) |
Signal de notification :
| void | pointLabelsClippingChanged(bool clipping) |
Voir également pointLabelsVisible.
pointLabelsColor : QColor
Cette propriété détermine la couleur utilisée pour les étiquettes des points de données. Par défaut, cette couleur correspond à celle du pinceau défini pour les étiquettes dans le thème.
Fonctions d'accès :
| QColor | pointLabelsColor() const |
| void | setPointLabelsColor(const QColor &color) |
Signal de notification :
| void | pointLabelsColorChanged(const QColor &color) |
Voir également QAreaSeries::pointLabelsFormat.
pointLabelsFont : QFont
Cette propriété contient la police utilisée pour les libellés des points de données.
Fonctions d'accès :
| QFont | pointLabelsFont() const |
| void | setPointLabelsFont(const QFont &font) |
Signal de notification :
| void | pointLabelsFontChanged(const QFont &font) |
Voir aussi QAreaSeries::pointLabelsFormat.
pointLabelsFormat : QString
Cette propriété définit le format utilisé pour afficher les étiquettes associées aux points d'une série.
QAreaSeries Elle prend en charge les balises de format suivantes :
| @xPoint | La valeur x du point de données |
| @yPoint | La valeur y du point de données |
Par exemple, l'utilisation suivante des balises de format générerait des étiquettes affichant le point de données (x, y) entre parenthèses et séparées par une virgule :
series->setPointLabelsFormat("(@xPoint, @yPoint)");Par défaut, le format des étiquettes est défini sur « @xPoint, @yPoint ». Les étiquettes s'affichent dans la zone du graphique, tandis que celles situées en bordure de cette zone sont tronquées. Si les points sont proches les uns des autres, les étiquettes peuvent se chevaucher.
Fonctions d'accès :
| QString | pointLabelsFormat() const |
| void | setPointLabelsFormat(const QString &format) |
Signal de notification :
| void | pointLabelsFormatChanged(const QString &format) |
Voir également QAreaSeries::pointLabelsVisible, QAreaSeries::pointLabelsFont et QAreaSeries::pointLabelsColor.
pointLabelsVisible : bool
Cette propriété définit la visibilité des étiquettes des points de données. Valeur par défaut : « False ».
Fonctions d'accès :
| bool | pointLabelsVisible() const |
| void | setPointLabelsVisible(bool visible = true) |
Signal de notification :
| void | pointLabelsVisibilityChanged(bool visible) |
Voir également QAreaSeries::pointLabelsFormat et QAreaSeries::pointLabelsClipping.
[read-only] upperSeries : QLineSeries*
Cette propriété contient la ligne supérieure des deux séries de lignes utilisées pour définir les limites d'une série de zones.
Fonctions d'accès :
| QLineSeries * | upperSeries() const |
Documentation sur les fonctions de membre
[explicit] QAreaSeries::QAreaSeries(QObject *parent = nullptr)
Crée un objet de série d'aire sans série supérieure ni série inférieure à l'aide de l'objet ` parent `.
[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
Crée un objet de série d'aire qui s'étendra entre une ligne « upperSeries » et une ligne « lowerSeries ». Si aucune coordonnée « lowerSeries » n'est transmise au constructeur, l'axe des x est alors utilisé comme limite inférieure.
La classe `QAreaSeries` ne détient pas la propriété des séries supérieure et inférieure ; celle-ci reste la propriété de l'appelant. Lorsque l'objet de série est ajouté à `QChartView` ou à `QChart`, la propriété de l'instance est transférée.
[virtual noexcept] QAreaSeries::~QAreaSeries()
Détruit l'objet.
[signal] void QAreaSeries::borderColorChanged(QColor color)
Ce signal est émis lorsque la couleur du trait (stylo) passe à color.
Remarque : signalde notification pour la propriété borderColor.
QBrush QAreaSeries::brush() const
Renvoie le pinceau utilisé pour tracer la ligne de cette série.
Voir aussi setBrush().
[signal] void QAreaSeries::clicked(const QPointF &point)
Ce signal est émis lorsque l'utilisateur déclenche un clic sur « point » en cliquant dessus dans un graphique en aires.
Voir également pressed, released et doubleClicked.
[signal] void QAreaSeries::colorChanged(QColor color)
Ce signal est émis lorsque la couleur de remplissage (pinceau) passe à color.
Remarque : signalde notification pour la propriété color.
[signal] void QAreaSeries::doubleClicked(const QPointF &point)
Ce signal est émis lorsque l'utilisateur effectue un premier clic dans un graphique en aires en double-cliquant sur point.
Voir également pressed, released et clicked.
[signal] void QAreaSeries::hovered(const QPointF &point, bool state)
Ce signal est émis lorsque l'utilisateur passe le curseur de la souris sur une série ou l'éloigne de celle-ci. ` point ` indique l'origine (coordonnées) de l'événement de survol. ` state ` est défini sur ` true ` lorsque le curseur survole la série et passe à `false` lorsqu'il s'en éloigne.
QPen QAreaSeries::pen() const
Renvoie le stylo utilisé pour tracer la ligne correspondant à cette série.
Voir aussi setPen().
[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)
Ce signal est émis lorsque le rognage des étiquettes des points de données passe à « clipping ».
Remarque : signalde notification pour la propriété pointLabelsClipping.
[signal] void QAreaSeries::pointLabelsColorChanged(const QColor &color)
Ce signal est émis lorsque la couleur utilisée pour les étiquettes des points de données passe à color.
Remarque : signalde notification pour la propriété « pointLabelsColor ».
[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)
Ce signal est émis lorsque la police utilisée pour les étiquettes des points de données passe à « font ».
Remarque : signalde notification pour la propriété pointLabelsFont.
[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)
Ce signal est émis lorsque l'format des étiquettes des points de données est modifiée.
Remarque : signalde notification pour l’ pointLabelsFormat de la propriété.
[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)
Ce signal est émis lorsque la visibilité des libellés des points de données passe à « visible ».
Remarque : signalde notification pour la propriété « pointLabelsVisible ».
bool QAreaSeries::pointsVisible() const
Indique si les points sont dessinés pour cette série.
Voir aussi setPointsVisible().
[signal] void QAreaSeries::pressed(const QPointF &point)
Ce signal est émis lorsque l'utilisateur clique sur le point spécifié par point dans un graphique en aires.
Voir également clicked, released et doubleClicked.
[signal] void QAreaSeries::released(const QPointF &point)
Ce signal est émis lorsque l'utilisateur relâche un clic déclenché sur point dans un graphique en aires.
Voir également pressed, clicked et doubleClicked.
void QAreaSeries::setBrush(const QBrush &brush)
Définit l'brush utilisé pour remplir la zone.
Voir aussi brush().
void QAreaSeries::setLowerSeries(QLineSeries *series)
Définit l'series qui servira de série inférieure du graphique en aires.
Voir également la fonction lowerSeries().
void QAreaSeries::setPen(const QPen &pen)
Définit l'pen utilisé pour dessiner le contour de la zone.
Voir également pen().
void QAreaSeries::setPointsVisible(bool visible = true)
Détermine si les points de données sont des « visible s » et s'ils doivent être représentés sur la courbe.
Voir aussi pointsVisible().
void QAreaSeries::setUpperSeries(QLineSeries *series)
Définit l'series qui doit être utilisée comme série supérieure du graphique en aires. Si la série supérieure est nulle, le graphique en aires n'est pas tracé, même s'il comporte une série inférieure.
Voir également upperSeries().
[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const
Réimplémente une fonction d'accès pour la propriété : QAbstractSeries::type.
Renvoie QAbstractSeries::SeriesTypeArea.
© 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.
