Auf dieser Seite

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

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.