Sur cette page

HBoxPlotModelMapper QML Type

Mappeur de modèle horizontal pour les séries de diagrammes en boîte. En savoir plus…

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

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

Propriétés

Description détaillée

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

Les propriétés du modèle et de la série peuvent toutes deux ê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 garantit que tous les éléments de type « boîte à moustaches » de la série de diagrammes en boîte ont la même taille. Par conséquent, l’ajout ou la suppression d’une valeur dans un élément de type « boîte à moustaches » entraîne la même modification dans tous les éléments de type « boîte à moustaches » de la série de diagrammes en boîte.

L'extrait de code QML suivant crée une série de diagrammes en boîte comportant trois éléments de type « boîte et moustaches » (en supposant que le modèle comporte au moins quatre lignes). Chaque élément de type « boîte et moustaches » contient des données à partir de la colonne 1. Le nom d'un élément est défini par l'en-tête de ligne.

BoxPlotSeries {
    HBoxPlotModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBoxSetRow: 1
        lastBoxSetRow: 3
        firstColumn: 1
    }
}

Voir également VBoxPlotModelMapper.

Documentation des propriétés

columnCount : int

Nombre de colonnes du modèle qui sont associées aux données de la série du diagramme en boîte. La valeur minimale et par défaut est -1 (ce nombre est limité au nombre de colonnes du modèle).

firstBoxSetRow : int

La ligne du modèle sert de source de données pour le premier élément de type « boîte à moustaches ». La valeur par défaut est -1 (mappage non valide).

firstColumn : int

Colonne du modèle contenant les premières valeurs des éléments « boîte et moustaches » de la série de diagrammes en boîte. La valeur par défaut est 0.

lastBoxSetRow : int

La ligne du modèle sert de source de données pour le dernier élément de type « 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 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 contenues dans les cellules.

series : AbstractBarSeries

La série de diagrammes en boîte utilisée par le mappeur. Toutes les données de la série sont supprimées lorsqu'elle est définie dans le 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.