Sur cette page

BarSet QML Type

Représente un ensemble de barres dans un diagramme à barres. Plus d'informations...

Import Statement: import QtCharts 2.11
In C++: QBarSet

Propriétés

Signaux

Méthodes

  • void append(real value)
  • real at(int index)
  • void remove(int index, int count)
  • void replace(int index, real value)

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 situer à la fin de l'ensemble. Pour les valeurs manquantes au milieu d'un ensemble, la valeur numérique de zéro est utilisée. Les étiquettes des ensembles de valeurs nulles ne sont pas affichées.

Voir également AbstractBarSeries, BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries, et HorizontalPercentBarSeries.

Documentation sur les propriétés

borderColor : color

La couleur de la ligne (stylo) du jeu de barres.

borderWidth : real

La largeur de la ligne de bordure. Par défaut, la largeur est de 2,0.

brushFilename : string

Le nom du fichier utilisé comme brosse pour l'ensemble.

color : color

La couleur de remplissage (brosse) du jeu de barres.

count : int

Le nombre de valeurs dans le jeu de barres.

label : string

L'étiquette du jeu de barres.

labelColor : color

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

labelFont : font

Police utilisée pour dessiner l'étiquette du jeu de barres.

Pour plus d'informations, voir font.

values : list<var>

Les valeurs du jeu de barres. Vous pouvez définir une liste de types real ou point comme valeurs.

Si vous définissez une liste de types réels comme valeurs, ils 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 indice de base zéro dans l'ensemble de barres. La taille du jeu de barres est égale à la valeur la plus élevée de la coordonnée x + 1. Si un point est manquant pour toute 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 égales :

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

Signal Documentation

clicked(int index)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans un ensemble de barres.

Le gestionnaire de signal correspondant est onClicked.

Note : Le gestionnaire correspondant est onClicked.

doubleClicked(int index)

Ce signal est émis lorsque l'utilisateur double-clique sur la barre spécifiée par index dans un ensemble de barres.

Le gestionnaire de signal correspondant est onDoubleClicked.

Note : Le gestionnaire correspondant est onDoubleClicked.

pressed(int index)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans un ensemble de barres et maintient le bouton de la souris enfoncé.

Le gestionnaire de signal correspondant est onPressed.

Note : Le gestionnaire correspondant est onPressed.

released(int index)

Ce signal est émis lorsque l'utilisateur relâche la pression de la souris sur la barre spécifiée par index dans un ensemble de barres.

Le gestionnaire de signal correspondant est onReleased.

Note : Le gestionnaire correspondant est onReleased.

valueChanged(int index)

Ce signal est émis lorsque la valeur à la position spécifiée par index est modifiée.

Le gestionnaire de signal correspondant est onValueChanged.

Note : Le gestionnaire correspondant est onValueChanged.

valuesAdded(int index, int count)

Ce signal est émis lorsque de nouvelles valeurs sont ajoutées au jeu de barres. index indique la position de la première valeur insérée et count le nombre de valeurs insérées.

Le gestionnaire de signal correspondant est onValuesAdded.

Note : Le gestionnaire correspondant est onValuesAdded.

valuesRemoved(int index, int count)

Ce signal est émis lorsque des valeurs sont retirées du jeu de barres. index indique la position de la première valeur retirée et count le nombre de valeurs retirées.

Le gestionnaire de signal correspondant est onValuesRemoved.

Remarque : le gestionnaire correspondant est onValuesRemoved.

Documentation de la méthode

void append(real value)

Ajoute la nouvelle valeur spécifiée par value à la fin du jeu de barres.

real at(int index)

Renvoie la valeur spécifiée par index à partir du jeu de barres. Si l'index est hors limites, 0.0 est renvoyé.

void remove(int index, int count)

Supprime le nombre de valeurs spécifiées par count du jeu de barres en commençant par la valeur spécifiée par index.

Si vous omettez 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 placée à la position spécifiée par index.

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