Sur cette page

VPieModelMapper QML Type

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

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

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 vertical est utilisé pour créer une connexion entre un modèle de données et PieSeries, de sorte que chaque ligne du modèle de données définisse une tranche de tarte et que chaque colonne corresponde à 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 maintient 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 lignes). Chaque tranche reçoit une étiquette de la colonne 1 et une valeur de la colonne 2.

VPieModelMapper {
    series: pieSeries
    model: customModel
    labelsColumn: 1
    valuesColumn: 2
    firstRow: 1
    rowCount: 4
}

Documentation sur les propriétés

firstRow : int

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

labelsColumn : int

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

rowCount : int

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

series : PieSeries

La série de camemberts utilisée 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 dans l'élément mapper. Lorsqu'une nouvelle série est spécifiée, l'ancienne série est déconnectée (mais elle conserve ses données).

valuesColumn : int

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