Sur cette page

QAreaSeries Class

La classe `QAreaSeries` permet de représenter des données sous forme de graphiques en aires. En savoir plus...

En-tête : #include <QAreaSeries>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : AreaSeries
Hérite de : QAbstractSeries

Propriétés

Fonctions publiques

QColor borderColor() const
qreal borderWidth() const
QColor color() const
bool isSelected() const
QXYSeries *lowerSeries() const
QColor selectedBorderColor() const
QColor selectedColor() const
void setBorderColor(QColor newBorderColor)
void setBorderWidth(qreal newBorderWidth)
void setColor(QColor newColor)
void setLowerSeries(QXYSeries *newLowerSeries)
void setSelected(bool newSelected)
void setSelectedBorderColor(QColor newSelectedBorderColor)
void setSelectedColor(QColor newColor)
void setUpperSeries(QXYSeries *newUpperSeries)
QXYSeries *upperSeries() const

Signaux

void borderColorChanged(QColor newBorderColor)
void borderWidthChanged()
void colorChanged(QColor newColor)
void lowerSeriesChanged()
void selectedBorderColorChanged(QColor newSelectedBorderColor)
void selectedChanged()
void selectedColorChanged(QColor newSelectedColor)
void upperSeriesChanged()

Description détaillée

Un graphique de zone permet de tracer une zone composée de points. Les points sont définis par deux séries : upperSeries et lowerSeries. La zone située entre les séries est représentée sous forme de graphique. Si seule la série upperSeries est définie, la zone se situe alors entre la base du graphique et la série supérieure.

Documentation des propriétés

borderColor : QColor

Cette propriété définit la couleur de la bordure de la zone. La valeur par défaut est « Qt::transparent », ce qui signifie que la couleur de la bordure est définie par le thème.

Fonctions d'accès :

QColor borderColor() const
void setBorderColor(QColor newBorderColor)

Signal de notification :

void borderColorChanged(QColor newBorderColor)

borderWidth : qreal

Cette propriété définit la largeur de la ligne qui entoure la zone. La valeur par défaut est « -1 », ce qui signifie que la largeur de la bordure est définie par le thème.

Fonctions d'accès :

qreal borderWidth() const
void setBorderWidth(qreal newBorderWidth)

Signal de notification :

void borderWidthChanged()

color : QColor

Cette propriété définit la couleur de remplissage de la zone. La valeur par défaut est « Qt::transparent », ce qui signifie que la couleur est définie par le thème.

Remarque : si AreaSeries::gradient est défini sur une valeur autre que null, celles-ci auront priorité sur color. Dans ce cas, la propriété color sera ignorée.

Fonctions d’accès :

QColor color() const
void setColor(QColor newColor)

Signal de notification :

void colorChanged(QColor newColor)

lowerSeries : QXYSeries*

Définit la limite inférieure de la zone. Si cette valeur est nulle, le bas du graphique est considéré comme la limite inférieure.

Fonctions d'accès :

QXYSeries *lowerSeries() const
void setLowerSeries(QXYSeries *newLowerSeries)

Signal de notification :

void lowerSeriesChanged()

selected : bool

Définit cette zone comme sélectionnée. La valeur par défaut est « false ».

Fonctions d'accès :

bool isSelected() const
void setSelected(bool newSelected)

Signal de notification :

void selectedChanged()

selectedBorderColor : QColor

Cette propriété définit la couleur de la bordure de la zone lorsqu’elle est sélectionnée. La valeur par défaut est « Qt::transparent », ce qui signifie que la couleur de la bordure sélectionnée est définie par le thème.

Fonctions d'accès :

QColor selectedBorderColor() const
void setSelectedBorderColor(QColor newSelectedBorderColor)

Signal de notification :

void selectedBorderColorChanged(QColor newSelectedBorderColor)

selectedColor : QColor

Cette propriété définit la couleur de remplissage de la zone lorsqu’elle est sélectionnée. La valeur par défaut est « Qt::transparent », ce qui signifie que la couleur sélectionnée est définie par le thème.

Remarque : si AreaSeries::selectedGradient est défini sur une valeur autre que null, celle-ci prévaudra sur selectedColor. Dans ce cas, la propriété selectedColor sera ignorée.

Fonctions d’accès :

QColor selectedColor() const
void setSelectedColor(QColor newColor)

Signal de notification :

void selectedColorChanged(QColor newSelectedColor)

upperSeries : QXYSeries*

Définit la limite supérieure de la zone. Aucune zone n'est dessinée si cette valeur est nulle.

Fonctions d'accès :

QXYSeries *upperSeries() const
void setUpperSeries(QXYSeries *newUpperSeries)

Signal de notification :

void upperSeriesChanged()

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