Sur cette page

BoxPlotSeries QML Type

Présente les données sous forme de diagrammes en boîte et moustaches. Plus d'informations...

Import Statement: import QtCharts 2.11
In C++: QBoxPlotSeries
Inherits:

AbstractSeries

Propriétés

Signaux

Méthodes

  • void append(BoxSet box)
  • void append(string label, VariantList values)
  • BoxSet at(int index)
  • void clear()
  • void insert(int index, string label, VariantList values)
  • void remove(QBoxSet boxset)

Description détaillée

Une série de box plots sert de conteneur pour les éléments de box-and-whiskers. Les éléments de plusieurs séries sont regroupés en catégories en fonction de leur valeur d'indice.

La classe BarCategoryAxis est utilisée pour ajouter les catégories à l'axe du graphique. Les étiquettes des catégories doivent être uniques. Si la même étiquette de catégorie est définie pour plusieurs éléments de la boîte à moustaches, seul le premier est dessiné.

L'extrait de code QML suivant montre comment créer un graphique en boîte et moustaches simple :

import QtQuick 2.0
import QtCharts 2.0

ChartView {
    title: "Box Plot series"
    width: 400
    height: 300
    theme: ChartView.ChartThemeBrownSand
    legend.alignment: Qt.AlignBottom

    BoxPlotSeries {
        id: plotSeries
        name: "Income"
        BoxSet { label: "Jan"; values: [3, 4, 5.1, 6.2, 8.5] }
        BoxSet { label: "Feb"; values: [5, 6, 7.5, 8.6, 11.8] }
        BoxSet { label: "Mar"; values: [3.2, 5, 5.7, 8, 9.2] }
        BoxSet { label: "Apr"; values: [3.8, 5, 6.4, 7, 8] }
        BoxSet { label: "May"; values: [4, 5, 5.2, 6, 7] }
    }
}

Capture d'écran montrant un diagramme en boîte affichant un revenu sur cinq mois, de janvier à mai.


Voir également BoxSet et BarCategoryAxis.

Documentation sur les propriétés

axisX : AbstractAxis

L'axe des x utilisé pour la série. Si vous laissez axisX et axisXTop indéfinis, un BarCategoryAxis est créé pour la série.

Voir également axisXTop.

axisXTop : AbstractAxis

L'axe des abscisses utilisé pour la série, dessiné au-dessus de la vue du graphique.

Remarque : vous ne pouvez fournir que axisX ou axisXTop, mais pas les deux.

Voir également axisX.

axisY : AbstractAxis

L'axe des ordonnées utilisé pour la série. Si vous laissez axisY et axisYRight indéfinis, un ValueAxis est créé pour la série.

Voir également axisYRight.

axisYRight : AbstractAxis

L'axe des ordonnées utilisé pour la série, dessiné vers la droite sur la vue du graphique.

Remarque : vous ne pouvez fournir que axisY ou axisYRight, mais pas les deux.

Voir également axisY.

boxOutlineVisible : bool

La visibilité du contour de la boîte.

boxWidth : real

Largeur de l'élément de la boîte à moustaches. La valeur indique la largeur relative de l'élément dans sa catégorie. La valeur peut être comprise entre 0,0 et 1,0. Les valeurs négatives sont remplacées par 0,0 et les valeurs supérieures à 1,0 sont remplacées par 1,0.

brushFilename : string

Le nom du fichier utilisé comme pinceau pour la série.

count : int [read-only]

Le nombre d'éléments de la boîte et des moustaches dans une série de diagrammes en boîte.

Documentation sur les signaux

boxsetsAdded(list sets)

Ce signal est émis lorsque les éléments "box-and-whiskers" spécifiés par sets sont ajoutés à la série.

Le gestionnaire de signal correspondant est onBoxsetsAdded().

Note : Le gestionnaire correspondant est onBoxsetsAdded.

boxsetsRemoved(list sets)

Ce signal est émis lorsque les éléments "box-and-whiskers" spécifiés par sets sont retirés de la série.

Le gestionnaire de signal correspondant est onBoxsetsRemoved().

Note : Le gestionnaire correspondant est onBoxsetsRemoved.

clicked(BoxSet boxset)

Ce signal est émis lorsque l'utilisateur clique sur l'élément de la boîte et des moustaches spécifié par boxset dans le graphique.

Le gestionnaire de signal correspondant est onClicked().

Note : Le gestionnaire correspondant est onClicked.

doubleClicked(BoxSet boxset)

Ce signal est émis lorsque l'utilisateur double-clique sur l'élément de la boîte à moustaches spécifié par boxset dans le graphique.

Le gestionnaire de signal correspondant est onDoubleClicked().

Note : Le gestionnaire correspondant est onDoubleClicked.

hovered(bool status, BoxSet boxset)

Ce signal est émis lorsque la souris passe sur l'élément de la boîte à moustaches spécifié par boxset dans le graphique. Lorsque la souris passe au-dessus de l'élément, status devient true, et lorsque la souris s'éloigne à nouveau, il devient false.

Le gestionnaire de signal correspondant est onHovered().

Remarque : le gestionnaire correspondant est onHovered.

pressed(BoxSet boxset)

Ce signal est émis lorsque l'utilisateur appuie sur le bouton boxset du graphique.

Le gestionnaire de signal correspondant est onPressed.

Note : Le gestionnaire correspondant est onPressed.

released(BoxSet boxset)

Ce signal est émis lorsque l'utilisateur relâche la pression de la souris sur l'élément de la boîte et des moustaches spécifié par boxset dans le graphique.

Le gestionnaire de signal correspondant est onReleased().

Note : Le gestionnaire correspondant est onReleased.

Documentation de la méthode

void append(BoxSet box)

Ajoute à la série l'élément "box-and-whiskers" spécifié par box.

void append(string label, VariantList values)

Ajoute à la série un nouvel élément "box-and-whiskers" avec l'étiquette spécifiée par label et les valeurs spécifiées par values.

BoxSet at(int index)

Renvoie l'élément de la boîte à moustaches à la position spécifiée par index.

void clear()

Supprime tous les éléments de la série et les supprime définitivement.

void insert(int index, string label, VariantList values)

Insère dans la série, à la position spécifiée par index, un nouvel élément de type boîte et moustaches avec l'étiquette spécifiée par label et les valeurs spécifiées par values.

void remove(QBoxSet boxset)

Supprime de la série l'élément "box-and-whiskers" spécifié par boxset.

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