BarModelMapper QML Type
Mappeur de modèles pour les séries de barres. En savoir plus...
| Import Statement: | import QtGraphs |
| In C++: | QBarModelMapper |
- Liste de tous les membres, y compris les membres hérités
- BarModelMapper fait partie des types QML 2D d'Qt Graphs .
Propriétés
- count : qsizetype
- first : qsizetype
- firstBarSetSection : qsizetype
- lastBarSetSection : qsizetype
- model : model
- orientation : orientation
- series : BarSeries
Signaux
- countChanged()
- firstBarSetSectionChanged()
- firstChanged()
- lastBarSetSectionChanged()
- modelChanged()
- orientationChanged()
- orientationChanged()
- seriesChanged()
Description détaillée
Le type BarModelMapper permet d'utiliser un modèle de données dérivé de la classe QAbstractItemModel comme source de données pour un graphique. Un mappeur de modèle sert à établir une connexion entre un modèle de données et QBarSeries. Vous devez implémenter le modèle de données et l'exposer à QML.
Les propriétés du modèle et de la série de barres peuvent toutes deux être utilisées pour manipuler les données. Le mappeur de modèle assure la synchronisation entre la série de barres et le modèle de données.
Le mappeur de modèle garantit que tous les ensembles de barres de la série de barres ont la même taille. Par conséquent, l’ajout ou la suppression d’une valeur dans un ensemble de barres entraîne la même modification dans tous les ensembles de barres de la série.
L'extrait de code QML suivant crée une série de barres comportant trois ensembles de barres (en supposant que le modèle comporte au moins quatre colonnes). Chaque ensemble de barres contient des données à partir de la ligne 1. Le nom d'un ensemble de barres est défini par l'en-tête de colonne.
BarSeries {
BarModelMapper {
model: myCustomModel // QAbstractItemModel derived implementation
firstBarSetColumn: 1
lastBarSetColumn: 3
firstRow: 1
orientation: Qt.Vertical
}
}Documentation des propriétés
count : qsizetype
Nombre de lignes ou de colonnes du modèle qui sont mappées en tant que données pour la série de barres. La valeur par défaut est « -1 », qui correspond également à la valeur minimale. Ce nombre est limité par le nombre de lignes/colonnes du modèle.
Voir également orientation.
first : qsizetype
Ligne ou colonne du modèle contenant les premières valeurs des ensembles de barres de la série de barres. La valeur par défaut est 0.
Voir également orientation.
firstBarSetSection : qsizetype
Partie du modèle utilisée comme source de données pour la première série de barres. La valeur par défaut est -1 (mappage non valide).
Voir également orientation.
lastBarSetSection : qsizetype
Partie du modèle utilisée comme source de données pour la dernière série de barres. La valeur par défaut est -1 (mappage non valide).
Voir également orientation.
model : model
Le modèle de données utilisé par le mappeur. Vous devez implémenter ce modèle et le rendre accessible à QML.
Remarque : le modèle doit prendre en charge l'ajout et la suppression de lignes ou de colonnes, ainsi que la modification des données dans les cellules.
orientation : orientation
Indique au ModelMapper comment mapper les données d'un modèle. Si l'option « Qt.Vertical » est utilisée, chaque colonne du modèle définit un ensemble de barres, et chaque ligne du modèle définit une catégorie. Lorsque l'orientation est définie sur « Qt.Horizontal », chaque ligne du modèle définit un ensemble de barres, et chaque colonne du modèle définit une catégorie.
series : BarSeries
La série de barres utilisée par le mappeur. Toutes les données de la série sont supprimées lorsqu'elle est associée au mappeur. Lorsqu'une nouvelle série est spécifiée, l'ancienne série est déconnectée, mais ses données sont conservées.
Documentation Signal
countChanged()
Ce signal est émis lorsque le nombre de lignes ou de colonnes change.
Remarque : le gestionnaire correspondant est onCountChanged.
firstBarSetSectionChanged()
Ce signal est émis lorsque la première section de mesures change.
Remarque : le gestionnaire correspondant est onFirstBarSetSectionChanged.
firstChanged()
Ce signal est émis lorsque la première ligne ou la première colonne change.
Remarque : le gestionnaire correspondant est onFirstChanged.
lastBarSetSectionChanged()
Ce signal est émis lorsque la dernière section de mesures change.
Remarque : le gestionnaire correspondant est onLastBarSetSectionChanged.
modelChanged()
Ce signal est émis lorsque le modèle auquel le mappeur est connecté change.
Remarque : le gestionnaire correspondant est onModelChanged.
orientationChanged()
Ce signal est émis lorsque l'orientation change.
Remarque : le gestionnaire correspondant est onOrientationChanged.
orientationChanged()
Ce signal est émis lorsque l'orientation change.
Remarque : le gestionnaire correspondant est onOrientationChanged.
seriesChanged()
Ce signal est émis lorsque la série de barres à laquelle le mappeur est connecté change.
Remarque : le gestionnaire correspondant est onSeriesChanged.
© 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.