Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QAbstractBarSeries Class

La classe QAbstractBarSeries est une classe parentale abstraite pour toutes les classes de séries de barres. Plus d'informations...

Header: #include <QAbstractBarSeries>
In QML: AbstractBarSeries
Inherits: QAbstractSeries
Inherited By:

QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries

Types publics

enum LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd }

Propriétés

Fonctions publiques

virtual ~QAbstractBarSeries()
bool append(QBarSet *set)
bool append(const QList<QBarSet *> &sets)
QList<QBarSet *> barSets() const
qreal barWidth() const
void clear()
int count() const
bool insert(int index, QBarSet *set)
bool isLabelsVisible() const
qreal labelsAngle() const
QString labelsFormat() const
QAbstractBarSeries::LabelsPosition labelsPosition() const
int labelsPrecision() const
bool remove(QBarSet *set)
void setBarWidth(qreal width)
void setLabelsAngle(qreal angle)
void setLabelsFormat(const QString &format)
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)
void setLabelsPrecision(int precision)
void setLabelsVisible(bool visible = true)
bool take(QBarSet *set)

Signaux

void barsetsAdded(const QList<QBarSet *> &sets)
void barsetsRemoved(const QList<QBarSet *> &sets)
void clicked(int index, QBarSet *barset)
void countChanged()
void doubleClicked(int index, QBarSet *barset)
void hovered(bool status, int index, QBarSet *barset)
void labelsAngleChanged(qreal angle)
void labelsFormatChanged(const QString &format)
void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
void labelsPrecisionChanged(int precision)
void labelsVisibleChanged()
void pressed(int index, QBarSet *barset)
void released(int index, QBarSet *barset)

Description détaillée

Dans les diagrammes à barres, les barres sont définies comme des ensembles de barres qui contiennent une valeur de données pour chaque catégorie. La position d'une barre est spécifiée par la catégorie et sa hauteur par la valeur des données. Les séries de barres qui contiennent plusieurs ensembles de barres regroupent les barres qui appartiennent à la même catégorie. La manière dont les barres sont affichées est déterminée par la sous-classe de cette classe choisie pour créer le diagramme à barres.

Si une adresse QValueAxis est utilisée à la place de QBarCategoryAxis pour l'axe principal des barres, les barres sont regroupées autour de la valeur de l'indice de la catégorie.

Voir la galerie Charts with Widgets pour apprendre à utiliser la classe QBarSeries pour créer un diagramme à barres simple.

Voir également QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, et QHorizontalPercentBarSeries.

Documentation sur les types de membres

enum QAbstractBarSeries::LabelsPosition

Cette valeur décrit la position des étiquettes des valeurs de données :

ConstanteValeurDescription
QAbstractBarSeries::LabelsCenter0L'étiquette est située au centre de la barre.
QAbstractBarSeries::LabelsInsideEnd1L'étiquette est située à l'intérieur de la barre en haut.
QAbstractBarSeries::LabelsInsideBase2L'étiquette est située à l'intérieur de la barre en bas.
QAbstractBarSeries::LabelsOutsideEnd3L'étiquette est située à l'extérieur de la barre en haut.

Documentation sur les propriétés

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.

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)

Voir également QBarSeries.

[read-only] count : int

Cette propriété indique le nombre de jeux de barres dans une série de barres.

Fonctions d'accès :

int count() const

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.

QAbstractBarSeries prend en charge la balise de format suivante :

@valeurLa 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.

labelsPosition : LabelsPosition

Cette propriété contient la position des étiquettes de valeur.

Fonctions d'accès :

QAbstractBarSeries::LabelsPosition labelsPosition() const
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)

Signal du notificateur :

void labelsPositionChanged(QAbstractBarSeries::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.

Fonctions d'accès :

bool isLabelsVisible() const
void setLabelsVisible(bool visible = true)

Signal Notificateur :

void labelsVisibleChanged()

Fonction membre Documentation

[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()

Supprime la série de barres abstraites et les séries de barres qui lui appartiennent.

bool QAbstractBarSeries::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.

bool QAbstractBarSeries::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.

QList<QBarSet *> QAbstractBarSeries::barSets() const

Renvoie une liste de jeux de barres dans une série de barres. Conserve la propriété des jeux de barres.

qreal QAbstractBarSeries::barWidth() const

Renvoie la largeur des barres de la série.

Remarque : fonction Getter pour la propriété barWidth.

Voir également setBarWidth().

[signal] void QAbstractBarSeries::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 QAbstractBarSeries::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().

void QAbstractBarSeries::clear()

Supprime tous les jeux de barres de la série et les efface définitivement.

[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.

int QAbstractBarSeries::count() const

Renvoie le nombre de jeux de barres dans une série de barres.

Remarque : fonction Getter pour le comptage des propriétés.

[signal] void QAbstractBarSeries::countChanged()

Ce signal est émis lorsque le nombre de jeux de barres est modifié, par exemple par append() ou remove().

Note : Signal de notification pour la propriété count.

[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)

Ce signal est émis lorsque l'utilisateur double-clique sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.

[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)

Ce signal est émis lorsque la souris passe au-dessus de la barre spécifiée par index dans l'ensemble de barres spécifié par barset. Lorsque la souris passe au-dessus de la barre, status devient true, et lorsque la souris s'éloigne à nouveau, elle devient false.

bool QAbstractBarSeries::insert(int 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.

bool QAbstractBarSeries::isLabelsVisible() const

Renvoie la visibilité des étiquettes.

Remarque : fonction Getter pour la propriété labelsVisible.

[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)

Ce signal est émis lorsque l'adresse angle des étiquettes de valeur change.

Note : Signal de notification pour la propriété labelsAngle.

[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)

Ce signal est émis lorsque l'adresse format des étiquettes de valeurs de données change.

Note : Signal de notification pour la propriété labelsFormat.

[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

Ce signal est émis lorsque le site position des étiquettes de valeur change.

Note : Signal de notification pour la propriété labelsPosition.

[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)

Ce signal est émis lorsque l'adresse precision des étiquettes de valeur change.

Note : Signal de notification pour la propriété labelsPrecision.

[signal] void QAbstractBarSeries::labelsVisibleChanged()

Ce signal est émis lorsque la visibilité des étiquettes change.

Note : Signal de notification pour la propriété labelsVisible.

Voir également isLabelsVisible() et setLabelsVisible().

[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset et qu'il maintient le bouton de la souris enfoncé.

[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)

Ce signal est émis lorsque l'utilisateur relâche la pression de la souris sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.

bool QAbstractBarSeries::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.

void QAbstractBarSeries::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 QAbstractBarSeries::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 isLabelsVisible().

bool QAbstractBarSeries::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.

© 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.