Sur cette page

QBarSet Class

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

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

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 :

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) de l'ensemble 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 le libellé de l'ensemble 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 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 :

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 :

pen : QPen

Cette propriété contient le stylo utilisé pour tracer les lignes des barres dans l'ensemble de barres.

Fonctions d'accès :

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

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.