QBarSet Class
La classe QBarSet représente un ensemble de barres dans un graphique à barres. En savoir plus...
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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 zéro est utilisée. Les libellés des ensembles de valeur zéro ne sont pas affichés.
Voir également QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries et QHorizontalPercentBarSeries.
Documentation relative aux propriétés
borderColor : QColor
Cette propriété définit la couleur (du trait) de l'ensemble 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 le pinceau utilisé pour remplir les barres de l'ensemble de barres.
Fonctions d'accès :
Signal de notification :
| void | brushChanged() |
color : QColor
Cette propriété définit la couleur de remplissage (pinceau) de l'ensemble de barres.
Fonctions d'accès :
Signal de notification :
| void | colorChanged(QColor color) |
label : QString
Cette propriété contient le libellé de l'ensemble de barres.
Fonctions d'accès :
Signal de notification :
| void | labelChanged() |
labelBrush : QBrush
Cette propriété contient le pinceau utilisé pour dessiner l'étiquette de l'ensemble de barres.
Fonctions d'accès :
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
Signal de notification :
| void | labelBrushChanged() |
labelColor : QColor
Cette propriété définit la couleur du texte (libellé) de l'ensemble 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 afficher l'étiquette de l'ensemble de barres.
Fonctions d'accès :
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
Signal de notification :
| void | labelFontChanged() |
pen : QPen
Cette propriété contient le stylo utilisé pour tracer les lignes des barres dans l'ensemble de barres.
Fonctions d'accès :
Signal de notification :
| void | penChanged() |
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 le parent est « parent ».
[virtual noexcept] QBarSet::~QBarSet()
Supprime l'ensemble de barres.
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.
Voir aussi append ().
void QBarSet::append(const qreal value)
Ajoute la nouvelle valeur spécifiée par « value » à la fin de l'ensemble de barres.
qreal QBarSet::at(const int 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.
QColor QBarSet::borderColor()
Renvoie la couleur des lignes de l'ensemble de barres.
Remarque : fonctiongetter pour la propriété borderColor.
Voir également setBorderColor().
[signal] void QBarSet::borderColorChanged(QColor color)
Ce signal est émis lorsque la couleur du trait (stylo) de l'ensemble de barres passe à « color ».
Remarque : signalde notification pour la propriété borderColor.
QBrush QBarSet::brush() const
Renvoie le pinceau utilisé pour remplir les barres de l'ensemble de barres.
Remarque : fonctiongetter pour la propriété brush.
Voir aussi setBrush().
[signal] void QBarSet::brushChanged()
Ce signal est émis lorsque le pinceau utilisé pour dessiner l'ensemble de barres change.
Remarque : signalde 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 indiquée par ` index ` dans un ensemble de barres.
QColor QBarSet::color()
Renvoie la couleur de remplissage de l'ensemble de barres.
Remarque : fonctiongetter pour la propriété color.
Voir aussi setColor().
[signal] void QBarSet::colorChanged(QColor color)
Ce signal est émis lorsque la couleur de remplissage (pinceau) de l'ensemble de barres passe à color.
Remarque : signalde notification pour la propriété color.
int QBarSet::count() const
Renvoie le nombre de valeurs contenues dans un ensemble de barres.
[since 6.2] void QBarSet::deselectAllBars()
Désélectionne toutes les barres de la série.
Remarque : émet l'événement « QBarSet::selectedBarsChanged ».
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.
Remarque : émet l'événement « QBarSet::selectedBarsChanged ».
Cette fonction a été introduite dans Qt 6.2.
Voir également setBarSelected().
[since 6.2] void QBarSet::deselectBars(const QList<int> &indexes)
Marque comme désélectionnées plusieurs barres transmises dans une liste « indexes ».
Remarque : émet l'QBarSet::selectedBarsChanged.
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 lorsqu'un curseur de souris survole la barre spécifiée par ` index ` dans un ensemble de barres. Lorsque la souris survole la barre, ` status ` devient ` true`, et lorsque la souris s'en éloigne, il redevient ` false`.
void QBarSet::insert(const int index, const qreal value)
Insère value à l'emplacement spécifié par index. Les valeurs suivant la valeur insérée sont décalées d'une position vers le haut.
Voir également remove().
[since 6.2] bool QBarSet::isBarSelected(int 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 choisie si celle-ci a été spécifiée via QBarSet::setSelectedColor.
Cette fonction a été introduite dans Qt 6.2.
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 également setLabel().
QBrush QBarSet::labelBrush() const
Renvoie le pinceau utilisé pour tracer les valeurs sur cet ensemble de barres.
Remarque : fonctionde récupération pour la propriété labelBrush.
Voir aussi setLabelBrush().
[signal] void QBarSet::labelBrushChanged()
Ce signal est émis lorsque le pinceau utilisé pour dessiner l'étiquette de l'ensemble de barres change.
Remarque : signalde notification pour la propriété labelBrush.
Voir également labelBrush.
[signal] void QBarSet::labelChanged()
Ce signal est émis lorsque le libellé de l'ensemble de barres change.
Remarque : signalde notification pour la propriété label.
Voir également label.
QColor QBarSet::labelColor()
Renvoie la couleur du texte de l'ensemble de barres.
Remarque : fonctiongetter pour la propriété labelColor.
Voir aussi setLabelColor().
[signal] void QBarSet::labelColorChanged(QColor color)
Ce signal est émis lorsque la couleur du texte (libellé) de l'ensemble de barres passe à color.
Remarque : signalde notification pour la propriété labelColor.
QFont QBarSet::labelFont() const
Renvoie le stylo utilisé pour tracer des valeurs sur cet ensemble de barres.
Remarque : fonctiongetter pour la propriété labelFont.
Voir aussi setLabelFont().
[signal] void QBarSet::labelFontChanged()
Ce signal est émis lorsque la police de l'étiquette de l'ensemble de barres change.
Remarque : signalde notification pour la propriété labelFont.
Voir également labelBrush.
QPen QBarSet::pen() const
Renvoie le stylo utilisé pour tracer les lignes dans l'ensemble de barres.
Remarque : fonctiongetter pour la propriété pen.
Voir aussi setPen().
[signal] void QBarSet::penChanged()
Ce signal est émis lorsque le stylet utilisé pour dessiner l'ensemble de barres change.
Remarque : signalde 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 indiquée par « index » dans un ensemble de barres et maintient le bouton de la souris enfoncé.
[signal] void QBarSet::released(int index)
Ce signal est émis lorsque l'utilisateur relâche le bouton 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é par count de l'ensemble de barres 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 située à la position indiquée par index.
[since 6.2] void QBarSet::selectAllBars()
Marque toutes les barres de la série comme sélectionnées.
Remarque : génère « QBarSet::selectedBarsChanged ».
Cette fonction a été introduite dans Qt 6.2.
Voir également setBarSelected().
[since 6.2] void QBarSet::selectBar(int index)
Marque la barre située à l'adresse index comme sélectionnée.
Remarque : génère QBarSet::selectedBarsChanged.
Cette fonction a été introduite dans Qt 6.2.
Voir également setBarSelected().
[since 6.2] void QBarSet::selectBars(const QList<int> &indexes)
Marque comme sélectionnées plusieurs barres transmises dans une liste « indexes ».
Remarque : émet l'QBarSet::selectedBarsChanged.
Cette fonction a été introduite dans Qt 6.2.
Voir aussi ` setBarSelected()`.
[since 6.2] QList<int> QBarSet::selectedBars() const
Renvoie une liste des barres marquées comme sélectionnées.
Cette fonction a été introduite dans Qt 6.2.
Voir également 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 également setSelectedColor() et color.
[since 6.2] void QBarSet::setBarSelected(int index, bool selected)
Marque la barre située à l'adresse index comme sélectionnée ou désélectionnée, selon ce qui est spécifié à l'adresse 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.
Cette fonction a été introduite dans Qt 6.2.
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 également borderColor().
void QBarSet::setBrush(const QBrush &brush)
Définit le pinceau utilisé pour remplir les barres de l'ensemble de barres sur « brush ».
Remarque : fonctionde définition de la propriété brush.
Voir également brush().
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 aussi 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::setLabelBrush(const QBrush &brush)
Définit le pinceau utilisé pour tracer les valeurs sur cet ensemble de barres sur « brush ».
Remarque : fonctionde définition pour la propriété labelBrush.
Voir également labelBrush().
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::setLabelFont(const QFont &font)
Définit la police utilisée pour afficher les valeurs sur cet ensemble de barres à l'adresse font.
Remarque : fonctionde définition de la propriété labelFont.
Voir également labelFont().
void QBarSet::setPen(const QPen &pen)
Définit le stylo utilisé pour tracer les lignes de la barre sur « pen ».
Remarque : fonctionde définition de la propriété pen.
Voir également pen().
[since 6.2] void QBarSet::setSelectedColor(const QColor &color)
Définit l'color s 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)
Modifie l'état de sélection des barres situées à l'adresse indexes pour lui attribuer l'état inverse.
Remarque : Émet l'QBarSet::selectedBarsChanged.
Cette fonction a été introduite dans Qt 6.2.
Voir également setBarSelected().
[signal] void QBarSet::valueChanged(int index)
Ce signal est émis lorsque la valeur située à la position spécifiée par ` index ` est modifiée.
Voir également at().
[signal] void QBarSet::valuesAdded(int index, int 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(int index, int 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<<(const 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[](const int 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.