Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QAreaSeries Class

La classe QAreaSeries présente les données dans des graphiques à aires. Plus d'informations...

Header: #include <QAreaSeries>
In QML: AreaSeries
Inherits: QAbstractSeries

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 surfaces est utilisée pour présenter des données quantitatives. Elle est basée sur une série de lignes, dans la mesure où la zone située entre les lignes de démarcation est mise en évidence par de la couleur. Comme la série de zones est basée sur la série de lignes, le constructeur de QAreaSeries a besoin d'une instance QLineSeries, qui définit la limite supérieure de la zone. Le graphique à aires est dessiné en utilisant par défaut 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 QLineSeries.

Remarque : les termes "limite supérieure" et "limite inférieure" peuvent induire en erreur lorsque la valeur de la limite inférieure est supérieure à celle de la limite supérieure. L'essentiel est que la zone située entre ces deux lignes de démarcation soit remplie.

Consultez la galerie Graphiques avec Widgets pour apprendre à créer un graphique de surface simple.

Capture d'écran d'un exemple de diagramme en aires

Documentation sur les propriétés

borderColor : QColor

Cette propriété définit la couleur de la ligne (stylo) de la série. Il s'agit d'une propriété de commodité permettant de modifier la couleur du stylo.

Fonctions d'accès :

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

Signal Notifier :

void borderColorChanged(QColor color)

Voir aussi 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é de commodité permettant de modifier la couleur de la brosse.

Fonctions d'accès :

QColor color() const
void setColor(const QColor &color)

Signal Notifier :

void colorChanged(QColor color)

Voir aussi QAreaSeries::brush().

[read-only] lowerSeries : QLineSeries*

Cette propriété contient la plus petite des deux séries de lignes utilisées pour définir les limites des séries de zones.

Note : Si QAreaSeries a été construit sans lowerSeries, cette propriété est nulle.

Fonctions d'accès :

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

Cette propriété définit l'écrêtage des étiquettes des points de données. True par défaut. Les étiquettes situées sur le bord de la zone de tracé sont coupées lorsque l'écrêtage est activé.

Fonctions d'accès :

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

Signal Notificateur :

void pointLabelsClippingChanged(bool clipping)

Voir aussi pointLabelsVisible.

pointLabelsColor : QColor

Cette propriété définit la couleur utilisée pour les étiquettes des points de données. Par défaut, la couleur est celle de la brosse définie pour les étiquettes dans le thème.

Fonctions d'accès :

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

Signal Notifier :

void pointLabelsColorChanged(const QColor &color)

Voir aussi QAreaSeries::pointLabelsFormat.

pointLabelsFont : QFont

Cette propriété définit la police utilisée pour les étiquettes des points de données.

Fonctions d'accès :

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

Signal Notificateur :

void pointLabelsFontChanged(const QFont &font)

Voir aussi QAreaSeries::pointLabelsFormat.

pointLabelsFormat : QString

Cette propriété définit le format utilisé pour afficher les étiquettes avec les points de la série.

QAreaSeries prend en charge les balises de format suivantes :

@xPointLa valeur x du point de données
@yPointLa valeur y du point de données

Par exemple, l'utilisation suivante des balises de format produirait des étiquettes dont les points de données (x, y) sont indiqués entre des parenthèses 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 sont affichées sur la zone de tracé, tandis que les étiquettes situées sur le bord de la zone de tracé sont coupé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. Faux par défaut.

Fonctions d'accès :

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

Signal Notifier :

void pointLabelsVisibilityChanged(bool visible)

Voir aussi QAreaSeries::pointLabelsFormat et QAreaSeries::pointLabelsClipping.

[read-only] upperSeries : QLineSeries*

Cette propriété contient la série supérieure des deux séries de lignes utilisées pour définir les limites des séries de zones.

Fonctions d'accès :

QLineSeries *upperSeries() const

Fonction membre Documentation

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

Construit un objet de série de surface sans série supérieure ou inférieure avec l'objet parent.

[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)

Construit un objet de série de surface qui sera compris entre une ligne upperSeries et une ligne lowerSeries. Si aucun lowerSeries n'est transmis au constructeur, l'axe des x est utilisé comme limite inférieure.

La série QAreaSeries ne possède pas la série supérieure ou inférieure, mais la propriété reste à l'appelant. Lorsque l'objet series 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 de la ligne (du stylo) devient color.

Note : Signal de notification pour la propriété borderColor.

QBrush QAreaSeries::brush() const

Renvoie la brosse utilisée pour dessiner la ligne de cette série.

Voir également setBrush().

[signal] void QAreaSeries::clicked(const QPointF &point)

Ce signal est émis lorsque l'utilisateur déclenche une pression sur le site point en cliquant sur celui-ci dans un diagramme de zone.

Voir aussi pressed, released, et doubleClicked.

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

Ce signal est émis lorsque la couleur de remplissage (pinceau) devient color.

Note : Signal de notification pour la propriété color.

[signal] void QAreaSeries::doubleClicked(const QPointF &point)

Ce signal est émis lorsque l'utilisateur déclenche la première pression dans un diagramme de zone 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 au-dessus d'une série ou qu'il s'en éloigne. point indique l'origine (coordonnées) de l'événement de survol. state est true lorsque le curseur passe au-dessus de la série et devient faux lorsqu'il s'en éloigne.

QPen QAreaSeries::pen() const

Renvoie le stylo utilisé pour dessiner la ligne de cette série.

Voir aussi setPen().

[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)

Ce signal est émis lorsque l'écrêtage des étiquettes des points de données passe à clipping.

Note : Signal de 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.

Note : Signal de 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 devient font.

Note : Signal de notification pour la propriété pointLabelsFont.

[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)

Ce signal est émis lorsque l'adresse format des étiquettes des points de données est modifiée.

Note : Signal de notification pour la propriété pointLabelsFormat.

[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)

Ce signal est émis lorsque la visibilité des étiquettes des points de données passe à visible.

Note : Signal de notification pour la propriété pointLabelsVisible.

bool QAreaSeries::pointsVisible() const

Retourne si les points sont dessinés pour cette série.

Voir également setPointsVisible().

[signal] void QAreaSeries::pressed(const QPointF &point)

Ce signal est émis lorsque l'utilisateur appuie sur le point spécifié par point dans une carte de surface.

Voir également clicked, released, et doubleClicked.

[signal] void QAreaSeries::released(const QPointF &point)

Ce signal est émis lorsque l'utilisateur relâche une pression qui a été déclenchée sur point dans un graphique de zone.

Voir également pressed, clicked, et doubleClicked.

void QAreaSeries::setBrush(const QBrush &brush)

Définit l'adresse brush utilisée pour remplir la zone.

Voir aussi brush().

void QAreaSeries::setLowerSeries(QLineSeries *series)

Définit le site series qui doit être utilisé pour la série inférieure du graphique en aires.

Voir également lowerSeries().

void QAreaSeries::setPen(const QPen &pen)

Définit le site pen utilisé pour dessiner le contour de la zone.

Voir aussi pen().

void QAreaSeries::setPointsVisible(bool visible = true)

Détermine si les points de données sont visible et doivent être dessinés sur la ligne.

Voir également pointsVisible().

void QAreaSeries::setUpperSeries(QLineSeries *series)

Définit le site series qui doit être utilisé comme série supérieure du graphique à aires. Si la série supérieure est nulle, le graphique en aires n'est pas dessiné, même s'il possède une série inférieure.

Voir également upperSeries().

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

Réimplémente une fonction d'accès à la propriété : QAbstractSeries::type.

Retourne 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.