Sur cette page

HPieModelMapper QML Type

Cartographie horizontale des modèles pour les séries de tarte. Plus d'informations...

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

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 créer 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 tranche de tarte et que chaque ligne soit associée à l'étiquette ou à la valeur de la tranche de tarte.

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

L'exemple QML suivant crée une série de camemberts avec quatre parts (en supposant que le modèle comporte au moins cinq colonnes). Chaque tranche reçoit une étiquette de la ligne 1 et une valeur de la ligne 2.

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

Documentation sur les propriétés

columnCount : int

Le nombre de colonnes du modèle qui sont mappées en tant que données pour la série de camemberts. La valeur par défaut est -1 (nombre limité par le nombre de colonnes du modèle).

firstColumn : int

La colonne du modèle qui contient la première valeur de la tranche. La valeur par défaut est 0.

labelsRow : int

La ligne du modèle qui est synchronisée avec les étiquettes des parts de tarte. La valeur par défaut est -1 (correspondance non valide).

model : SomeModel

Le modèle basé sur QAbstractItemModel qui est 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.

series : PieSeries

L'objet PieSeries utilisé par le mappeur. Si vous définissez l'élément mapper en tant qu'élément enfant d'un PieSeries, laissez cette propriété indéfinie. Toutes les données de la série sont supprimées lorsqu'elle est définie pour le mappeur. Lorsqu'une nouvelle série est spécifiée, l'ancienne série est déconnectée (mais elle conserve ses données).

valuesRow : int

La ligne du modèle qui est synchronisée avec les valeurs des parts du gâteau. La valeur par défaut est -1 (correspondance 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.