VPieModelMapper QML Type
Vertikaler Modell-Mapper für Kreisdiagramm-Reihen. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QVPieModelMapper |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- firstRow : int
- labelsColumn : int
- model : SomeModel
- rowCount : int
- series : PieSeries
- valuesColumn : int
Ausführliche Beschreibung
Modell-Mapper ermöglichen die Verwendung eines aus der Klasse „ QAbstractItemModel “ abgeleiteten Datenmodells als Datenquelle für ein Diagramm. Ein vertikaler Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ PieSeries “ herzustellen, sodass jede Zeile im Datenmodell ein Tortenstück definiert und jede Spalte der Beschriftung oder dem Wert des Tortenstücks zugeordnet wird.
Zur Bearbeitung der Daten können sowohl die Eigenschaften der Modell- als auch der Kreisdiagrammreihe verwendet werden. Der Modell-Mapper sorgt dafür, dass die Kreisdiagrammreihe und das Datenmodell synchron bleiben.
Das folgende QML-Beispiel erstellt eine Kreisdiagrammreihe mit vier Segmenten (vorausgesetzt, das Modell verfügt über mindestens fünf Zeilen). Jedes Segment erhält eine Beschriftung aus Spalte 1 und einen Wert aus Spalte 2.
VPieModelMapper {
series: pieSeries
model: customModel
labelsColumn: 1
valuesColumn: 2
firstRow: 1
rowCount: 4
}Dokumentation zu den Eigenschaften
firstRow : int
Die Zeile des Modells, die den ersten Slice-Wert enthält. Der Standardwert ist 0.
labelsColumn : int
Die Spalte des Modells, die mit den Beschriftungen der Tortenstücke synchronisiert wird. Der Standardwert ist -1 (ungültige Zuordnung).
model : SomeModel
Das vom Mapper verwendete, auf „ QAbstractItemModel “ basierende Modell. Sie müssen das Modell implementieren und es für QML verfügbar machen.
Hinweis: Das Modell muss das Hinzufügen und Entfernen von Zeilen oder Spalten sowie das Ändern der Daten in den Zellen unterstützen.
rowCount : int
Die Anzahl der Zeilen des Modells, die als Daten für eine Kreisdiagrammreihe zugeordnet werden. Der Standardwert ist -1 (die Anzahl ist durch die Anzahl der Zeilen im Modell begrenzt).
series : PieSeries
Die vom Mapper verwendete Kreisdiagramm-Serie. Wenn Sie das Mapper-Element als untergeordnetes Element einer PieSeries definieren, lassen Sie diese Eigenschaft undefiniert. Alle Daten der Serie werden verworfen, wenn diese dem Mapper zugewiesen wird. Wenn eine neue Serie angegeben wird, wird die alte Serie getrennt (ihre Daten bleiben jedoch erhalten).
valuesColumn : int
Die Spalte des Modells, die mit den Werten der Tortenstücke synchronisiert wird. Der Standardwert ist -1 (ungültige Zuordnung).
© 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.