Sur cette page

VBoxPlotModelMapper QML Type

Cartographie du modèle vertical pour les séries de diagrammes en boîte. Plus d'informations...

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

Propriétés

Description détaillée

Le type VBoxPlotModelMapper 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 un type BoxPlotSeries, de sorte que chaque colonne du modèle de données définisse un élément de boîte et de moustaches et que chaque ligne corresponde à l'intervalle et aux trois valeurs médianes de l'élément de boîte et de moustaches.

Les propriétés du modèle et de la série peuvent être utilisées pour manipuler les données. Le mappeur de modèle assure la synchronisation entre la série et le modèle de données.

Le mappeur de modèle veille à ce que tous les éléments de la boîte et des moustaches de la série du diagramme en boîte aient la même taille. Par conséquent, l'ajout ou la suppression d'une valeur dans un élément de la boîte et des moustaches entraîne la même modification dans tous les éléments de la boîte et des moustaches de la série de diagrammes en boîte.

L'extrait de code QML suivant crée une série de box plots avec trois éléments box-and-whiskers (en supposant que le modèle comporte au moins quatre colonnes). Chaque élément de box-and-whiskers contient des données à partir de la ligne 1. Le nom d'un élément est défini par l'en-tête de la colonne.

BoxPlotSeries {
    VBoxPlotModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBoxSetColumn: 1
        lastBoxSetColumn: 3
        firstRow: 1
    }
}

Voir également HBoxPlotModelMapper.

Documentation sur les propriétés

firstBoxSetColumn : int

Colonne du modèle utilisée comme source de données pour le premier élément de la boîte à moustaches. La valeur par défaut est -1 (mappage non valide).

firstRow : int

La ligne du modèle qui contient les premières valeurs des éléments de la boîte et des moustaches dans la série de diagrammes en boîte.

La valeur par défaut est 0.

lastBoxSetColumn : int

Colonne du modèle utilisée comme source de données pour le dernier élément de la boîte à moustaches. 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 diagrammes en boîte.

La valeur par défaut est -1 (nombre limité au nombre de colonnes du modèle).

series : AbstractBarSeries

La série de diagrammes en boîte utilisée par le cartographe.

Toutes les données de la série sont supprimées lorsqu'elle est définie pour le cartographe. Lorsqu'une 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.