QBarSet Class
La classe QBarSet représente un ensemble de barres dans un diagramme à barres. Plus d'informations...
| 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éritages : | QObject |
- Liste de tous les membres, y compris les membres hérités
- QBarSet fait partie de Qt Graphs C++ Classes for 2D.
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 de zéro est utilisée. Les étiquettes des ensembles de valeurs nulles ne sont pas affichées.
Voir également QBarSeries.
Documentation sur les propriétés
borderColor : QColor
Cette propriété définit la couleur de la bordure du jeu 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é indique la largeur de la ligne de bordure. Par défaut, la largeur est égale à -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 du jeu de barres.
Fonctions d'accès :
Signal de notification :
| void | colorChanged(QColor color) |
[read-only] count : qsizetype
Cette propriété contient le nombre de valeurs dans le jeu de barres.
Fonctions d'accès :
| qsizetype | count() const | [see note below] |
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Signal de notification :
| void | countChanged() |
label : QString
Cette propriété contient l'étiquette du jeu de barres.
Fonctions d'accès :
Signal de notification :
| void | labelChanged() |
labelColor : QColor
Cette propriété définit la couleur du texte (étiquette) du jeu 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 index 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 du jeu 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, ils définissent directement les valeurs de l'ensemble de barres.
Si vous définissez une liste de types de points comme valeurs, la coordonnée x du point spécifie son indice de base zéro dans l'ensemble de barres. La taille du jeu de barres est égale à la valeur la plus élevée de la coordonnée x + 1. Si un point est manquant pour toute 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 Notificateur :
| void | valuesChanged() |
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.
[override virtual noexcept] QBarSet::~QBarSet()
Supprime le jeu de barres.
[invokable] 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.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir aussi append().
[invokable] void QBarSet::append(qreal value)
Ajoute la nouvelle valeur spécifiée par value à la fin du jeu de barres.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] qreal QBarSet::at(qsizetype index) const
Renvoie la valeur spécifiée par index à partir du jeu de barres. Si l'indice est hors limites, 0.0 est renvoyé.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QColor QBarSet::borderColor() const
Renvoie la couleur de la ligne pour le jeu de barres.
Remarque : fonction Getter pour la propriété borderColor.
Voir également setBorderColor().
[invokable] void QBarSet::clear()
Supprime toutes les valeurs de l'ensemble.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QColor QBarSet::color() const
Renvoie la couleur de remplissage du jeu de barres.
Remarque : fonction Getter pour la propriété color.
Voir également setColor().
[invokable] qsizetype QBarSet::count() const
Renvoie le nombre de valeurs dans un jeu de barres.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Note : Fonction Getter pour le comptage des propriétés.
[invokable] void QBarSet::deselectAllBars()
Désélectionne toutes les barres de l'ensemble.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setBarSelected().
[invokable] void QBarSet::deselectBar(qsizetype index)
Désélectionne la barre à l'adresse index.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setBarSelected().
[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)
Marque plusieurs barres passées dans une liste indexes comme étant désélectionnées.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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 qui suivent la valeur insérée sont déplacées d'une position.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également remove().
[invokable] bool QBarSet::isBarSelected(qsizetype 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.
Note : 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.
Remarque : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également 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().
QColor QBarSet::labelColor() const
Renvoie la couleur du texte pour le jeu de barres.
Remarque : fonction Getter pour la propriété labelColor.
Voir également setLabelColor().
[invokable] void QBarSet::remove(qsizetype index, qsizetype 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également insert().
[invokable] void QBarSet::replace(qsizetype index, qreal value)
Ajoute la valeur spécifiée par value au jeu de barres à la position spécifiée par index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QBarSet::selectAllBars()
Marque toutes les barres de l'ensemble comme étant sélectionnées.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setBarSelected().
[invokable] void QBarSet::selectBar(qsizetype index)
Marque la barre à index comme étant sélectionnée.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setBarSelected().
[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)
Marque plusieurs barres passées dans une liste indexes comme étant sélectionnées.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setBarSelected().
QList<qsizetype> QBarSet::selectedBars() const
Renvoie une liste de barres marquées comme sélectionnées.
Remarque : fonction Getter pour la propriété selectedBars.
Voir également setBarSelected().
[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)
Ce signal est émis lorsque la barre sélectionnée change. indexes est une liste d'index de barres sélectionnées.
Note : Signal de 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 QBarSet::color est utilisée par défaut.
Remarque : fonction Getter pour la propriété selectedColor.
Voir également setSelectedColor() et color.
[invokable] void QBarSet::setBarSelected(qsizetype 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également 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::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::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::setSelectedColor(QColor color)
Définit l'adresse color des barres sélectionnées.
Remarque : fonction de définition de la propriété selectedColor.
Voir également selectedColor.
[invokable] qreal QBarSet::sum() const
Renvoie la somme de toutes les valeurs du jeu de barres.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)
Change l'état de sélection des barres à l'adresse indexes donnée pour l'état opposé.
Note : Emet QBarSet::selectedBarsChanged.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également setBarSelected().
[signal] void QBarSet::update()
Ce signal est émis lorsque le jeu 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 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.
[signal] void QBarSet::valueChanged(qsizetype index)
Ce signal est émis lorsque la valeur à la position spécifiée par index est modifiée.
Voir aussi at().
[signal] void QBarSet::valueRemoved(qsizetype index, qsizetype 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.
[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype 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(qsizetype index, qsizetype 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<<(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[](qsizetype 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.
