BarModelMapper QML Type
Modell-Mapper für Balkenreihen. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QBarModelMapper |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- BarModelMapper ist Teil von „Qt Graphs “ – QML-Typen für 2D.
Eigenschaften
- count : qsizetype
- first : qsizetype
- firstBarSetSection : qsizetype
- lastBarSetSection : qsizetype
- model : model
- orientation : orientation
- series : BarSeries
Signale
- countChanged()
- firstBarSetSectionChanged()
- firstChanged()
- lastBarSetSectionChanged()
- modelChanged()
- orientationChanged()
- orientationChanged()
- seriesChanged()
Ausführliche Beschreibung
Der Typ `BarModelMapper` ermöglicht 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 ` QBarSeries` herzustellen. 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 Balkenreihen 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 verfügt über mindestens vier Spalten). Jeder Balkensatz enthält Daten ab Zeile 1. Der Name eines Balkensatzes wird durch die Spaltenüberschrift definiert.
BarSeries {
BarModelMapper {
model: myCustomModel // QAbstractItemModel derived implementation
firstBarSetColumn: 1
lastBarSetColumn: 3
firstRow: 1
orientation: Qt.Vertical
}
}Dokumentation zu den Eigenschaften
count : qsizetype
Die Anzahl der Zeilen oder Spalten des Modells, die als Daten für die Balkenreihe zugeordnet werden. Der Standardwert ist „ -1 “, was zugleich den Mindestwert darstellt. Die Anzahl ist durch die Anzahl der Zeilen bzw. Spalten des Modells begrenzt.
Siehe auch „ orientation “.
first : qsizetype
Die Zeile oder Spalte des Modells, die die ersten Werte der Balkensätze in der Balkenreihe enthält. Der Standardwert ist 0.
Siehe auch „ orientation “.
firstBarSetSection : qsizetype
Der Abschnitt des Modells, der als Datenquelle für den ersten Balkensatz dient. Der Standardwert ist -1 (ungültige Zuordnung).
Siehe auch „ orientation “.
lastBarSetSection : qsizetype
Der Abschnitt des Modells, der als Datenquelle für den letzten Balkensatz verwendet wird. Der Standardwert ist -1 (ungültige Zuordnung).
Siehe auch „ orientation “.
model : model
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.
orientation : orientation
Gibt dem ModelMapper vor, wie Daten aus einem Modell zuzuordnen sind. Bei Verwendung von „ Qt.Vertical “ definiert jede Spalte des Modells einen Balkensatz, und die Zeilen des Modells definieren die Kategorien. Bei der Ausrichtung „ Qt.Horizontal “ definiert jede Zeile des Modells einen Balkensatz, und die Spalten des Modells definieren die Kategorien.
series : BarSeries
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.
Signal-Dokumentation
countChanged()
Dieses Signal wird ausgelöst, wenn sich die Anzahl der Zeilen oder Spalten ändert.
Hinweis: Der entsprechende Handler lautet „ onCountChanged “.
firstBarSetSectionChanged()
Dieses Signal wird ausgegeben, wenn sich der erste Taktabschnitt ändert.
Hinweis: Der entsprechende Handler lautet „ onFirstBarSetSectionChanged “.
firstChanged()
Dieses Signal wird ausgelöst, wenn sich die erste Zeile oder Spalte ändert.
Hinweis: Der entsprechende Handler ist „ onFirstChanged “.
lastBarSetSectionChanged()
Dieses Signal wird ausgegeben, wenn sich der Abschnitt des letzten Takts ändert.
Hinweis: Der entsprechende Handler lautet „ onLastBarSetSectionChanged “.
modelChanged()
Dieses Signal wird ausgelöst, wenn sich das Modell ändert, mit dem der Mapper verbunden ist.
Hinweis: Der entsprechende Handler lautet „ onModelChanged “.
orientationChanged()
Dieses Signal wird ausgegeben, wenn sich die Ausrichtung ändert.
Hinweis: Der zugehörige Handler lautet „ onOrientationChanged “.
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 Balkenreihe ändert, mit der der Mapper verbunden ist.
Hinweis: Der zugehörige Handler lautet „ onSeriesChanged “.
© 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.