BarSeries QML Type

Présente les données sous forme de graphiques à barres. Plus d'informations...

Import Statement: import QtGraphs
In C++: QBarSeries
Inherits:

AbstractSeries

Propriétés

Signaux

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

TypeType NomDescription
couleurbarColorLa couleur de remplissage de la barre. Cette valeur provient soit de GraphsTheme, soit de BarSet::color si BarSet remplace la couleur.
couleurbarBorderColorCouleur 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éelbarBorderWidthLargeur de la bordure de la barre. Cette valeur provient soit de GraphsTheme, soit de BarSet::borderWidth si BarSet remplace la largeur.
realbarValueLa valeur de la barre. Cette valeur provient de BarSet::values.
stringbarLabelL'étiquette de la barre. Cette valeur provient du site BarSet::label.
boolbarSelectedCette valeur est vraie lorsque la barre est sélectionnée, ce qui signifie que l'indice de la barre est dans BarSet::selectedBars.
intbarIndexIndex 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]

Une liste d'ensembles ajoutés à 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 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 :

ConstanteDescription de la série de barres
BarSeries.BarsType.GroupsLes séries de barres sont regroupées par catégorie. Il s'agit de la valeur par défaut.
BarSeries.BarsType.StackedLes séries de barres sont empilées les unes après les autres par catégorie.
BarSeries.BarsType.StackedPercentLes 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

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 :

ConstanteDescription
BarSeries.LabelsPosition.CenterL'étiquette est située au centre de la barre.
BarSeries.LabelsPosition.InsideEndL'étiquette est située à l'intérieur de la barre en haut.
BarSeries.LabelsPosition.InsideBaseL'étiquette est située à l'intérieur de la barre en bas.
BarSeries.LabelsPosition.OutsideEndL'é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.


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.


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.


clicked(int index, BarSet barset)

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.


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 le jeu 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 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.


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 le jeu de barres à index. Renvoie null si l'index n'est pas valide.


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.


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, string label, VariantList values)

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().


bool remove(BarSet barset)

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.


bool remove(int index)

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.


removeMultiple(int index, int count)

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.


bool replace(list<BarSet> sets)

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.


bool replace(BarSet oldSet, BarSet newSet)

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.


bool replace(int index, BarSet barset)

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.