Sur cette page

QAreaSeries Class

La classe QAreaSeries présente des données sous forme de graphiques en aires. Plus d'informations...

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éritages : QAbstractSeries

Propriétés

Fonctions publiques

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

Signaux

void borderColorChanged(QColor newBorderColor)
void borderWidthChanged()
void colorChanged(QColor newColor)
void gradientChanged(QQuickShapeGradient *newGradient)
void lowerSeriesChanged()
void selectedBorderColorChanged(QColor newSelectedBorderColor)
void selectedChanged()
void selectedColorChanged(QColor newSelectedColor)
void selectedGradientChanged(QQuickShapeGradient *newGradient)
void upperSeriesChanged()

Description détaillée

Un graphique en aires est utilisé pour dessiner une aire composée de points. Les points sont définis par deux séries : upperSeries et lowerSeries. La zone entre les séries est dessinée sous forme de graphique. Si seul le upperSeries est défini, la zone est alors comprise entre le bas du graphique et la série supérieure.

Documentation sur les 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 la valeur de gradient est différente de celle de null, cette dernière aura la priorité sur celle de color. Dans ce cas, la valeur color sera ignorée.

Fonctions d'accès :

QColor color() const
void setColor(QColor newColor)

Signal de notification :

void colorChanged(QColor newColor)

[since 6.11] gradient : QQuickShapeGradient*

Cette propriété définit le gradient de remplissage. Par défaut, aucun dégradé n'est activé et la valeur est null. Dans ce cas, le remplissage sera basé sur la propriété color.

Note : Le type Gradient ne peut pas être utilisé ici. Il est préférable d'utiliser l'un des sous-types avancés, comme LinearGradient.

Remarque : si la valeur est différente de null, la propriété gradient aura la priorité sur color.

Cette propriété a été introduite dans Qt 6.11.

Fonctions d'accès :

QQuickShapeGradient *gradient() const
void setGradient(QQuickShapeGradient *newGradient)

Notifier signal :

void gradientChanged(QQuickShapeGradient *newGradient)

lowerSeries : QXYSeries*

Définit la limite inférieure de la zone. Si cette valeur est nulle, le fond 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 étant 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 la valeur de selectedGradient est différente de celle de null, cette dernière aura la priorité sur selectedColor. Dans ce cas, la valeur selectedColor sera ignorée.

Fonctions d'accès :

QColor selectedColor() const
void setSelectedColor(QColor newColor)

Signal de notification :

void selectedColorChanged(QColor newSelectedColor)

[since 6.11] selectedGradient : QQuickShapeGradient*

Cette propriété définit le gradient de remplissage de la zone lorsqu'elle est sélectionnée. Par défaut, aucun dégradé n'est activé et la valeur est null. Dans ce cas, le remplissage sera basé sur la propriété selectedColor.

Note : Le type Gradient ne peut pas être utilisé ici. Il est préférable d'utiliser l'un des sous-types avancés, comme LinearGradient.

Remarque : si la valeur est différente de null, la propriété selectedGradient aura la priorité sur selectedColor.

Cette propriété a été introduite dans Qt 6.11.

Fonctions d'accès :

QQuickShapeGradient *selectedGradient() const
void setSelectedGradient(QQuickShapeGradient *newSelectedGradient)

Notifier signal :

void selectedGradientChanged(QQuickShapeGradient *newGradient)

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.