PieModelMapper QML Type
Modell-Mapper für Kreisdiagramm-Reihen. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QPieModelMapper |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- PieModelMapper ist Teil von „Qt Graphs “ – QML-Typen für 2D.
Eigenschaften
- count : qsizetype
- first : qsizetype
- labelsSection : qsizetype
- model : model
- orientation : orientation
- series : PieSeries
- valuesSection : qsizetype
Signale
- countChanged()
- firstChanged()
- labelsSectionChanged()
- modelChanged()
- orientationChanged()
- seriesChanged()
- valuesSectionChanged()
Ausführliche Beschreibung
Modell-Mapper ermöglichen die Verwendung eines aus der Klasse „ QAbstractItemModel “ abgeleiteten Datenmodells als Datenquelle für ein Diagramm. Ein Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ PieSeries “ herzustellen.
Zur Bearbeitung der Daten können sowohl die Eigenschaften des Modells als auch die 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 enthält mindestens fünf Zeilen). Jedes Segment erhält eine Beschriftung aus Spalte 1 und einen Wert aus Spalte 2.
PieModelMapper {
series: pieSeries
model: customModel
labelsSection: 1
valuesSection: 2
first: 1
count: 4
orientation: Qt.Vertical
}Dokumentation zu den Eigenschaften
count : qsizetype
Die Anzahl der Spalten oder 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).
Siehe auch „ orientation “.
first : qsizetype
Die Spalte oder Zeile des Modells, die den ersten Slice-Wert enthält. Der Standardwert ist 0.
Siehe auch „ orientation “.
labelsSection : qsizetype
Die Spalte oder Zeile des Modells, die mit den Beschriftungen der Tortenstücke synchronisiert wird. Der Standardwert ist -1 (ungültige Zuordnung).
Siehe auch „ orientation “.
model : model
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.
orientation : orientation
Gibt dem ModelMapper vor, wie Daten aus einem Modell zugeordnet werden sollen. Wird „ Qt.Vertical “ verwendet, definiert jede Zeile des Modells ein Tortensegment, und die Spalten des Modells definieren die Beschriftung oder den Wert des Tortensegments. Ist die Ausrichtung auf „ Qt.Horizontal “ gesetzt, definiert jede Spalte des Modells ein Tortensegment, und die Zeilen des Modells definieren die Beschriftung oder den Wert des Tortensegments.
Der Standardwert ist Qt.Vertical
series : PieSeries
Die vom Mapper verwendete Pie-Serie. Wenn Sie das Mapper-Element als untergeordnetes Element eines „ PieSeries “ definieren, lassen Sie diese Eigenschaft undefiniert. Alle Daten in der Serie werden verworfen, sobald sie dem Mapper zugewiesen wird. Wenn eine neue Serie angegeben wird, wird die alte Serie getrennt (ihre Daten bleiben jedoch erhalten).
valuesSection : qsizetype
Die Spalte oder Zeile des Modells, die mit den Werten der Tortenstücke synchronisiert wird. Der Standardwert ist -1 (ungültige Zuordnung).
Siehe auch „ orientation “.
Signal-Dokumentation
countChanged()
Dieses Signal wird ausgegeben, wenn sich der Zählerstand ändert.
Hinweis: Der entsprechende Handler lautet „ onCountChanged “.
firstChanged()
Dieses Signal wird ausgegeben, wenn sich der erste Slice ändert.
Hinweis: Der entsprechende Handler lautet „ onFirstChanged “.
labelsSectionChanged()
Dieses Signal wird ausgelöst, wenn sich der Abschnitt „Labels“ ändert.
Hinweis: Der entsprechende Handler lautet „ onLabelsSectionChanged “.
modelChanged()
Dieses Signal wird ausgelöst, wenn sich das Modell ändert, mit dem der Mapper verbunden ist.
Hinweis: Der entsprechende Handler ist „ onModelChanged “.
orientationChanged()
Dieses Signal wird ausgegeben, wenn sich die Ausrichtung ändert.
Hinweis: Der entsprechende Handler lautet „ onOrientationChanged “.
seriesChanged()
Dieses Signal wird ausgelöst, wenn sich die Serie ändert, an die der Mapper angeschlossen ist.
Hinweis: Der entsprechende Handler lautet „ onSeriesChanged “.
valuesSectionChanged()
Dieses Signal wird ausgelöst, wenn sich der Wertebereich ändert.
Hinweis: Der entsprechende Handler lautet „ onValuesSectionChanged “.
© 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.