HBarModelMapper QML Type
Horizontaler Modell-Mapper für Balkenreihen. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QHBarModelMapper |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- columnCount : int
- firstBarSetRow : int
- firstColumn : int
- lastBarSetRow : int
- model : SomeModel
- series : AbstractBarSeries
Ausführliche Beschreibung
Der Typ „HBarModelMapper“ ermöglicht die Verwendung eines von der Klasse „ QAbstractItemModel “ abgeleiteten Datenmodells als Datenquelle für ein Diagramm. Ein horizontaler Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ AbstractBarSeries “ herzustellen, sodass jede Zeile im Datenmodell einen Balkensatz definiert und jede Spalte einer Kategorie in einer Balkenreihe zugeordnet wird. Sie müssen das Datenmodell implementieren und es für QML verfügbar machen.
Zur Bearbeitung der Daten können sowohl Modell- als auch Balkenreihen-Eigenschaften verwendet werden. Der Modell-Mapper sorgt dafür, dass die Balkenreihe und das Datenmodell synchron bleiben.
Der Modell-Mapper stellt sicher, dass alle Balkensätze in der Balkenreihe die gleiche Größe haben. Daher führt das Hinzufügen oder Entfernen eines Werts aus einem Balkensatz dazu, dass dieselbe Änderung in allen Balkensätzen der Balkenreihe vorgenommen wird.
Der folgende QML-Codeausschnitt erstellt eine Balkenreihe mit drei Balkensätzen (vorausgesetzt, das Modell hat mindestens vier Zeilen). Jeder Balkensatz enthält Daten, beginnend mit Spalte 1. Der Name eines Balkensatzes wird durch die Zeilenüberschrift definiert.
BarSeries {
HBarModelMapper {
model: myCustomModel // QAbstractItemModel derived implementation
firstBarSetRow: 1
lastBarSetRow: 3
firstColumn: 1
}
}Siehe auch VBarModelMapper.
Dokumentation zu Eigenschaften
columnCount : int
Die Anzahl der Spalten des Modells, die als Daten für die Balkenreihe zugeordnet werden. Der Standardwert ist -1 (die Anzahl ist auf die Anzahl der Spalten im Modell begrenzt).
firstBarSetRow : int
Legt fest, welche Zeile des Modells als Datenquelle für den ersten Balkensatz verwendet wird. Der Standardwert ist -1 (ungültige Zuordnung).
firstColumn : int
Die Spalte des Modells, die die ersten Werte der Balkensätze in der Balkenreihe enthält. Der Standardwert ist 0.
lastBarSetRow : int
Die Zeile des Modells, die als Datenquelle für den letzten Balkensatz verwendet wird. Der Standardwert ist -1 (ungültige Zuordnung).
model : SomeModel
Das vom Mapper verwendete Datenmodell. 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.
series : AbstractBarSeries
Die Balkenreihe, die vom Mapper verwendet wird. Alle Daten in der Reihe werden verworfen, wenn sie dem Mapper zugewiesen wird. Wenn eine neue Reihe angegeben wird, wird die alte Reihe getrennt (ihre Daten bleiben jedoch erhalten).
© 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.