BarSeries QML Type
Présente les données sous forme de graphiques à barres. Plus d'informations...
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- Liste de tous les membres, y compris les membres hérités
- BarSeries fait partie de Qt Graphs QML Types for 2D.
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
Dessine les données par défaut sous la forme d'une série de barres groupées par catégorie, avec une barre par catégorie de chaque ensemble de barres ajouté à la série. Elle prend également en charge les barres horizontales et le regroupement des barres sous forme d'empilement.
Documentation sur les propriétés
barDelegate : Component
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 |
|---|---|---|
| couleur | barColor | La 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 du site GraphsTheme, soit du site BarSet::borderColor si le site BarSet remplace la couleur. |
| réel | barBorderWidth | Largeur de la bordure de la barre. Cette valeur provient soit de GraphsTheme, soit de BarSet::borderWidth si BarSet remplace la largeur. |
| real | barValue | La valeur de la barre. Cette valeur provient de BarSet::values. |
| string | barLabel | L'étiquette de la barre. Cette valeur provient du site BarSet::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 BarSet::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".
barSets : list<BarSet> [read-only]
Liste des séries ajoutées à la série.
barWidth : real
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. En fixant la largeur à zéro, la largeur de la barre à l'écran est d'un pixel, quelle que soit l'échelle de l'axe des x. Les barres plus larges que zéro sont mises à l'échelle selon l'échelle de l'axe des x. 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 valides sont comprises entre 0,0 (0 %) et 1,0 (100 %).
Remarque : lorsqu'elle est utilisée avec le type BarSeries, cette valeur spécifie la largeur d'un groupe de barres au lieu de celle d'une seule barre.
barsType : enumeration
Le type de la série de barres :
| Constante | Description de la série de barres |
|---|---|
BarSeries.BarsType.Groups | Les séries de barres sont regroupées par catégorie. Il s'agit de la valeur par défaut. |
BarSeries.BarsType.Stacked | Les séries de barres sont empilées les unes après les autres par catégorie. |
BarSeries.BarsType.StackedPercent | Les jeux de barres sont empilés les uns à 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. |
borderColors : list<color>
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 ce paramètre n'est pas défini (par défaut), les couleurs du site GraphsTheme::borderColors seront utilisées.
count : int [read-only]
Le nombre de jeux de barres dans une série de barres.
labelsAngle : real
L'angle des étiquettes de valeur en degrés.
labelsFormat : string
Format utilisé pour afficher les étiquettes dans une série de barres.
Voir aussi QBarSeries::labelsFormat, labelsVisible, et labelsPosition.
labelsMargin : real
La marge des étiquettes de valeur en pixels.
Cette marge latérale est utilisée lorsque labelsPosition a une valeur autre que LabelsPosition.Center. La valeur par défaut est 0.
labelsPosition : enumeration
La position des étiquettes des valeurs de données :
| 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 est située à l'extérieur de la barre en haut. |
Voir également labelsVisible et labelsFormat.
labelsPrecision : real
Le nombre maximum de chiffres significatifs affichés dans les étiquettes de valeur.
La valeur par défaut est 6.
labelsVisible : bool
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 de barDelegate.
Voir également barDelegate.
seriesColors : list<color>
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 ce paramètre n'est pas défini (par défaut), les couleurs de GraphsTheme::seriesColors seront utilisées.
Documentation sur les signaux
barsetsAdded()
Ce signal est émis lorsque des jeux 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 supprimé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 tape 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 double-tape sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset. Ce signal est toujours émis après clicked.
Remarque : le gestionnaire correspondant est onDoubleClicked.
pressed(int index, BarSet barset)
Ce signal est émis lorsque l'utilisateur clique ou tape sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset et qu'il maintient le bouton ou le geste de la souris enfoncé.
Remarque : le gestionnaire correspondant est onPressed.
released(int index, BarSet barset)
Ce signal est émis lorsque l'utilisateur relâche un bouton de la souris ou un geste précédemment appuyé 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 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.
Voir aussi insert().
BarSet at(int index)
Renvoie la barre fixée à index. Retourne null si l'index n'est pas valide.
Barset at(int index)
Renvoie le jeu de barres spécifié par index dans la série. Sinon, il renvoie null.
void clear()
Supprime tous les jeux de barres de la série.
int find(BarSet barset)
Renvoie l'indice 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 jeu de barres spécifié par barset dans une série à la position spécifiée par index. Si l'ensemble est null ou appartient déjà à la série, l'ensemble n'est pas ajouté. Renvoie true si l'insertion réussit.
Voir aussi append().
bool remove(BarSet barset)
Supprime de la série le jeu 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 le jeu de barres spécifié par index. Renvoie true si la suppression a été effectuée avec succès, false dans le cas contraire.
void removeMultiple(int index, int count)
Supprime une série d'ensembles de barres comme spécifié par les paramètres index et count. L'appel passe par tous les ensembles même si la suppression d'un ensemble échoue.
bool replace(list<BarSet> sets)
Remplace complètement tous les jeux de barres actuels avec sets. La taille n'a pas besoin de correspondre. Renvoie un message faux si l'une des barres de sets n'est pas valide.
bool replace(BarSet oldSet, BarSet newSet)
Remplace le jeu de barres spécifié par oldSet par newSet. Retourne true si la suppression a réussi, false sinon. oldSet est détruit en cas de succès.
bool replace(int index, BarSet barset)
Remplace la barre placée à la position spécifiée par index de 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.
