BarSeries QML Type
Présente les données sous forme de graphiques à barres. En savoir plus…
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- Liste de tous les membres, y compris les membres hérités
- BarSeries fait partie des types QML 2D d'Qt Graphs .
Propriétés
- barDelegate : Component
- barSets : list<BarSet>
- barWidth : real
- barsType : enumeration
- borderColors : list<color>
- count : int
- labelsAngle : real
- labelsFormat : string
- labelsMargin : real
- labelsPosition : enumeration
- labelsPrecision : real
- labelsVisible : bool
- seriesColors : list<color>
Signaux
- barsetsAdded()
- barsetsRemoved()
- clicked(int index, BarSet barset)
- doubleClicked(int index, BarSet barset)
- pressed(int index, BarSet barset)
- released(int index, BarSet barset)
Méthodes
- bool append(BarSet barset)
- BarSet at(int index)
- Barset at(int index)
- void clear()
- int find(BarSet barset)
- BarSet insert(int index, BarSet barset)
- bool remove(BarSet barset)
- bool remove(int index)
- void removeMultiple(int index, int count)
- bool replace(list<BarSet> sets)
- bool replace(BarSet oldSet, BarSet newSet)
- bool replace(int index, BarSet barset)
Description détaillée
Affiche par défaut les données sous forme d'une série de barres regroupées par catégorie, avec une barre par catégorie pour chaque ensemble de barres ajouté à la série. Il prend également en charge les barres horizontales et le regroupement des barres sous forme de barres empilées.
Documentation sur les propriétés
barDelegate : Component
Composant QML personnalisé utilisé pour afficher chacune des barres. Une instance de ce composant est créée pour chaque barre. Si ce composant n'est pas défini, c'est un rectangle par défaut qui sert à afficher les barres.
Les propriétés dynamiques disponibles pour ce composant sont les suivantes :
| Type | Nom | Description |
|---|---|---|
| couleur | barColor | Couleur de remplissage de la barre. Cette valeur provient soit de GraphsTheme, soit de BarSet::color si BarSet remplace la couleur. |
| couleur | barBorderColor | La couleur de la bordure de la barre. Cette valeur provient soit de GraphsTheme, soit de BarSet::borderColor si l'BarSet remplace la couleur. |
| réel | barBorderWidth | La largeur de la bordure de la barre. Cette valeur provient soit de GraphsTheme, soit de BarSet::borderWidth si l'BarSet remplace la largeur. |
| real | barValue | La valeur de la barre. Cette valeur provient de la propriété BarSet::values. |
| chaîne | barLabel | L'étiquette de la barre. Cette valeur provient de l'BarSet::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 BarSet::selectedBars. |
| int | barIndex | Index de la barre, compris entre 0 et le nombre total de barres moins 1. [depuis 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".
barSets : list<BarSet> [read-only]
Liste des coffrets ajoutés à la collection.
barWidth : real
L'unité de largeur correspond à celle de l'axe 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 x. Les barres dont la largeur est supérieure à zéro sont mises à l'échelle en fonction de l'échelle de l'axe 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 le type « BarSeries », cette valeur spécifie la largeur d'un groupe de barres plutôt que celle d'une seule barre.
barsType : enumeration
Type de la série de barres :
| Constante | Description |
|---|---|
BarSeries.BarsType.Groups | Les ensembles de barres sont regroupés par catégorie. Il s'agit de la valeur par défaut. |
BarSeries.BarsType.Stacked | Les ensembles de barres sont empilés les uns après les autres par catégorie. |
BarSeries.BarsType.StackedPercent | Les ensembles de barres sont empilés les uns 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. |
borderColors : list<color>
Liste des couleurs de contour à 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 ce paramètre n'est pas défini (valeur par défaut), les couleurs de l'GraphsTheme::borderColors seront utilisées.
count : int [read-only]
Le nombre de barres dans une série de barres.
labelsAngle : real
L'angle des étiquettes de valeur, exprimé en degrés.
labelsFormat : string
Format utilisé pour l'affichage des étiquettes dans une série de graphiques à barres.
Voir également QBarSeries::labelsFormat, labelsVisible et labelsPosition.
labelsMargin : real
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 ».
labelsPosition : enumeration
La position des étiquettes de valeurs :
| Constante | Description |
|---|---|
BarSeries.LabelsPosition.Center | L'étiquette est située au centre de la barre. |
BarSeries.LabelsPosition.InsideEnd | L'étiquette est située à l'intérieur de la barre, en haut. |
BarSeries.LabelsPosition.InsideBase | L'étiquette est située à l'intérieur de la barre, en bas. |
BarSeries.LabelsPosition.OutsideEnd | L'étiquette se trouve à l'extérieur de la barre, en haut. |
Voir également labelsVisible et labelsFormat.
labelsPrecision : real
Nombre maximal de chiffres significatifs affichés dans les étiquettes de valeur.
La valeur par défaut est 6.
labelsVisible : bool
Visibilité des étiquettes dans une série de graphiques à 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'un barDelegate.
Voir également « barDelegate ».
seriesColors : list<color>
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 ce paramètre n'est pas défini (valeur par défaut), les couleurs de l'GraphsTheme::seriesColors seront utilisées.
Documentation Signal
barsetsAdded()
Ce signal est émis lorsque des ensembles de barres sont ajoutés à la série.
Remarque : le gestionnaire correspondant est onBarsetsAdded.
barsetsRemoved()
Ce signal est émis lorsque des jeux de barres sont retirés de la série.
Remarque : le gestionnaire correspondant est onBarsetsRemoved.
clicked(int index, BarSet barset)
Ce signal est émis lorsque l'utilisateur clique ou appuie sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.
Remarque : le gestionnaire correspondant est onClicked.
doubleClicked(int index, BarSet barset)
Ce signal est émis lorsque l'utilisateur double-clique ou effectue un double tap sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset. Ce signal se produit toujours après clicked.
Remarque : le gestionnaire correspondant est onDoubleClicked.
pressed(int index, BarSet barset)
Ce signal est émis lorsque l'utilisateur clique ou appuie sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset et maintient le bouton de la souris ou le geste enfoncé.
Remarque : le gestionnaire correspondant est onPressed.
released(int index, BarSet barset)
Ce signal est émis lorsque l'utilisateur relâche un bouton de souris ou un geste précédemment activé sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.
Remarque : le gestionnaire correspondant est onReleased.
Documentation de la méthode
bool append(BarSet barset)
Ajoute un ensemble de barres spécifié par ` barset ` à 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.
Voir aussi insert().
BarSet at(int index)
Renvoie la barre définie à l'adresse index. Renvoie null si l'index n'est pas valide.
Barset at(int index)
Renvoie l'ensemble de barres spécifié par ` index ` issu de la série. Sinon, renvoie ` null `.
void clear()
Supprime tous les ensembles de barres de la série.
int find(BarSet barset)
Renvoie l'index de l'ensemble de barres spécifié par barset dans la série. Renvoie -1 s'il n'est pas trouvé.
BarSet insert(int index, BarSet barset)
Insère un ensemble de barres spécifié par barset dans une série à la position indiquée par index. Si l'ensemble est null ou appartient déjà à la série, il n'est pas ajouté. Renvoie true si l'insertion réussit.
Voir également append().
bool remove(BarSet barset)
Supprime de la série l'ensemble de barres spécifié par ` barset `. Renvoie ` true ` en cas de succès, ` false ` dans le cas contraire.
bool remove(int index)
Supprime de la série l'ensemble de barres spécifié par index. Renvoie true si la suppression a abouti, false dans le cas contraire.
void removeMultiple(int index, int count)
Supprime une série d'ensembles de barres, comme spécifié dans les pages index et count. L'appel parcourt tous les ensembles, même si la suppression de l'un d'entre eux échoue.
bool replace(list<BarSet> sets)
Remplace intégralement l'ensemble de barres actuel défini via sets. Il n'est pas nécessaire que les dimensions correspondent. Renvoie « false » si l'une des barres définies dans sets n'est pas valide.
bool replace(BarSet oldSet, BarSet newSet)
Remplace l'ensemble de barres spécifié par ` oldSet ` par `newSet`. Renvoie ` true ` si la suppression a réussi, ` false ` dans le cas contraire. ` oldSet ` est détruit si l'opération réussit.
bool replace(int index, BarSet barset)
Remplace la barre située à la position indiquée par ` index ` dans la série et la remplace par ` barset`. Renvoie ` true ` en cas de succès, ` false ` dans le cas contraire.
© 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.
