QBarSeries Class
La classe QBarSeries affiche les données sous forme de graphiques à barres. En savoir plus...
| En-tête : | #include <QBarSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | BarSeries |
| Hérite de : | QAbstractSeries |
- Liste de tous les membres, y compris les membres hérités
- QBarSeries fait partie des classes C++ d'Qt Graphs pour le 2D.
Types publics
| enum class | BarsType { Groups, Stacked, StackedPercent } |
| enum class | LabelsPosition { Center, InsideEnd, InsideBase, OutsideEnd } |
Propriétés
|
|
Fonctions publiques
| QBarSeries(QObject *parent = nullptr) | |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QBarSet * | at(qsizetype index) |
| QQmlComponent * | barDelegate() const |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| QBarSeries::BarsType | barsType() const |
| QList<QColor> | borderColors() const |
| void | clear() |
| qsizetype | count() const |
| qsizetype | find(QBarSet *set) const |
| bool | insert(qsizetype index, QBarSet *set) |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| qreal | labelsMargin() const |
| QBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | labelsVisible() const |
| bool | remove(QBarSet *set) |
| bool | remove(qsizetype index) |
| void | removeMultiple(qsizetype index, qsizetype count) |
| bool | replace(const QList<QBarSet *> &sets) |
| bool | replace(QBarSet *oldValue, QBarSet *newValue) |
| void | replace(qsizetype index, QBarSet *set) |
| QList<QColor> | seriesColors() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
| void | setBarWidth(qreal width) |
| void | setBarsType(QBarSeries::BarsType type) |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsMargin(qreal margin) |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
| bool | take(QBarSet *set) |
Fonctions publiques réimplémentées
| virtual QAbstractSeries::SeriesType | type() const override |
Signaux
| void | barDelegateChanged() |
| void | barSetsChanged() |
| void | barWidthChanged() |
| void | barsTypeChanged(QBarSeries::BarsType type) |
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | borderColorsChanged() |
| void | countChanged() |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsMarginChanged(qreal margin) |
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged(bool visible) |
| void | seriesColorsChanged() |
| void | setValueAdded(qsizetype index, qsizetype count, QBarSet *barset) |
| void | setValueChanged(qsizetype index, QBarSet *barset) |
| void | setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset) |
| void | updatedBars() |
Description détaillée
Par défaut, cette classe affiche les données sous la forme d'une série de barres regroupées par catégorie, une barre par catégorie provenant de chaque ensemble de barres étant ajoutée à la série. Elle prend également en charge les barres horizontales et le regroupement des barres sous forme de barres empilées.
Une série de barres nécessite que l'axe des x GraphsView soit défini sur BarCategoryAxis et que l'axe des y soit défini sur ValueAxis.
Voir également QBarSet et QAbstractSeries.
Documentation sur les types de membres
enum class QBarSeries::BarsType
Cette valeur d'énumération décrit le type de la série de barres :
| Constante | Valeur | Description |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | Les ensembles de barres sont regroupés par catégorie. |
QBarSeries::BarsType::Stacked | 1 | Les ensembles de barres sont empilés les uns après les autres par catégorie. |
QBarSeries::BarsType::StackedPercent | 2 | Les séries de barres sont empilées les unes après les autres par catégorie. La taille d'un segment correspond au pourcentage de la valeur de ce segment par rapport à la valeur totale de tous les segments de la pile. |
enum class QBarSeries::LabelsPosition
Cette valeur d'énumération décrit la position des étiquettes des valeurs de données :
| Constante | Valeur | Description |
|---|---|---|
QBarSeries::LabelsPosition::Center | 0 | L'étiquette est située au centre de la barre. |
QBarSeries::LabelsPosition::InsideEnd | 1 | L'étiquette est située à l'intérieur de la barre, en haut. |
QBarSeries::LabelsPosition::InsideBase | 2 | L'étiquette est située à l'intérieur de la barre, en bas. |
QBarSeries::LabelsPosition::OutsideEnd | 3 | L'étiquette est située à l'extérieur de la barre, en haut. |
Documentation relative aux propriétés
barDelegate : QQmlComponent*
Cette propriété contient un composant QML personnalisé utilisé pour afficher chacune des barres. Une instance de ce composant est créée pour chaque barre. Si cette propriété n'est pas définie, un rectangle par défaut est utilisé pour afficher les barres.
Les propriétés dynamiques disponibles pour ce composant sont les suivantes :
| Type | Nom | Description |
|---|---|---|
| QColor | barColor | Couleur de remplissage de la barre. Cette valeur provient soit de l’ QGraphsTheme, soit de QBarSet::color si l’ QBarSet remplace la couleur. |
| QColor | barBorderColor | Couleur de la bordure de la barre. Cette valeur provient soit de QGraphsTheme, soit de QBarSet::borderColor si QBarSet remplace la couleur. |
| qreal | barBorderWidth | La largeur de la bordure de la barre. Cette valeur provient soit de QGraphsTheme, soit de QBarSet::borderWidth si QBarSet remplace la largeur. |
| qreal | barValue | La valeur de la barre. Cette valeur provient de la méthode QBarSet::values. |
| QString | barLabel | L'étiquette de la barre. Cette valeur provient de QBarSet::label. |
| bool | barSelected | Cette valeur est vraie lorsque la barre est sélectionnée, ce qui signifie que l'index de la barre figure dans QBarSet::selectedBars. |
| int | barIndex | Index de la barre, compris entre 0 et le nombre total de barres moins 1. [à partir de la version 6.9] |
Pour utiliser l'une de ces propriétés, ajoutez une propriété portant le nom défini dans votre composant personnalisé. Par exemple : "property color barColor" et "property real barValue".
Fonctions d'accès :
| QQmlComponent * | barDelegate() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
Signal de notification :
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *>
Cette propriété contient une liste des ensembles ajoutés à la série.
Fonctions d'accès :
| QList<QBarSet *> | barSets() const |
Signal de notification :
| void | barSetsChanged() |
barWidth : qreal
Cette propriété définit la largeur des barres de la série.
L'unité de largeur est celle de l'axe des x. La largeur minimale des barres est zéro, et les valeurs négatives sont considérées comme égales à zéro. Définir la largeur sur zéro signifie que la largeur de la barre à l'écran est d'un pixel, quelle que soit l'échelle de l'axe des x. Les barres dont la largeur est supérieure à zéro sont mises à l'échelle en fonction de l'échelle de l'axe des x.
Par défaut, la valeur de barWidth est de 0,5 (les barres occuperont 50 % de la largeur disponible). Les valeurs valides vont de 0,0 (0 %) à 1,0 (100 %).
Remarque : lorsqu’elle est utilisée avec ` QBarSeries`, cette valeur spécifie la largeur d’un groupe de barres plutôt que celle d’une seule barre.
Fonctions d'accès :
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
Signal de notification :
| void | barWidthChanged() |
Voir également QBarSeries.
barsType : BarsType
Cette propriété indique le type de la série de barres.
Fonctions d'accès :
| QBarSeries::BarsType | barsType() const |
| void | setBarsType(QBarSeries::BarsType type) |
Signal de notification :
| void | barsTypeChanged(QBarSeries::BarsType type) |
borderColors : QList<QColor>
Cette propriété contient la liste des couleurs de bordure à utiliser pour tous les objets de la série.
S'il y a plus de séries que de couleurs, la liste des couleurs recommence par la première couleur de la liste. Si cette propriété n'est pas définie (valeur par défaut), les couleurs de l'QGraphsTheme::borderColors seront utilisées.
Fonctions d'accès :
| QList<QColor> | borderColors() const |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
Signal de notification :
| void | borderColorsChanged() |
[read-only] count : qsizetype
Cette propriété indique le nombre d'ensembles de barres dans une série 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() |
labelsAngle : qreal
Cette propriété définit l'angle des étiquettes de valeur en degrés.
Fonctions d'accès :
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
Signal de notification :
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
Cette propriété définit le format utilisé pour afficher les libellés dans une série de barres.
QBarSeries Prend en charge la balise de format suivante :
| @value | La valeur de la barre |
Par exemple, l'utilisation suivante des balises de format générerait des étiquettes affichant la valeur suivie de l'unité (u) :
series->setLabelsFormat("@value u");Par défaut, les étiquettes affichent la valeur de la barre. Pour les séries de barres en pourcentage, le symbole % est ajouté après la valeur. Les étiquettes s'affichent dans la zone de tracé ; si les barres sont proches les unes des autres, elles peuvent se chevaucher.
Fonctions d'accès :
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
Signal de notification :
| void | labelsFormatChanged(const QString &format) |
Voir également labelsVisible, labelsPosition et labelsPrecision.
labelsMargin : qreal
Cette propriété définit la marge des étiquettes de valeur en pixels.
Cette marge latérale est utilisée lorsque la propriété « labelsPosition » est définie sur une valeur autre que « LabelsPosition.Center ». La valeur par défaut est « 0 ».
Fonctions d'accès :
| qreal | labelsMargin() const |
| void | setLabelsMargin(qreal margin) |
Signal de notification :
| void | labelsMarginChanged(qreal margin) |
labelsPosition : LabelsPosition
Cette propriété détermine l'emplacement des étiquettes de valeur.
Fonctions d'accès :
| QBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
Signal de notification :
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
Voir également labelsVisible et labelsFormat.
labelsPrecision : int
Cette propriété détermine le nombre maximal de chiffres significatifs affichés dans les étiquettes de valeur.
La valeur par défaut est 6.
Fonctions d'accès :
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
Signal de notification :
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
Cette propriété définit la visibilité des étiquettes dans une série de barres. La visibilité par défaut des étiquettes est « false ».
Remarque : l'étiquette par défaut affiche uniquement la valeur de l'ensemble. Vous pouvez créer des étiquettes personnalisées à l'aide d'une barDelegate.
Fonctions d'accès :
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Signal de notification :
| void | labelsVisibleChanged(bool visible) |
Voir également barDelegate.
seriesColors : QList<QColor>
Cette propriété contient la liste des couleurs de base à utiliser pour tous les objets de la série.
S'il y a plus de séries que de couleurs, la liste des couleurs revient au début et recommence avec la première couleur de la liste. Si cette propriété n'est pas définie (valeur par défaut), les couleurs de l'QGraphsTheme::seriesColors seront utilisées.
Fonctions d'accès :
| QList<QColor> | seriesColors() const |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
Signal de notification :
| void | seriesColorsChanged() |
Documentation des fonctions membres
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
Crée une série de barres vide qui est une « QObject » et un élément enfant de « parent ».
[invokable] bool QBarSeries::append(QBarSet *set)
Ajoute un ensemble de barres spécifié par ` set ` à la série de barres et en prend la propriété. Si l'ensemble est nul ou s'il appartient déjà à la série, il ne sera pas ajouté. Renvoie ` true ` si l'ajout a réussi.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)
Ajoute une liste d’ensembles de barres spécifiés par sets à une série de barres et en prend la propriété. Renvoie « true » si tous les ensembles ont été ajoutés avec succès. Si l’un des ensembles est nul ou a déjà été ajouté à la série, rien n’est ajouté et cette fonction renvoie « false ». Si l’un des ensembles apparaît plus d’une fois dans la liste, rien n’est ajouté et cette fonction renvoie « false ».
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QBarSet *QBarSeries::at(qsizetype index)
Récupère l'BarSet spécifié à l'emplacement index. Renvoie null si aucun BarSet n'a été trouvé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
QList<QBarSet *> QBarSeries::barSets() const
Renvoie une liste des ensembles de barres d'une série de barres. Conserve la propriété des ensembles de barres.
Remarque : fonctionde récupération pour la propriété barSets.
qreal QBarSeries::barWidth() const
Renvoie la largeur des barres de la série.
Remarque : fonctiongetter pour la propriété barWidth.
Voir aussi setBarWidth().
[signal] void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
Ce signal est émis lorsque les barres définies par sets sont ajoutées à la série.
Voir également append() et insert().
[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Ce signal est émis lorsque les barres définies par sets sont supprimées de la série.
Voir également remove().
[invokable] void QBarSeries::clear()
Supprime tous les ensembles de barres de la série et les efface définitivement.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] qsizetype QBarSeries::count() const
Renvoie le nombre d'ensembles de barres dans une série de barres.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Remarque : fonction de lecture (getter ) pour la propriété count.
[invokable] qsizetype QBarSeries::find(QBarSet *set) const
Renvoie l'index du premier « BarSet » trouvé, tel que défini par set. Renvoie -1 si aucun « BarSet » n'a été trouvé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)
Insère un ensemble de barres spécifié par set dans une série à la position indiquée par index et en prend possession. Si l'ensemble est nul ou appartient déjà à la série, il ne sera pas ajouté. Renvoie true si l'insertion réussit.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
bool QBarSeries::labelsVisible() const
Renvoie la visibilité des étiquettes.
Remarque : fonctiongetter pour la propriété labelsVisible.
Voir aussi setLabelsVisible().
[signal] void QBarSeries::labelsVisibleChanged(bool visible)
Ce signal est émis lorsque la visibilité des étiquettes passe à « visible ».
Remarque : signalde notification pour la propriété labelsVisible.
Voir également ` labelsVisible()` et ` setLabelsVisible()`.
[invokable] bool QBarSeries::remove(QBarSet *set)
Supprime de la série l'ensemble de barres spécifié par ` set ` et le supprime définitivement si la suppression aboutit. Renvoie ` true ` si l'ensemble a été supprimé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::remove(qsizetype index)
Supprime l'BarSet situé à l'adresse index. L'BarSet sera définitivement supprimé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
Supprime plusieurs BarSets de la série, en commençant par index jusqu'au nombre indiqué par count. Les BarSets seront définitivement supprimés.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
Remplace l’intégralité de la liste BarSet contenue dans cet BarSeries par les BarSets spécifiés par sets. Tous les BarSets d’origine seront définitivement supprimés. Renvoie true si tous les BarSets ont été remplacés.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
Remplace l’ BarSet e spécifié par oldValue par celui de newValue. L’ BarSet e de oldValue sera définitivement supprimé s’il est présent dans la série. Renvoie true si le remplacement a réussi.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
Remplace la page « BarSet » disponible à l'adresse index par set. La page d'origine BarSet sera définitivement supprimée.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
void QBarSeries::setBarWidth(qreal width)
Définit la largeur des barres de la série sur width.
Remarque : fonctionde définition de la propriété barWidth.
Voir aussi ` barWidth()`.
void QBarSeries::setLabelsVisible(bool visible = true)
Définit la visibilité des libellés d'une série de barres sur « visible ».
Remarque : fonctionde définition de la propriété labelsVisible.
Voir également ` labelsVisible()`.
[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
Ce signal est émis lorsqu'une valeur d'un ensemble de barres est modifiée. ` index ` correspond à l'index de l'ensemble de barres dans la série. Le nombre de valeurs ajoutées est indiqué par ` count`. La variable ` barset ` est un pointeur vers l'ensemble modifié.
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
Ce signal est émis lorsque la valeur d'un ensemble de barres est modifiée. ` index ` correspond à l'index de l'ensemble de barres dans la série. ` barset ` est un pointeur vers l'ensemble modifié.
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
Ce signal est émis lorsqu'une valeur d'un ensemble de barres est modifiée. ` index ` correspond à l'index de l'ensemble de barres dans la série. Le nombre de valeurs supprimées est indiqué dans ` count`. ` barset ` est un pointeur vers l'ensemble modifié.
[invokable] bool QBarSeries::take(QBarSet *set)
Récupère une seule barre « set » de la série. Ne supprime pas l'objet «bar set».
Remarque : la série reste l'objet parent du bar set. Vous devez définir l'objet parent pour en prendre la pleine propriété.
Renvoie ` true ` si l'opération de prise de contrôle réussit.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const
Réimplémente une fonction d'accès pour la propriété : QAbstractSeries::type.
Renvoie la série de barres.
[signal] void QBarSeries::updatedBars()
Ce signal est émis lorsque les barres sont mises à jour.
© 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.
