HBarModelMapper QML Type
Modèle horizontal pour les séries de barres. Plus d'informations...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QHBarModelMapper |
Propriétés
- columnCount : int
- firstBarSetRow : int
- firstColumn : int
- lastBarSetRow : int
- model : SomeModel
- series : AbstractBarSeries
Description détaillée
Le type HBarModelMapper 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 horizontal est utilisé pour créer une connexion entre un modèle de données et AbstractBarSeries, de sorte que chaque ligne du modèle de données définisse un ensemble de barres et que chaque colonne corresponde à une catégorie dans une série de barres. Vous devez mettre en œuvre le modèle de données et l'exposer à QML.
Les propriétés du modèle et des séries de barres peuvent ê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 veille à ce que tous les ensembles de barres de la série de barres aient 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 avec trois ensembles de barres (en supposant que le modèle comporte au moins quatre lignes). Chaque série de barres contient des données commençant à la colonne 1. Le nom d'un ensemble de barres est défini par l'en-tête de la ligne.
BarSeries { HBarModelMapper { model: myCustomModel // QAbstractItemModel derived implementation firstBarSetRow: 1 lastBarSetRow: 3 firstColumn: 1 } }
Voir également VBarModelMapper.
Documentation sur les propriétés
columnCount : int
Le nombre 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 (nombre limité au nombre de colonnes du modèle).
firstBarSetRow : int
Définit la ligne du modèle utilisée comme source de données pour le premier jeu de barres. La valeur par défaut est -1 (mappage non valide).
firstColumn : int
La colonne du modèle qui contient les premières valeurs des ensembles de barres dans la série de barres. La valeur par défaut est 0.
lastBarSetRow : int
La ligne du modèle utilisée comme source de données pour le dernier jeu de barres. La valeur par défaut est -1 (mappage non valide).
model : SomeModel
Le modèle de données utilisé par le mappeur. Vous devez mettre en œuvre le modèle et l'exposer à QML.
Remarque : le modèle doit permettre d'ajouter et de supprimer des lignes ou des colonnes et de modifier les données dans les cellules.
series : AbstractBarSeries
La série de barres utilisée par le cartographe. Toutes les données de la série sont supprimées lorsqu'elle est définie par le cartographe. Lorsque la nouvelle série est spécifiée, l'ancienne série est déconnectée (mais elle conserve ses données).
© 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.