QBarSeries Class
La classe QBarSeries présente des données sous forme de graphiques à barres. Plus d'informations...
| 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éritages : | QAbstractSeries |
- Liste de tous les membres, y compris les membres hérités
- QBarSeries fait partie de Qt Graphs C++ Classes for 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
Cette classe affiche les données par défaut sous la forme d'une série de barres groupées par catégorie, une barre par catégorie de chaque ensemble de barres étant ajoutée à la série. Elle prend également en charge les barres horizontales et le regroupement de barres empilées.
Une série de barres nécessite que l'axe des x de 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 enum décrit le type de la série de barres :
| Constante | Valeur | Description |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | Les séries de barres sont regroupées par catégorie. |
QBarSeries::BarsType::Stacked | 1 | Les séries de barres sont empilées les unes après les autres par catégorie. |
QBarSeries::BarsType::StackedPercent | 2 | Les barres sont empilées les unes à la suite des autres par catégorie. La taille du segment correspond au pourcentage de la valeur du segment par rapport à la valeur totale de tous les segments de la pile. |
enum class QBarSeries::LabelsPosition
Cette valeur 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 sur les propriétés
barDelegate : QQmlComponent*
Cette propriété contient un composant QML personnalisé utilisé pour visualiser chacune des barres. Une instance de ce composant est créée pour chaque barre. Si ce composant n'est pas défini, une visualisation rectangle par défaut est utilisée pour les barres.
Les propriétés dynamiques disponibles pour ce composant sont les suivantes
| Type | Type Nom | Description |
|---|---|---|
| QColor | barColor | La couleur de remplissage de la barre. Cette valeur provient soit de QGraphsTheme, soit de QBarSet::color si 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 | 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 QBarSet::values. |
| QString | barLabel | L'étiquette de la barre. Cette valeur provient du site QBarSet::label. |
| bool | barSelected | Cette valeur est vraie lorsque la barre est sélectionnée, ce qui signifie que l'indice de la barre est dans QBarSet::selectedBars. |
| int | barIndex | Index de la barre, de 0 à la quantité de barres - 1 [depuis 6.9]. |
Pour utiliser l'un de ces éléments, ajoutez une propriété avec 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 d'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 l'unité de l'axe des x. La largeur minimale des barres est de zéro, et les valeurs négatives sont traitées comme zéro. La définition de la largeur à zéro signifie que la largeur de la barre à l'écran est d'un pixel, quelle que soit l'échelle de l'axe des abscisses. Les barres plus larges que zéro sont mises à l'échelle en utilisant l'échelle de l'axe des x.
Par défaut, la largeur de la barre est de 0,5 (les barres prennent 50 % de la largeur disponible). Les valeurs valables 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 au lieu de celle d'une seule barre.
Fonctions d'accès :
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
Signal de notification :
| void | barWidthChanged() |
Voir aussi QBarSeries.
barsType : BarsType
Cette propriété contient 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 s'enroule et recommence avec la première couleur de la liste. Si cette propriété n'est pas définie (par défaut), les couleurs du site 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 de jeux de barres dans une série 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() |
labelsAngle : qreal
Cette propriété indique 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 étiquettes dans une série de barres.
QBarSeries prend en charge la balise de format suivante :
| @valeur | La valeur de la barre |
Par exemple, l'utilisation suivante des balises de format produirait 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, % est ajouté après la valeur. Les étiquettes sont affichées sur la zone de tracé ; si les barres sont proches les unes des autres, les étiquettes peuvent se chevaucher.
Fonctions d'accès :
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
Signal de notification :
| void | labelsFormatChanged(const QString &format) |
Voir aussi labelsVisible, labelsPosition, et labelsPrecision.
labelsMargin : qreal
Cette propriété indique la marge des étiquettes de valeur en pixels.
Cette marge latérale est utilisée lorsque la valeur de labelsPosition est différente de celle de 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é contient la position des étiquettes de valeur.
Fonctions d'accès :
| QBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
Signal du notificateur :
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
Voir aussi labelsVisible et labelsFormat.
labelsPrecision : int
Cette propriété définit le nombre maximum 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é des étiquettes par défaut est false.
Remarque : l'étiquette par défaut n'affiche que la valeur de la série. Vous pouvez créer des étiquettes personnalisées à l'aide d'un barDelegate.
Fonctions d'accès :
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Signal de notification :
| void | labelsVisibleChanged(bool visible) |
Voir aussi 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 s'enroule et recommence avec la première couleur de la liste. Si cette propriété n'est pas définie (par défaut), les couleurs du site QGraphsTheme::seriesColors seront utilisées.
Fonctions d'accès :
| QList<QColor> | seriesColors() const |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
Signal Notificateur :
| void | seriesColorsChanged() |
Fonction membre Documentation
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
Construit une série de barres vides qui est une QObject et un 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 possession. 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)
Ajoute une liste de jeux de barres spécifiés par sets à une série de barres et prend possession des jeux. 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 la 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QBarSet *QBarSeries::at(qsizetype index)
Récupère le site BarSet spécifié à l'emplacement index. Retourne null si aucun BarSet n'a été trouvé.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QList<QBarSet *> QBarSeries::barSets() const
Renvoie une liste de jeux de barres dans une série de barres. Conserve la propriété des séries de barres.
Remarque : fonction Getter pour la propriété barSets.
qreal QBarSeries::barWidth() const
Renvoie la largeur des barres de la série.
Remarque : fonction Getter pour la propriété barWidth.
Voir également setBarWidth().
[signal] void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
Ce signal est émis lorsque les jeux de barres spécifiés par sets sont ajoutés à la série.
Voir également append() et insert().
[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Ce signal est émis lorsque les jeux de barres spécifiés par sets sont retirés de la série.
Voir également remove().
[invokable] void QBarSeries::clear()
Supprime tous les jeux de barres de la série et les efface définitivement.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] qsizetype QBarSeries::count() const
Renvoie le nombre de séries de barres dans une série 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 d'obtention du nombre de propriétés.
[invokable] qsizetype QBarSeries::find(QBarSet *set) const
Renvoie l'index du premier BarSet trouvé tel que défini par set. Retourne -1 si aucun BarSet n'a été trouvé.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)
Insère un jeu de barres spécifié par set dans une série à la position spécifiée par index et prend possession du jeu. 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
bool QBarSeries::labelsVisible() const
Renvoie la visibilité des étiquettes.
Remarque : fonction Getter pour la propriété labelsVisible.
Voir également setLabelsVisible().
[signal] void QBarSeries::labelsVisibleChanged(bool visible)
Ce signal est émis lorsque la visibilité des étiquettes passe à visible.
Note : Signal de notification pour la propriété labelsVisible.
Voir aussi 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 réussit. Renvoie true si la série a été supprimée.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::remove(qsizetype index)
Supprime le site BarSet à l'emplacement index. Le site BarSet sera définitivement supprimé.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
Supprime plusieurs BarSets de la série commençant par index jusqu'à un certain nombre de count. Les BarSets seront définitivement supprimés.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
Remplace toute la liste BarSet à l'intérieur de 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 invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
Remplace le BarSet spécifié par oldValue par celui de newValue. Le BarSet de oldValue sera définitivement supprimé s'il se trouve dans la série. Renvoie true si le remplacement est réussi.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
Remplace le site BarSet présent à l'adresse index par set. Le site original BarSet sera définitivement supprimé.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
void QBarSeries::setBarWidth(qreal width)
Fixe la largeur des barres de la série à width.
Remarque : fonction de définition de la propriété barWidth.
Voir également barWidth().
void QBarSeries::setLabelsVisible(bool visible = true)
Définit la visibilité des étiquettes dans une série de barres à visible.
Remarque : fonction de définition de la propriété labelsVisible.
Voir également labelsVisible().
[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
Ce signal est émis lorsque la valeur d'une barrette est modifiée. index est l'indice de la barrette dans la série. Le numéro des valeurs ajoutées est indiqué par count. barset est un pointeur sur l'ensemble modifié.
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
Ce signal est émis lorsque la valeur d'un jeu de barres est modifiée. index est l'indice du jeu de barres dans la série. barset est un pointeur sur la série modifiée.
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
Ce signal est émis lorsque la valeur d'une barrette est modifiée. index est l'indice de la barrette dans la série. Le numéro des valeurs supprimées est indiqué par count. barset est un pointeur sur l'ensemble modifié.
[invokable] bool QBarSeries::take(QBarSet *set)
Prend une seule set de la série. Ne supprime pas l'objet bar set.
Remarque : la série reste l'objet parent de la série de barres. Vous devez définir l'objet parent pour qu'il devienne propriétaire.
Renvoie true si l'opération d'extraction réussit.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const
Réimplémente une fonction d'accès à 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.
