QAbstractBarSeries Class
La classe `QAbstractBarSeries` est une classe parente abstraite pour toutes les classes de séries de barres. En savoir plus...
| Header: | #include <QAbstractBarSeries> |
| In QML: | AbstractBarSeries |
| Inherits: | QAbstractSeries |
| Inherited By: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries |
| Status: | Deprecated |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
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 graphiques à barres, les barres sont définies comme des ensembles de barres contenant une valeur de données pour chaque catégorie. La position d'une barre est déterminée par la catégorie et sa hauteur par la valeur de données. Les séries de barres contenant plusieurs ensembles de barres regroupent les barres appartenant à la même catégorie. L'affichage des barres est déterminé par la sous-classe de cette classe choisie pour créer le graphique à barres.
Si une classe « QValueAxis » est utilisée à la place de « QBarCategoryAxis » pour l’axe principal des barres, celles-ci sont regroupées autour de la valeur d’index de la catégorie.
Consultez la galerie « Graphiques avec widgets » pour découvrir comment utiliser la classe ` QBarSeries ` afin de créer un graphique à barres simple.
Voir également QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries et QHorizontalPercentBarSeries.
Documentation sur les types de membres
enum QAbstractBarSeries::LabelsPosition
Cette valeur d'énumération décrit la position des étiquettes des valeurs de données :
| Constante | Valeur | Description |
|---|---|---|
QAbstractBarSeries::LabelsCenter | 0 | L'étiquette est située au centre de la barre. |
QAbstractBarSeries::LabelsInsideEnd | 1 | L'étiquette est située à l'intérieur de la barre, en haut. |
QAbstractBarSeries::LabelsInsideBase | 2 | L'étiquette est située à l'intérieur de la barre, en bas. |
QAbstractBarSeries::LabelsOutsideEnd | 3 | L'étiquette est située à l'extérieur de la barre, en haut. |
Documentation relative aux propriétés
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 celle de l'axe des x.
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) |
Voir également QBarSeries.
[read-only] count : int
Cette propriété indique le nombre de séries 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é 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.
QAbstractBarSeries 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.
labelsPosition : LabelsPosition
Cette propriété définit l'emplacement des étiquettes de valeur.
Fonctions d'accès :
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
Signal de notification :
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
Voir également labelsVisible et labelsFormat.
labelsPrecision : int
Cette propriété définit 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étermine la visibilité des étiquettes dans une série de barres.
Fonctions d'accès :
| bool | isLabelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Signal de notification :
| void | labelsVisibleChanged() |
Documentation des fonctions membres
[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()
Supprime la série de barres abstraite et les ensembles de barres qui lui appartiennent.
bool QAbstractBarSeries::append(QBarSet *set)
Ajoute un ensemble de barres défini 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.
bool QAbstractBarSeries::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 ».
QList<QBarSet *> QAbstractBarSeries::barSets() const
Renvoie une liste des ensembles de barres d'une série de barres. Conserve la propriété des ensembles de barres.
qreal QAbstractBarSeries::barWidth() const
Renvoie la largeur des barres de la série.
Remarque : fonctiongetter pour la propriété barWidth.
Voir aussi setBarWidth().
[signal] void QAbstractBarSeries::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 QAbstractBarSeries::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().
void QAbstractBarSeries::clear()
Supprime tous les ensembles 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 indiquée par ` index ` dans l'ensemble de barres spécifié par ` barset`.
int QAbstractBarSeries::count() const
Renvoie le nombre d'ensembles de barres dans une série de barres.
Remarque : fonctiongetter pour la propriété count.
[signal] void QAbstractBarSeries::countChanged()
Ce signal est émis lorsque le nombre de séries de barres est modifié, par exemple par les fonctions append() ou remove().
Remarque : signalde 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 lorsqu'un curseur de souris survole la barre spécifiée par index dans l'ensemble de barres spécifié par barset. Lorsque la souris survole la barre, status devient true, et lorsque la souris s'en éloigne, il redevient false.
bool QAbstractBarSeries::insert(int 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 aboutit.
bool QAbstractBarSeries::isLabelsVisible() const
Renvoie la visibilité des étiquettes.
Remarque : fonctiongetter pour la propriété « labelsVisible ».
[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)
Ce signal est émis lorsque l'angle des étiquettes de valeur change.
Remarque : signalde notification pour l'labelsAngle de la propriété.
[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)
Ce signal est émis lorsque l'format des étiquettes de valeur des données change.
Remarque : signalde notification pour l'labelsFormat de la propriété.
[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
Ce signal est émis lorsque l'position des étiquettes de valeur change.
Remarque : signalde notification pour l'labelsPosition de la propriété.
[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)
Ce signal est émis lorsque l'precision des étiquettes de valeur change.
Remarque : signalde notification pour l'labelsPrecision de la propriété.
[signal] void QAbstractBarSeries::labelsVisibleChanged()
Ce signal est émis lorsque la visibilité des étiquettes change.
Remarque : signalde 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 indiquée par ` index ` dans l'ensemble de barres spécifié par ` barset ` et maintient le bouton de la souris enfoncé.
[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)
Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur la barre indiqué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 l'efface définitivement si la suppression aboutit. Renvoie ` true ` si l'ensemble a été supprimé.
void QAbstractBarSeries::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 QAbstractBarSeries::setLabelsVisible(bool visible = true)
Définit la visibilité des étiquettes d'une série de barres sur « visible ».
Remarque : fonctionde définition de la propriété labelsVisible.
Voir également ` isLabelsVisible()`.
bool QAbstractBarSeries::take(QBarSet *set)
Récupère une seule barre d'set s de la série. Ne supprime pas l'objet « barset ».
Remarque : la série reste l'objet parent du bar set. Vous devez définir l'objet parent pour en prendre pleinement la propriété.
Renvoie « true » si l’opération « take » aboutit.
© 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.
