Sur cette page

QBarSet Class

La classe QBarSet représente un ensemble de barres dans un diagramme à barres. Plus d'informations...

Header: #include <QBarSet>
In QML: BarSet
Inherits: QObject

Propriétés

Fonctions publiques

QBarSet(const QString label, QObject *parent = nullptr)
virtual ~QBarSet()
void append(const QList<qreal> &values)
void append(const qreal value)
qreal at(const int index) const
QColor borderColor()
QBrush brush() const
QColor color()
int count() const
(since 6.2) void deselectAllBars()
(since 6.2) void deselectBar(int index)
(since 6.2) void deselectBars(const QList<int> &indexes)
void insert(const int index, const qreal value)
(since 6.2) bool isBarSelected(int index) const
QString label() const
QBrush labelBrush() const
QColor labelColor()
QFont labelFont() const
QPen pen() const
void remove(const int index, const int count = 1)
void replace(const int index, const qreal value)
(since 6.2) void selectAllBars()
(since 6.2) void selectBar(int index)
(since 6.2) void selectBars(const QList<int> &indexes)
(since 6.2) QList<int> selectedBars() const
(since 6.2) QColor selectedColor() const
(since 6.2) void setBarSelected(int index, bool selected)
void setBorderColor(QColor color)
void setBrush(const QBrush &brush)
void setColor(QColor color)
void setLabel(const QString label)
void setLabelBrush(const QBrush &brush)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setPen(const QPen &pen)
(since 6.2) void setSelectedColor(const QColor &color)
qreal sum() const
(since 6.2) void toggleSelection(const QList<int> &indexes)
QBarSet &operator<<(const qreal &value)
qreal operator[](const int index) const

Signaux

void borderColorChanged(QColor color)
void brushChanged()
void clicked(int index)
void colorChanged(QColor color)
void doubleClicked(int index)
void hovered(bool status, int index)
void labelBrushChanged()
void labelChanged()
void labelColorChanged(QColor color)
void labelFontChanged()
void penChanged()
void pressed(int index)
void released(int index)
void valueChanged(int index)
void valuesAdded(int index, int count)
void valuesRemoved(int index, int count)

Description détaillée

Un ensemble de barres contient une valeur de données pour chaque catégorie. La première valeur d'un ensemble est supposée appartenir à la première catégorie, la deuxième à la deuxième catégorie, et ainsi de suite. Si l'ensemble comporte moins de valeurs qu'il n'y a de catégories, les valeurs manquantes sont supposées se trouver à la fin de l'ensemble. Pour les valeurs manquantes au milieu d'un ensemble, la valeur numérique de zéro est utilisée. Les étiquettes des ensembles de valeurs nulles ne sont pas affichées.

Voir également QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, et QHorizontalPercentBarSeries.

Documentation sur les propriétés

borderColor : QColor

Cette propriété définit la couleur de la ligne (stylo) du jeu de barres.

Fonctions d'accès :

QColor borderColor()
void setBorderColor(QColor color)

Signal de notification :

void borderColorChanged(QColor color)

brush : QBrush

Cette propriété contient la brosse utilisée pour remplir les barres du jeu de barres.

Fonctions d'accès :

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

Signal de notification :

void brushChanged()

color : QColor

Cette propriété définit la couleur de remplissage (pinceau) du jeu de barres.

Fonctions d'accès :

QColor color()
void setColor(QColor color)

Signal de notification :

void colorChanged(QColor color)

label : QString

Cette propriété contient l'étiquette du jeu de barres.

Fonctions d'accès :

QString label() const
void setLabel(const QString label)

Signal de notification :

void labelChanged()

labelBrush : QBrush

Cette propriété contient la brosse utilisée pour dessiner l'étiquette du jeu de barres.

Fonctions d'accès :

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Signal de notification :

labelColor : QColor

Cette propriété définit la couleur du texte (étiquette) du jeu de barres.

Fonctions d'accès :

QColor labelColor()
void setLabelColor(QColor color)

Signal de notification :

void labelColorChanged(QColor color)

labelFont : QFont

Cette propriété définit la police utilisée pour dessiner l'étiquette du jeu de barres.

Fonctions d'accès :

QFont labelFont() const
void setLabelFont(const QFont &font)

Signal de notification :

pen : QPen

Cette propriété contient le stylo utilisé pour dessiner les lignes des barres dans le jeu de barres.

Fonctions d'accès :

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

Signal Notifier :

void penChanged()

Member Function Documentation

[explicit] QBarSet::QBarSet(const QString label, QObject *parent = nullptr)

Construit un jeu de barres avec l'étiquette label et le parent parent.

[virtual noexcept] QBarSet::~QBarSet()

Supprime le jeu de barres.

void QBarSet::append(const QList<qreal> &values)

Ajoute la liste des valeurs réelles spécifiées par values à la fin du jeu de barres.

Voir aussi append().

void QBarSet::append(const qreal value)

Ajoute la nouvelle valeur spécifiée par value à la fin du jeu de barres.

qreal QBarSet::at(const int index) const

Renvoie la valeur spécifiée par index à partir du jeu de barres. Si l'index est hors limites, 0.0 est renvoyé.

QColor QBarSet::borderColor()

Renvoie la couleur de la ligne pour le jeu de barres.

Remarque : fonction Getter pour la propriété borderColor.

Voir également setBorderColor().

[signal] void QBarSet::borderColorChanged(QColor color)

Ce signal est émis lorsque la couleur de la ligne (stylo) du jeu de barres devient color.

Note : Signal de notification pour la propriété borderColor.

QBrush QBarSet::brush() const

Renvoie la brosse utilisée pour remplir les barres du jeu de barres.

Remarque : fonction Getter pour la propriété brush.

Voir également setBrush().

[signal] void QBarSet::brushChanged()

Ce signal est émis lorsque la brosse utilisée pour dessiner le jeu de barres change.

Note : Signal de notification pour la propriété brush.

Voir également brush.

[signal] void QBarSet::clicked(int index)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans un ensemble de barres.

QColor QBarSet::color()

Renvoie la couleur de remplissage du jeu de barres.

Remarque : fonction Getter pour la propriété color.

Voir également setColor().

[signal] void QBarSet::colorChanged(QColor color)

Ce signal est émis lorsque la couleur de remplissage (brosse) de l'ensemble de barres devient color.

Note : Signal de notification pour la propriété color.

int QBarSet::count() const

Renvoie le nombre de valeurs dans un jeu de barres.

[since 6.2] void QBarSet::deselectAllBars()

Désélectionne toutes les barres de la série.

Cette fonction a été introduite dans Qt 6.2.

Voir également setBarSelected().

[since 6.2] void QBarSet::deselectBar(int index)

Désélectionne la barre à l'adresse index.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBarSelected().

[since 6.2] void QBarSet::deselectBars(const QList<int> &indexes)

Marque plusieurs barres passées dans une liste indexes comme étant désélectionnées.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBarSelected().

[signal] void QBarSet::doubleClicked(int index)

Ce signal est émis lorsque l'utilisateur double-clique sur la barre spécifiée par index dans un ensemble de barres.

[signal] void QBarSet::hovered(bool status, int index)

Ce signal est émis lorsque la souris passe au-dessus de la barre spécifiée par index dans un ensemble de barres. Lorsque la souris passe au-dessus de la barre, status devient true, et lorsque la souris s'éloigne à nouveau, elle devient false.

void QBarSet::insert(const int index, const qreal value)

Insère value à la position spécifiée par index. Les valeurs qui suivent la valeur insérée sont déplacées d'une position.

Voir aussi remove().

[since 6.2] bool QBarSet::isBarSelected(int index) const

Renvoie true si la barre située à l'adresse index donnée fait partie des barres sélectionnées et false dans le cas contraire.

Remarque : Les barres sélectionnées sont dessinées en utilisant la couleur sélectionnée si elle a été spécifiée à l'aide de QBarSet::setSelectedColor.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi selectedBars(), setBarSelected() et setSelectedColor().

QString QBarSet::label() const

Renvoie l'étiquette du jeu de barres.

Remarque : fonction Getter pour la propriété label.

Voir également setLabel().

QBrush QBarSet::labelBrush() const

Renvoie la brosse utilisée pour dessiner les valeurs au-dessus de ce jeu de barres.

Remarque : fonction Getter pour la propriété labelBrush.

Voir également setLabelBrush().

[signal] void QBarSet::labelBrushChanged()

Ce signal est émis lorsque la brosse utilisée pour dessiner l'étiquette du jeu de barres change.

Note : Signal de notification pour la propriété labelBrush.

Voir également labelBrush.

[signal] void QBarSet::labelChanged()

Ce signal est émis lorsque l'étiquette de l'ensemble de barres change.

Note : Signal de notification pour la propriété label.

Voir également label.

QColor QBarSet::labelColor()

Renvoie la couleur du texte pour le jeu de barres.

Remarque : fonction Getter pour la propriété labelColor.

Voir également setLabelColor().

[signal] void QBarSet::labelColorChanged(QColor color)

Ce signal est émis lorsque la couleur du texte (étiquette) de l'ensemble de barres devient color.

Note : Signal de notification pour la propriété labelColor.

QFont QBarSet::labelFont() const

Renvoie le stylo utilisé pour dessiner les valeurs au-dessus de ce jeu de barres.

Remarque : fonction Getter pour la propriété labelFont.

Voir également setLabelFont().

[signal] void QBarSet::labelFontChanged()

Ce signal est émis lorsque la police de l'étiquette du jeu de barres change.

Note : Signal de notification pour la propriété labelFont.

Voir également labelBrush.

QPen QBarSet::pen() const

Renvoie le stylo utilisé pour dessiner les lignes du jeu de barres.

Remarque : fonction Getter pour la propriété pen.

Voir également setPen().

[signal] void QBarSet::penChanged()

Ce signal est émis lorsque le stylo utilisé pour dessiner le jeu de barres change.

Note : Signal de notification pour la propriété pen.

Voir également pen.

[signal] void QBarSet::pressed(int index)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans un ensemble de barres et qu'il maintient le bouton de la souris enfoncé.

[signal] void QBarSet::released(int index)

Ce signal est émis lorsque l'utilisateur relâche la pression de la souris sur la barre spécifiée par index dans un ensemble de barres.

void QBarSet::remove(const int index, const int count = 1)

Supprime le nombre de valeurs spécifiées par count du jeu de barres en commençant par la valeur spécifiée par index.

Voir également insert().

void QBarSet::replace(const int index, const qreal value)

Ajoute la valeur spécifiée par value à la barre placée à la position spécifiée par index.

[since 6.2] void QBarSet::selectAllBars()

Marque toutes les barres de la série comme étant sélectionnées.

Cette fonction a été introduite dans Qt 6.2.

Voir également setBarSelected().

[since 6.2] void QBarSet::selectBar(int index)

Marque la barre à index comme étant sélectionnée.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBarSelected().

[since 6.2] void QBarSet::selectBars(const QList<int> &indexes)

Marque plusieurs barres passées dans une liste indexes comme étant sélectionnées.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBarSelected().

[since 6.2] QList<int> QBarSet::selectedBars() const

Renvoie une liste de barres marquées comme sélectionnées.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBarSelected().

[since 6.2] QColor QBarSet::selectedColor() const

Renvoie la couleur des barres sélectionnées.

Il s'agit de la couleur de remplissage (pinceau) des barres marquées comme sélectionnées. Si elle n'est pas spécifiée, la valeur de QBarSet::color est utilisée par défaut.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setSelectedColor() et color.

[since 6.2] void QBarSet::setBarSelected(int index, bool selected)

Marque la barre à l'adresse index comme étant sélectionnée ou désélectionnée, comme spécifié par selected.

Remarque : les barres sélectionnées sont dessinées en utilisant la couleur sélectionnée si elle a été spécifiée. Emet QBarSet::selectedBarsChanged.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi isBarSelected() et setSelectedColor().

void QBarSet::setBorderColor(QColor color)

Définit la couleur de la ligne pour la barre définie sur color.

Remarque : fonction de définition de la propriété borderColor.

Voir également borderColor().

void QBarSet::setBrush(const QBrush &brush)

Définit la brosse utilisée pour remplir les barres de l'ensemble de barres à brush.

Remarque : fonction de définition de la propriété brush.

Voir également brush().

void QBarSet::setColor(QColor color)

Définit la couleur de remplissage de la barre définie sur color.

Remarque : fonction de définition de la propriété color.

Voir également color().

void QBarSet::setLabel(const QString label)

Définit label comme nouvelle étiquette pour le jeu de barres.

Note : Fonction de définition de la propriété label.

Voir aussi label().

void QBarSet::setLabelBrush(const QBrush &brush)

Définit le pinceau utilisé pour dessiner les valeurs au-dessus de cette barre définie à brush.

Remarque : fonction de définition de la propriété labelBrush.

Voir également labelBrush().

void QBarSet::setLabelColor(QColor color)

Définit la couleur du texte pour la barre définie sur color.

Remarque : fonction de définition de la propriété labelColor.

Voir également labelColor().

void QBarSet::setLabelFont(const QFont &font)

Définit la police utilisée pour dessiner les valeurs en haut de la barre définie à font.

Remarque : fonction de définition de la propriété labelFont.

Voir également labelFont().

void QBarSet::setPen(const QPen &pen)

Définit le stylo utilisé pour dessiner les lignes dans la barre définie à pen.

Remarque : fonction de définition de la propriété pen.

Voir également pen().

[since 6.2] void QBarSet::setSelectedColor(const QColor &color)

Définit l'adresse color des barres sélectionnées.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi selectedColor.

qreal QBarSet::sum() const

Renvoie la somme de toutes les valeurs de l'ensemble de barres.

[since 6.2] void QBarSet::toggleSelection(const QList<int> &indexes)

Change l'état de sélection des barres à l'adresse indexes donnée pour l'état opposé.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBarSelected().

[signal] void QBarSet::valueChanged(int index)

Ce signal est émis lorsque la valeur à la position spécifiée par index est modifiée.

Voir aussi at().

[signal] void QBarSet::valuesAdded(int index, int count)

Ce signal est émis lorsque de nouvelles valeurs sont ajoutées au jeu de barres. index indique la position de la première valeur insérée, et count le nombre de valeurs insérées.

Voir également append() et insert().

[signal] void QBarSet::valuesRemoved(int index, int count)

Ce signal est émis lorsque des valeurs sont retirées du jeu de barres. index indique la position de la première valeur retirée et count le nombre de valeurs retirées.

Voir également remove().

QBarSet &QBarSet::operator<<(const qreal &value)

Un opérateur de commodité pour ajouter la valeur réelle spécifiée par value à la fin du jeu de barres.

Voir aussi append().

qreal QBarSet::operator[](const int index) const

Renvoie la valeur du jeu de barres spécifié par index. Si l'indice est hors limites, 0,0 est renvoyé.

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