Sur cette page

BarSet QML Type

Représente une série de barres dans un histogramme. En savoir plus...

Import Statement: import QtGraphs
In C++: QBarSet

Propriétés

Signaux

Méthodes

Description détaillée

Un ensemble de barres contient une valeur de données pour chaque catégorie. La première valeur d'un ensemble est supposée appartenir à la première catégorie, la deuxième à la deuxième catégorie, et ainsi de suite. Si l'ensemble comporte moins de valeurs qu'il n'y a de catégories, les valeurs manquantes sont supposées se trouver à la fin de l'ensemble. Pour les valeurs manquantes au milieu d’un ensemble, la valeur numérique zéro est utilisée. Les libellés des ensembles dont la valeur est zéro ne sont pas affichés.

Voir également BarSeries.

Documentation sur les propriétés

borderColor : color

Couleur de la bordure de l'ensemble de barres.

borderWidth : real

Par défaut, la largeur est de -1, ce qui signifie que la largeur de la bordure est définie par le thème.

color : color

La couleur de remplissage de l'ensemble de barres.

count : int [read-only]

Le nombre de valeurs dans l'ensemble de barres.

label : string

L'étiquette de l'ensemble de bar.

labelColor : color

Couleur du texte (libellé) de l'ensemble de barres.

selectedBars : list [read-only]

Les indices des barres actuellement sélectionnées.

selectedColor : color

La couleur de remplissage de l'ensemble sélectionné.

values : list<variant>

Les valeurs de l'ensemble de barres. Vous pouvez définir une liste de valeurs de type « real » ou « point ».

Si vous définissez une liste de types réels comme valeurs, celles-ci définissent directement les valeurs de l'ensemble de barres.

Si vous définissez une liste de types de points comme valeurs, la coordonnée x du point spécifie son index (à partir de zéro) dans l'ensemble de barres. La taille de l'ensemble de barres correspond à la valeur la plus élevée de la coordonnée x + 1. Si un point manque pour une coordonnée x comprise entre zéro et la valeur la plus élevée, il prend la valeur zéro.

Par exemple, les ensembles de barres suivants ont des valeurs identiques :

myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];

Documentation sur les signaux

borderColorChanged(color)

Ce signal est émis lorsque la couleur de la bordure de l'ensemble de barres passe à color.

Remarque : le gestionnaire correspondant est onBorderColorChanged.

borderWidthChanged(real width)

Ce signal est émis lorsque la largeur de la bordure du bar set change. La nouvelle largeur est width.

Remarque : le gestionnaire correspondant est onBorderWidthChanged.

colorChanged(color)

Ce signal est émis lorsque la couleur de remplissage de l'ensemble de barres passe à color.

Remarque : le gestionnaire correspondant est onColorChanged.

countChanged()

Ce signal est émis lorsque le nombre de valeurs du ensemble de barres change.

Remarque : le gestionnaire correspondant est onCountChanged.

labelChanged()

Ce signal est émis lorsque le libellé de l'ensemble de barres change.

Remarque : le gestionnaire correspondant est onLabelChanged.

Voir également label.

labelColorChanged(color)

Ce signal est émis lorsque la couleur du texte (étiquette) de l'ensemble de barres passe à color.

Remarque : le gestionnaire correspondant est onLabelColorChanged.

selectedBarsChanged(list<int> indexes)

Ce signal est émis lorsque la barre sélectionnée change. ` indexes ` est une liste contenant les index des barres sélectionnées.

Remarque : le gestionnaire correspondant est onSelectedBarsChanged.

selectedColorChanged(color color)

Ce signal est émis lorsque la couleur de la barre sélectionnée change. La nouvelle couleur est color.

Remarque : le gestionnaire correspondant est onSelectedColorChanged.

update()

Ce signal est émis lorsque l'ensemble de barres est mis à jour.

Remarque : le gestionnaire correspondant est onUpdate.

updatedBars()

Ce signal est émis lorsque les barres de cet ensemble sont mises à jour.

Remarque : le gestionnaire correspondant est onUpdatedBars.

valueAdded(int index, int count)

Ce signal est émis lorsque de nouvelles valeurs sont ajoutées à l'ensemble de barres. index indique la position de la première valeur insérée, et count correspond au nombre de valeurs insérées.

Remarque : le gestionnaire correspondant est onValueAdded.

valueChanged(int index)

Ce signal est émis lorsque la valeur située à la position indiquée par index est modifiée.

Remarque : le gestionnaire correspondant est onValueChanged.

valueRemoved(int index, int count)

Ce signal est émis lorsque des valeurs sont supprimées de l'ensemble de barres. ` index ` indique la position de la première valeur supprimée, et ` count ` correspond au nombre de valeurs supprimées.

Remarque : le gestionnaire correspondant est onValueRemoved.

valuesAdded(int index, int count)

Ce signal est émis lorsque de nouvelles valeurs sont ajoutées à l'ensemble de barres. ` index ` indique la position de la première valeur insérée, et ` count ` correspond au nombre de valeurs insérées.

Remarque : le gestionnaire correspondant est onValuesAdded.

valuesChanged()

Ce signal est émis lorsque les valeurs de l'ensemble de barres changent.

Remarque : le gestionnaire correspondant est onValuesChanged.

valuesRemoved(int index, int count)

Ce signal est émis lorsque des valeurs sont supprimées de l'ensemble de barres. ` index ` indique la position de la première valeur supprimée, et ` count ` correspond au nombre de valeurs supprimées.

Remarque : le gestionnaire correspondant est onValuesRemoved.

Documentation de la méthode

void append(list<real> values)

Ajoute la liste des valeurs réelles spécifiées par ` values ` à la fin de l'ensemble de barres.

Voir aussi append ().

void append(real value)

Ajoute la nouvelle valeur indiquée par « value » à la fin de la série de barres.

real at(int index)

Renvoie la valeur spécifiée par ` index ` dans l'ensemble de barres. Si l'index est hors limites, la valeur 0,0 est renvoyée.

void clear()

Supprime toutes les valeurs de l'ensemble.

int count()

Renvoie le nombre de valeurs contenues dans un ensemble de barres.

void deselectAllBars()

Désélectionne toutes les barres de l'ensemble.

Remarque : émet l'événement « BarSet::selectedBarsChanged ».

Voir aussi setBarSelected().

void deselectBar(int index)

Désélectionne la barre à l'adresse index.

Remarque : émet BarSet::selectedBarsChanged.

Voir également setBarSelected().

void deselectBars(list<int> indexes)

Marque comme désélectionnées plusieurs barres transmises dans une liste « indexes ».

Remarque : Émet la méthode ` BarSet::selectedBarsChanged`.

Voir aussi setBarSelected().

void insert(int index, real value)

Insère « value » à la position indiquée par « index ». Les valeurs suivant la valeur insérée sont décalées d'une position vers le haut.

Voir également remove().

bool isBarSelected(int index)

Renvoie ` true ` si la barre située à l'index e indiquée fait partie des barres sélectionnées, et ` false ` dans le cas contraire.

Remarque : les barressélectionnées sont dessinées dans la couleur sélectionnée si celle-ci a été spécifiée à l’aide de BarSet::setSelectedColor.

Voir également selectedBars, setBarSelected() et selectedColor.

void remove(int index, int count)

Supprime le nombre de valeurs spécifié par count de l'ensemble de barres commençant par la valeur spécifiée par index.

Si vous n'indiquez pas count, seule la valeur spécifiée par index est supprimée.

void replace(int index, real value)

Ajoute la valeur spécifiée par ` value ` à la barre située à la position indiquée par ` index`.

void selectAllBars()

Marque toutes les barres de l'ensemble comme sélectionnées.

Remarque : émet la méthode « BarSet::selectedBarsChanged ».

Voir aussi setBarSelected().

void selectBar(int index)

Marque la barre située à l'adresse index comme sélectionnée.

Remarque : renvoie BarSet::selectedBarsChanged.

Voir également setBarSelected().

void selectBars(list<int> indexes)

Marque comme sélectionnées plusieurs barres transmises dans une liste « indexes ».

Remarque : Émet la méthode ` BarSet::selectedBarsChanged`.

Voir aussi setBarSelected().

void setBarSelected(int index, bool selected)

Marque la barre située à l'adresse index comme étant sélectionnée ou désélectionnée, selon les indications fournies par selected.

Remarque : les barressélectionnées sont dessinées dans la couleur sélectionnée si celle-ci a été spécifiée. Émet BarSet::selectedBarsChanged.

Voir également isBarSelected() et selectedColor.

real sum()

Renvoie la somme de toutes les valeurs de l'ensemble de barres.

void toggleSelection(list<int> indexes)

Modifie l'état de sélection des barres à l'adresse indiquée indexes pour lui attribuer l'état opposé.

Remarque : Émet l'BarSet::selectedBarsChanged.

Voir aussi setBarSelected().

© 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.