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)
- clear()
- int find(BarSet barset)
- BarSet insert(int index, string label, VariantList values)
- bool remove(BarSet barset)
- bool remove(int index)
- 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 des 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 | 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".
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 X. Les barres plus larges que zéro sont mises à l'échelle. 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 |
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. |
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 |
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 |
Le format utilisé pour afficher les étiquettes dans une série de 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 valeur de labelsPosition est différente de celle de LabelsPosition.Center. La valeur par défaut est 0.
labelsPosition : enumeration |
La position des étiquettes de valeur des 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 |
Nombre maximum 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 barres. La visibilité des étiquettes par défaut est false.
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.
Signal Documentation
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.
Ce signal est émis lorsque l'utilisateur clique ou tape sur la barre spécifiée par index dans la série de barres spécifiée par barset.
Remarque : Le gestionnaire correspondant est onClicked.
Ce signal est émis lorsque l'utilisateur double-clique ou double-tape sur la barre spécifiée par index dans le jeu de barres spécifié par barset. Ce signal est toujours émis après clicked.
Remarque : le gestionnaire correspondant est onDoubleClicked.
Ce signal est émis lorsque l'utilisateur clique ou tape sur la barre spécifiée par index dans le jeu de barres spécifié par barset et qu'il maintient le bouton de la souris enfoncé ou qu'il fait un geste.
Note : Le gestionnaire correspondant est onPressed.
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
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 le jeu de barres spécifié par index à partir de la série. Retourne null dans le cas contraire.
clear() |
Supprime tous les ensembles de barres de la série.
Renvoie l'index de l'ensemble de barres spécifié par barset dans la série. Renvoie -1 s'il n'est pas trouvé.
Ajoute un nouvel ensemble de barres avec label et values à index. values peut être une liste de valeurs réelles ou une liste de types XYPoint.
Si la valeur de l'index est inférieure ou égale à zéro, le nouveau jeu de barres est ajouté à la série de barres. Si la valeur de l'index est égale ou supérieure au nombre de séries de barres dans la série de barres, la nouvelle série de barres est ajoutée à la série de barres.
Voir également append().
Supprime la série de barres spécifiée par barset de la série. Renvoie true en cas de succès, false dans le cas contraire.
Supprime la série de barres spécifiée par index de la série. Renvoie true si la suppression est réussie, false sinon.
Supprime une série d'ensembles de barres comme spécifié par index et count. L'appel passe par tous les ensembles même si la suppression de l'un d'entre eux échoue.
Remplace complètement tous les jeux de barres actuels par sets. La taille n'a pas besoin de correspondre. Renvoie un message faux si l'un des jeux de barres de sets n'est pas valide.
Remplace l'ensemble de barres spécifié par oldSet par newSet. Renvoie true si la suppression est réussie, false sinon. oldSet est détruit en cas de succès.
Remplace le jeu de barres à la position spécifiée par index de la série et le remplace par barset. Renvoie true en cas de succès, false dans le cas contraire.
© 2025 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.