Sur cette page

VBarModelMapper QML Type

Modèle vertical pour les séries de barres. Plus d'informations...

Import Statement: import QtCharts 2.11
In C++: QVBarModelMapper
Inherits:

BarModelMapper

Propriétés

Description détaillée

Le type VBarModelMapper 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 vertical est utilisé pour créer une connexion entre un modèle de données et QAbstractBarSeries, de sorte que chaque colonne du modèle de données définisse un ensemble de barres et que chaque ligne 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 colonnes). Chaque série de barres contient des données commençant à la ligne 1. Le nom d'une série de barres est défini par l'en-tête de la colonne.

BarSeries {
    VBarModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBarSetColumn: 1
        lastBarSetColumn: 3
        firstRow: 1
    }
}

Voir également HBarModelMapper.

Documentation sur les propriétés

firstBarSetColumn : int

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

firstRow : int

La ligne 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.

lastBarSetColumn : int

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

rowCount : int

Le nombre de lignes 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 lignes du modèle).

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.