Sur cette page

HPieModelMapper QML Type

Mappeur de modèle horizontal pour les séries de diagrammes circulaires. En savoir plus…

Import Statement: import QtCharts 2.12
In C++: QHPieModelMapper
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

Les mappeurs de modèles permettent 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 ` PieSeries`, de sorte que chaque colonne du modèle de données définisse une part de camembert et que chaque ligne corresponde à l'étiquette ou à la valeur de cette part.

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

L'exemple QML suivant crée une série de diagramme circulaire comportant quatre parts (en supposant que le modèle comporte au moins cinq colonnes). Chaque part reçoit un libellé provenant de la ligne 1 et une valeur provenant de la ligne 2.

HPieModelMapper {
    series: pieSeries
    model: customModel
    labelsRow: 1
    valuesRow: 2
    firstColumn: 1
    columnCount: 4
}

Documentation des 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 diagrammes circulaires. La valeur par défaut est -1 (nombre limité par le nombre de colonnes du modèle).

firstColumn : int

Colonne du modèle contenant la première valeur de tranche. La valeur par défaut est 0.

labelsRow : int

Ligne du modèle qui est synchronisée avec les libellés des parts du graphique circulaire. La valeur par défaut est -1 (mappage non valide).

model : SomeModel

Modèle basé sur « QAbstractItemModel » 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 : PieSeries

Objet `PieSeries` utilisé par le mappeur. Si vous définissez l'élément « mapper » comme enfant d'un `PieSeries`, ne définissez pas cette propriété. 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 conserve ses données).

valuesRow : int

Ligne du modèle qui est synchronisée avec les valeurs des parts du graphique circulaire. La valeur par défaut est -1 (mappage non valide).

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