Sur cette page

HBarModelMapper QML Type

Mappeur de modèle horizontal pour les séries de barres. En savoir plus...

Import Statement: import QtCharts 2.12
In C++: QHBarModelMapper
Status: Deprecated

Ce type est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

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 établir 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 d'une série de barres. 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 de barres.

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 lignes). Chaque ensemble de barres contient des données à partir de la colonne 1. Le nom d'un ensemble de barres est défini par l'en-tête de 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

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 quelle ligne du modèle est utilisée comme source de données pour le premier ensemble de barres. La valeur par défaut est -1 (mappage non valide).

firstColumn : int

Colonne du modèle contenant les premières valeurs des ensembles de barres dans la série de barres. La valeur par défaut est 0.

lastBarSetRow : int

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

model : SomeModel

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.

series : AbstractBarSeries

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

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