Sur cette page

QBoxPlotSeries Class

La classe QBoxPlotSeries présente les données sous forme de diagrammes en boîte à moustaches. En savoir plus...

Header: #include <QBoxPlotSeries>
In QML: BoxPlotSeries
Inherits: QAbstractSeries
Status: Deprecated

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

QBoxPlotSeries(QObject *parent = nullptr)
virtual ~QBoxPlotSeries()
bool append(QBoxSet *set)
bool append(const QList<QBoxSet *> &sets)
bool boxOutlineVisible()
QList<QBoxSet *> boxSets() const
qreal boxWidth()
QBrush brush() const
void clear()
int count() const
bool insert(int index, QBoxSet *set)
QPen pen() const
bool remove(QBoxSet *set)
void setBoxOutlineVisible(bool visible)
void setBoxWidth(qreal width)
void setBrush(const QBrush &brush)
void setPen(const QPen &pen)
bool take(QBoxSet *set)

Fonctions publiques réimplémentées

virtual QAbstractSeries::SeriesType type() const override

Signaux

void boxOutlineVisibilityChanged()
void boxWidthChanged()
void boxsetsAdded(const QList<QBoxSet *> &sets)
void boxsetsRemoved(const QList<QBoxSet *> &sets)
void brushChanged()
void clicked(QBoxSet *boxset)
void countChanged()
void doubleClicked(QBoxSet *boxset)
void hovered(bool status, QBoxSet *boxset)
void penChanged()
void pressed(QBoxSet *boxset)
void released(QBoxSet *boxset)

Description détaillée

Une série de diagrammes en boîte sert de conteneur pour les éléments des diagrammes en boîte et à moustaches. Les éléments provenant de plusieurs séries sont regroupés en catégories en fonction de leur valeur d'indice.

La classe ` QBarCategoryAxis ` permet d'ajouter les catégories à l'axe du graphique. Les libellés de catégorie doivent être uniques. Si le même libellé de catégorie est défini pour plusieurs éléments de diagramme en boîte à moustaches, seul le premier est affiché.

Consultez la galerie « Graphiques avec widgets » pour savoir comment créer un graphique à boîte et moustaches.

Diagramme en boîte à moustaches comparant la variation mensuelle du cours de l'action de deux sociétés tout au long de l'année 2012

Voir également ` QBoxSet ` et ` QBarCategoryAxis`.

Documentation sur les propriétés

boxOutlineVisible : bool

Cette propriété définit la visibilité du contour de la zone.

Fonctions d'accès :

bool boxOutlineVisible()
void setBoxOutlineVisible(bool visible)

Signal de notification :

boxWidth : qreal

Cette propriété contient la largeur de l'élément « boîte à moustaches ». La valeur indique la largeur relative de l'élément au sein de sa catégorie. Elle peut être comprise entre 0,0 et 1,0. Les valeurs négatives sont remplacées par 0,0 et celles supérieures à 1,0 sont remplacées par 1,0.

Fonctions d'accès :

qreal boxWidth()
void setBoxWidth(qreal width)

Signal de notification :

brush : QBrush

Cette propriété contient le pinceau utilisé pour remplir les cases des éléments de type « boîte à moustaches ».

Fonctions d'accès :

QBrush brush() const
void setBrush(const QBrush &brush)

Signal de notification :

void brushChanged()

[read-only] count : int

Cette propriété indique le nombre d'éléments représentés par des barres et des moustaches dans une série de diagrammes en boîte.

Fonctions d'accès :

int count() const

Signal de notification :

void countChanged()

pen : QPen

Cette propriété contient le stylo utilisé pour tracer les lignes des éléments de type « boîte à moustaches ».

Fonctions d'accès :

QPen pen() const
void setPen(const QPen &pen)

Signal de notification :

void penChanged()

Documentation des fonctions membres

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

Crée une série de diagrammes en boîte vide qui est une « QObject » et un élément enfant de « parent ».

[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()

Supprime la série du graphique.

bool QBoxPlotSeries::append(QBoxSet *set)

Ajoute à la série un élément « boîte à moustaches » spécifié par ` set ` et en prend la propriété. Si l'élément est nul ou s'il appartient déjà à la série, il ne sera pas ajouté. Renvoie ` true ` si l'ajout a réussi.

bool QBoxPlotSeries::append(const QList<QBoxSet *> &sets)

Ajoute à la série une liste d'éléments de diagramme en boîte à moustaches spécifiés par ` sets ` et en prend la propriété. Si la liste est nulle ou si les éléments appartiennent déjà à la série, ils ne seront pas ajoutés. Renvoie ` true ` si l'ajout a réussi.

[signal] void QBoxPlotSeries::boxOutlineVisibilityChanged()

Ce signal est émis lorsque la visibilité du contour de la boîte change.

Remarque : signalde notification pour la propriété « boxOutlineVisible ».

QList<QBoxSet *> QBoxPlotSeries::boxSets() const

Renvoie une liste des éléments « boîte et moustaches » d'une série de diagrammes en boîte. Conserve la propriété des éléments.

[signal] void QBoxPlotSeries::boxWidthChanged()

Ce signal est émis lorsque la largeur de l'élément « boîte à moustaches » change.

Remarque : signalde notification pour la propriété boxWidth.

[signal] void QBoxPlotSeries::boxsetsAdded(const QList<QBoxSet *> &sets)

Ce signal est émis lorsque la liste des éléments « box-and-whiskers » spécifiée par ` sets ` est ajoutée à la série.

[signal] void QBoxPlotSeries::boxsetsRemoved(const QList<QBoxSet *> &sets)

Ce signal est émis lorsque la liste des éléments du diagramme en boîte à moustaches spécifiée par ` sets ` est supprimée de la série.

[signal] void QBoxPlotSeries::brushChanged()

Ce signal est émis lorsque le pinceau utilisé pour remplir les cases des éléments de type « boîte à moustaches » change.

Remarque : signalde notification pour la propriété brush.

void QBoxPlotSeries::clear()

Supprime tous les éléments de type « boîte à moustaches » de la série et les efface définitivement.

[signal] void QBoxPlotSeries::clicked(QBoxSet *boxset)

Ce signal est émis lorsque l'utilisateur clique sur l'élément « diagramme en boîte à moustaches » spécifié par boxset dans le graphique.

int QBoxPlotSeries::count() const

Renvoie le nombre d’éléments représentés par des diagrammes en boîte à moustaches dans une série de diagrammes en boîte.

Remarque : fonctiongetter pour la propriété count.

[signal] void QBoxPlotSeries::countChanged()

Ce signal est émis lorsque le nombre d'éléments représentés par des diagrammes en boîte à moustaches dans la série change.

Remarque : signalde notification pour la propriété count.

[signal] void QBoxPlotSeries::doubleClicked(QBoxSet *boxset)

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

[signal] void QBoxPlotSeries::hovered(bool status, QBoxSet *boxset)

Ce signal est émis lorsqu'on passe la souris sur l'élément « boîte à moustaches » spécifié par boxset dans le graphique. Lorsque la souris passe sur l'élément, status devient true, et lorsque la souris s'en éloigne, il redevient false.

bool QBoxPlotSeries::insert(int index, QBoxSet *set)

Insère un élément de type « boîte à moustaches » spécifié par set dans une série à la position indiquée par index et en prend possession. Si l'élément est nul ou appartient déjà à la série, il ne sera pas ajouté. Renvoie true si l'insertion aboutit.

[signal] void QBoxPlotSeries::penChanged()

Ce signal est émis lorsque le stylo utilisé pour tracer les lignes des éléments « boîte et moustaches » change.

Remarque : signalde notification pour la propriété pen.

[signal] void QBoxPlotSeries::pressed(QBoxSet *boxset)

Ce signal est émis lorsque l'utilisateur clique sur l'élément « boîte à moustaches » spécifié par boxset dans le graphique et maintient le bouton de la souris enfoncé.

[signal] void QBoxPlotSeries::released(QBoxSet *boxset)

Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur l'élément « boîte à moustaches » spécifié par ` boxset ` dans le graphique.

bool QBoxPlotSeries::remove(QBoxSet *set)

Supprime de la série l'élément « boîte et moustaches » spécifié par ` set ` et le supprime définitivement si la suppression aboutit. Renvoie ` true ` si l'élément a été supprimé.

bool QBoxPlotSeries::take(QBoxSet *set)

Récupère de la série l'élément de type « boîte à moustaches » spécifié par set. Ne supprime pas l'élément.

Remarque : la série reste l'objet parent de l'élément. Vous devez définir l'objet parent pour en prendre la pleine propriété.

Renvoie true si l'opération de récupération aboutit.

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

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

Renvoie le type de la série.

Voir également QAbstractSeries et SeriesType.

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