Sur cette page

AreaSeries QML Type

Affiche les données sous forme de graphiques en aires. En savoir plus…

Import Statement: import QtCharts 2.12
In C++: QAreaSeries
Inherits:

AbstractSeries

Status: Deprecated

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Signaux

Description détaillée

Une série de surface est utilisée pour représenter des données quantitatives. Elle repose sur une série de lignes, la différence étant que la surface délimitée par les lignes de contour est mise en évidence par une couleur. Le type « LineSeries » 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, la série de surface (AreaSeries) doit utiliser deux types d’ LineSeries.

Remarque : les termes « limite supérieure » et « limite inférieure » peuvent prêter à confusion lorsque 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.

Diagramme de surface présentant le nombre de joueurs russes, suédois et finlandais par année, de 2000 à 2011

Le code QML suivant montre comment créer un graphique en aires simple :

ChartView {
    title: "NHL All-Star Team Players"
    anchors.fill: parent
    antialiasing: true

    // Define x-axis to be used with the series instead of default one
    ValueAxis {
        id: valueAxis
        min: 2000
        max: 2011
        tickCount: 12
        labelFormat: "%.0f"
    }

    AreaSeries {
        name: "Russian"
        axisX: valueAxis
        upperSeries: LineSeries {
            XYPoint { x: 2000; y: 1 }
            XYPoint { x: 2001; y: 1 }
            XYPoint { x: 2002; y: 1 }
            XYPoint { x: 2003; y: 1 }
            XYPoint { x: 2004; y: 1 }
            XYPoint { x: 2005; y: 0 }
            XYPoint { x: 2006; y: 1 }
            XYPoint { x: 2007; y: 1 }
            XYPoint { x: 2008; y: 4 }
            XYPoint { x: 2009; y: 3 }
            XYPoint { x: 2010; y: 2 }
            XYPoint { x: 2011; y: 1 }
        }
    }

Remarque : l’ajout d’une même série de lignes à la fois à un graphique et à une série de surface n’est pas pris en charge. Les séries utilisées comme lignes de délimitation ne doivent être définies que pour la série de surface.

Documentation des propriétés

axisAngular : AbstractAxis

L'axe angulaire utilisé pour la série, tracé autour du graphique polaire.

Voir également axisX et PolarChartView.

axisRadial : AbstractAxis

L'axe radial utilisé pour la série, tracé à l'intérieur du graphique polaire.

Voir également axisY et PolarChartView.

axisX : AbstractAxis

L'axe des x utilisé pour la série. Si vous ne définissez ni axisX ni axisXTop, un axe des valeurs est créé pour la série.

Voir également axisXTop et ValueAxis.

axisXTop : AbstractAxis

L'axe des x utilisé pour la série, tracé par-dessus la vue graphique.

Remarque : vous ne pouvez spécifier que l'une des options suivantes : « axisX » ou « axisXTop », mais pas les deux.

Voir également axisX.

axisY : AbstractAxis

L'axe des y utilisé pour la série. Si vous ne définissez ni « axisY » ni « axisYRight », un axe des valeurs est créé pour la série.

Voir également axisYRight et ValueAxis.

axisYRight : AbstractAxis

L'axe des y utilisé pour la série, tracé vers la droite dans la vue graphique.

Remarque : vous ne pouvez spécifier que l'une des options suivantes : « axisY » ou « axisYRight », mais pas les deux.

Voir également axisY.

borderColor : color

Couleur du trait (stylo) de la série.

borderWidth : real

La largeur de la ligne de bordure. Par défaut, la largeur est de 2,0.

brush : brush

Le pinceau utilisé pour tracer la ligne dans cette série.

brushFilename : string

Nom du fichier utilisé comme image de pinceau pour la série.

color : color

Couleur de remplissage (pinceau) de la série.

lowerSeries : LineSeries [read-only]

La série inférieure parmi les deux séries de lignes utilisées pour définir les limites d'une série de zones.

Remarque : si l'AreaSeries a été créée sans lowerSeries, cette valeur est nulle.

pointLabelsClipping : bool

Définit le rognage des libellés des points de données. Valeur par défaut : True. Lorsque le rognage est activé, les libellés situés à la limite de la zone de tracé sont tronqués.

Voir également pointLabelsVisible.

pointLabelsColor : font

Définit la couleur utilisée pour les libellés des points de données. Par défaut, cette couleur correspond à celle du pinceau défini pour les libellés dans le thème.

Voir également pointLabelsFormat.

pointLabelsFont : font

Définit la police utilisée pour les étiquettes des points de données.

Voir aussi pointLabelsFormat.

pointLabelsFormat : string

Format utilisé pour afficher les étiquettes associées aux points d'une série.

Voir également QAreaSeries::pointLabelsFormat, pointLabelsVisible, pointLabelsFont et pointLabelsColor.

pointLabelsVisible : bool

Définit la visibilité des libellés des points de données.

Voir également pointLabelsFormat et pointLabelsClipping.

upperSeries : LineSeries [read-only]

La ligne supérieure des deux séries de lignes utilisées pour définir les limites d'une série de zones.

Documentation du signal

clicked(point point)

Ce signal est émis lorsque l'utilisateur déclenche une pression sur « point » en cliquant dessus dans un graphique en aires.

Le gestionnaire de signal correspondant est onClicked.

Remarque : le gestionnaire correspondant est onClicked.

Voir également pressed, released et doubleClicked.

doubleClicked(point point)

Ce signal est émis lorsque l'utilisateur effectue un premier clic dans un graphique en aires en double-cliquant sur point.

Le gestionnaire de signal correspondant est onDoubleClicked.

Remarque : le gestionnaire correspondant est onDoubleClicked.

Voir également pressed, released et clicked.

hovered(point point, bool state)

Ce signal est émis lorsque l'utilisateur passe le curseur de la souris au-dessus d'une série ou l'éloigne de celle-ci. point indique l'origine (coordonnées) de l'événement de survol. state prend la valeur true lorsque le curseur survole la série et passe à false lorsqu'il s'en éloigne.

Le gestionnaire de signal correspondant est onHovered.

Remarque : le gestionnaire correspondant est onHovered.

pressed(point point)

Ce signal est émis lorsque l'utilisateur clique sur le point spécifié par ` point ` dans un graphique en aires.

Le gestionnaire de signal correspondant est onPressed.

Remarque : le gestionnaire correspondant est onPressed.

Voir également clicked, released et doubleClicked.

released(point point)

Ce signal est émis lorsque l'utilisateur relâche un clic déclenché sur point dans un graphique en zones.

Le gestionnaire de signal correspondant est onReleased.

Remarque : le gestionnaire correspondant est onReleased.

Voir également pressed, clicked et doubleClicked.

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