Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QBarSet Class

La classe QBarSet représente un ensemble de barres dans un graphique à barres. En savoir plus...

En-tête : #include <QBarSet>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : BarSet
Hérite de : QObject

Propriétés

Fonctions publiques

QBarSet(const QString &label, QObject *parent = nullptr)
virtual ~QBarSet() override
void append(const QList<qreal> &values)
void append(qreal value)
qreal at(qsizetype index) const
QColor borderColor() const
qreal borderWidth() const
void clear()
QColor color() const
qsizetype count() const
void deselectAllBars()
void deselectBar(qsizetype index)
void deselectBars(const QList<qsizetype> &indexes)
void insert(qsizetype index, qreal value)
bool isBarSelected(qsizetype index) const
QString label() const
QColor labelColor() const
void remove(qsizetype index, qsizetype count = 1)
void replace(qsizetype index, qreal value)
void selectAllBars()
void selectBar(qsizetype index)
void selectBars(const QList<qsizetype> &indexes)
QList<qsizetype> selectedBars() const
QColor selectedColor() const
void setBarSelected(qsizetype index, bool selected)
void setBorderColor(QColor color)
void setBorderWidth(qreal borderWidth)
void setColor(QColor color)
void setLabel(const QString &label)
void setLabelColor(QColor color)
void setSelectedColor(QColor color)
void setValues(const QVariantList &values)
qreal sum() const
void toggleSelection(const QList<qsizetype> &indexes)
QVariantList values() const
QBarSet &operator<<(qreal value)
qreal operator[](qsizetype index) const

Signaux

void borderColorChanged(QColor color)
void borderWidthChanged(qreal width)
void colorChanged(QColor color)
void countChanged()
void labelChanged()
void labelColorChanged(QColor color)
void selectedBarsChanged(const QList<qsizetype> &indexes)
void selectedColorChanged(QColor color)
void update()
void updatedBars()
void valueAdded(qsizetype index, qsizetype count)
void valueChanged(qsizetype index)
void valueRemoved(qsizetype index, qsizetype count)
void valuesAdded(qsizetype index, qsizetype count)
void valuesChanged()
void valuesRemoved(qsizetype index, qsizetype 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 zéro est utilisée. Les libellés des ensembles de valeurs nulles ne sont pas affichés.

Voir également QBarSeries.

Documentation sur les propriétés

borderColor : QColor

Cette propriété définit la couleur de la bordure de l'ensemble de barres.

Fonctions d'accès :

QColor borderColor() const
void setBorderColor(QColor color)

Signal de notification :

void borderColorChanged(QColor color)

borderWidth : qreal

Cette propriété définit la largeur de la ligne de bordure. Par défaut, la valeur 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 borderWidth)

Signal de notification :

void borderWidthChanged(qreal width)

color : QColor

Cette propriété définit la couleur de remplissage de l'ensemble de barres.

Fonctions d'accès :

QColor color() const
void setColor(QColor color)

Signal de notification :

void colorChanged(QColor color)

[read-only] count : qsizetype

Cette propriété contient le nombre de valeurs de l'ensemble de barres.

Fonctions d'accès :

qsizetype count() const[see note below]

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Signal de notification :

void countChanged()

label : QString

Cette propriété contient le libellé de l'ensemble de barres.

Fonctions d'accès :

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

Signal de notification :

void labelChanged()

labelColor : QColor

Cette propriété définit la couleur du texte (libellé) de l'ensemble de barres.

Fonctions d'accès :

QColor labelColor() const
void setLabelColor(QColor color)

Signal de notification :

void labelColorChanged(QColor color)

[read-only] selectedBars : QList<qsizetype>

Cette propriété contient les indices des barres actuellement sélectionnées.

Fonctions d'accès :

QList<qsizetype> selectedBars() const

Signal de notification :

void selectedBarsChanged(const QList<qsizetype> &indexes)

selectedColor : QColor

Cette propriété contient la couleur de remplissage de l'ensemble sélectionné.

Fonctions d'accès :

QColor selectedColor() const
void setSelectedColor(QColor color)

Signal de notification :

void selectedColorChanged(QColor color)

values : QVariantList

Cette propriété contient les valeurs de l'ensemble de barres.

Vous pouvez définir une liste de types « real » ou « point » comme valeurs.

Si vous définissez une liste de types réels comme valeurs, celles-ci définissent directement les valeurs de l'ensemble de barres.

Si vous définissez une liste de types « point » comme valeurs, la coordonnée x du point spécifie son index (à partir de zéro) dans l’ensemble de barres. La taille de l’ensemble de barres correspond à la valeur la plus élevée de la coordonnée x + 1. Si un point manque pour une coordonnée x comprise entre zéro et la valeur la plus élevée, il prend la valeur zéro.

Fonctions d’accès :

QVariantList values() const
void setValues(const QVariantList &values)

Signal de notification :

void valuesChanged()

Documentation des fonctions membres

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

Crée un ensemble de barres portant le libellé « label » et dont l'élément parent est « parent ».

[override virtual noexcept] QBarSet::~QBarSet()

Supprime l'ensemble de barres.

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

Ajoute la liste des valeurs réelles spécifiées par values à la fin de l'ensemble de barres.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également append ().

[invokable] void QBarSet::append(qreal value)

Ajoute la nouvelle valeur spécifiée par value à la fin de l'ensemble de barres.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[invokable] qreal QBarSet::at(qsizetype index) const

Renvoie la valeur spécifiée par ` index ` dans l'ensemble de barres. Si l'index est hors limites, la fonction renvoie 0,0.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

QColor QBarSet::borderColor() const

Renvoie la couleur de la ligne pour l'ensemble de barres.

Remarque : fonctiongetter pour la propriété borderColor.

Voir aussi setBorderColor().

[invokable] void QBarSet::clear()

Supprime toutes les valeurs de l'ensemble.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

QColor QBarSet::color() const

Renvoie la couleur de remplissage de l'ensemble de barres.

Remarque : fonctiongetter pour la propriété color.

Voir aussi setColor().

[invokable] qsizetype QBarSet::count() const

Renvoie le nombre de valeurs contenues dans un ensemble de barres.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Remarque : fonctiongetter pour la propriété count.

[invokable] void QBarSet::deselectAllBars()

Désélectionne toutes les barres de l'ensemble.

Remarque : émet un événement « QBarSet::selectedBarsChanged ».

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également setBarSelected().

[invokable] void QBarSet::deselectBar(qsizetype index)

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

Remarque : Émet QBarSet::selectedBarsChanged.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également setBarSelected().

[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)

Marque comme désélectionnées plusieurs barres transmises dans une liste « indexes ».

Remarque : Émet QBarSet::selectedBarsChanged.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également setBarSelected().

[invokable] void QBarSet::insert(qsizetype index, qreal value)

Insère « value » à la position spécifiée par « index ». Les valeurs suivant la valeur insérée sont décalées d'une position vers le haut.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également remove().

[invokable] bool QBarSet::isBarSelected(qsizetype index) const

Renvoie « true » si la barre située à l'index e indiquée figure parmi les barres sélectionnées, et « false » dans le cas contraire.

Remarque : les barressélectionnées sont dessinées dans la couleur sélectionnée si celle-ci a été spécifiée à l’aide de QBarSet::setSelectedColor.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également selectedBars(), setBarSelected() et setSelectedColor().

QString QBarSet::label() const

Renvoie le libellé de l'ensemble de barres.

Remarque : fonctiongetter pour la propriété label.

Voir aussi setLabel().

QColor QBarSet::labelColor() const

Renvoie la couleur du texte de l'ensemble de barres.

Remarque : fonctiongetter pour la propriété labelColor.

Voir aussi : `setLabelColor()`

[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)

Supprime le nombre de valeurs spécifié par count de l'ensemble de barres commençant par la valeur spécifiée par index.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également insert().

[invokable] void QBarSet::replace(qsizetype index, qreal value)

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

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[invokable] void QBarSet::selectAllBars()

Marque toutes les barres de l'ensemble comme sélectionnées.

Remarque : Émet « QBarSet::selectedBarsChanged ».

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également setBarSelected().

[invokable] void QBarSet::selectBar(qsizetype index)

Marque la barre située à l'adresse index comme sélectionnée.

Remarque : émet QBarSet::selectedBarsChanged.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également setBarSelected().

[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)

Marque comme sélectionnées plusieurs barres transmises dans une liste « indexes ».

Remarque : Émet QBarSet::selectedBarsChanged.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également setBarSelected().

QList<qsizetype> QBarSet::selectedBars() const

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

Remarque : fonctiongetter pour la propriété selectedBars.

Voir aussi setBarSelected().

[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)

Ce signal est émis lorsque la barre sélectionnée change. ` indexes ` est une liste contenant les indices des barres sélectionnées.

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

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 la propriété « QBarSet::color » est utilisée par défaut.

Remarque : fonctiongetter pour la propriété selectedColor.

Voir également setSelectedColor() et color.

[invokable] void QBarSet::setBarSelected(qsizetype index, bool selected)

Marque la barre située à l'adresse index comme sélectionnée ou désélectionnée, selon les spécifications de selected.

Remarque : les barressélectionnées sont dessinées à l’aide de la couleur sélectionnée si celle-ci a été spécifiée. Émet QBarSet::selectedBarsChanged.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

Voir également isBarSelected() et setSelectedColor().

void QBarSet::setBorderColor(QColor color)

Définit la couleur des lignes de la série de barres sur « color ».

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

Voir aussi borderColor().

void QBarSet::setColor(QColor color)

Définit la couleur de remplissage de l'ensemble de barres sur color.

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

Voir également color().

void QBarSet::setLabel(const QString &label)

Définit « label » comme nouvelle étiquette pour l'ensemble de barres.

Remarque : fonctionde définition de la propriété label.

Voir aussi label().

void QBarSet::setLabelColor(QColor color)

Définit la couleur du texte de la barre définie par ` color`.

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

Voir également labelColor().

void QBarSet::setSelectedColor(QColor color)

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

Remarque : fonctionde définition de la propriété « selectedColor ».

Voir aussi selectedColor.

[invokable] qreal QBarSet::sum() const

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

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)

Modifie l'état de sélection des barres à l'adresse indexes pour lui attribuer l'état inverse.

Remarque : Émet l'QBarSet::selectedBarsChanged.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir ` Q_INVOKABLE`.

Voir également setBarSelected().

[signal] void QBarSet::update()

Ce signal est émis lorsque l'ensemble de barres est mis à jour.

[signal] void QBarSet::updatedBars()

Ce signal est émis lorsque les barres de cet ensemble sont mises à jour.

[signal] void QBarSet::valueAdded(qsizetype index, qsizetype count)

Ce signal est émis lorsque de nouvelles valeurs sont ajoutées à l'ensemble de barres. ` index ` indique la position de la première valeur insérée, et ` count ` correspond au nombre de valeurs insérées.

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

Ce signal est émis lorsque la valeur située à l'emplacement spécifié par index est modifiée.

Voir également at().

[signal] void QBarSet::valueRemoved(qsizetype index, qsizetype count)

Ce signal est émis lorsque des valeurs sont supprimées de l'ensemble de barres. ` index ` indique la position de la première valeur supprimée, et ` count ` correspond au nombre de valeurs supprimées.

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

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

Voir également append() et insert().

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

Ce signal est émis lorsque des valeurs sont supprimées de l'ensemble de barres. ` index ` indique la position de la première valeur supprimée, et ` count ` correspond au nombre de valeurs supprimées.

Voir également remove().

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

Opérateur de commodité permettant d'ajouter la valeur réelle spécifiée par value à la fin de l'ensemble de barres.

Voir également append().

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

Renvoie la valeur de la série de barres spécifiée par ` index`. Si l'index est hors limites, la fonction renvoie 0,0.

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