BarModelMapper QML Type

Modell-Mapper für Balkenserien. Mehr...

Import Statement:	`import QtGraphs`
In C++:	QBarModelMapper

Liste aller Mitglieder, einschließlich geerbter Mitglieder
BarModelMapper ist Teil von Qt Graphs QML Types for 2D.

Eigenschaften

count : qsizetype
first : qsizetype
firstBarSetSection : qsizetype
lastBarSetSection : qsizetype
model : model
orientation : orientation
series : BarSeries

Signale

Detaillierte Beschreibung

Der Typ BarModelMapper ermöglicht die Verwendung eines von der Klasse QAbstractItemModel abgeleiteten Datenmodells als Datenquelle für einen Graphen. Ein Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und QBarSeries herzustellen. Sie müssen das Datenmodell implementieren und es QML zur Verfügung stellen.

Sowohl die Eigenschaften des Modells als auch die der Balkenreihen können zur Bearbeitung der Daten verwendet werden. Der Modell-Mapper hält die Balkenreihen und das Datenmodell synchronisiert.

Der Modell-Mapper stellt sicher, dass alle Balkensätze in der Balkenserie die gleiche Größe haben. Daher bewirkt das Hinzufügen oder Entfernen eines Wertes in einem Balkensatz, dass die gleiche Änderung in allen Balkensätzen der Balkenserie vorgenommen wird.

Das folgende QML-Codefragment erstellt eine Balkenreihe mit drei Balkensätzen (vorausgesetzt, das Modell hat mindestens vier Spalten). Jedes Balkenset enthält Daten ab Zeile 1. Der Name eines Balkensets wird durch die Spaltenüberschrift definiert.

BarSeries {
    BarModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBarSetColumn: 1
        lastBarSetColumn: 3
        firstRow: 1
        orientation: Qt.Vertical
    }
}

Eigenschaft Dokumentation

count : qsizetype

Die Anzahl der Zeilen oder Spalten des Modells, die als Daten für die Balkenreihe abgebildet werden. Der Standardwert ist -1, der auch das Minimum darstellt. Die Anzahl ist durch die Anzahl der Zeilen/Spalten des Modells begrenzt.

Siehe auch orientation.

first : qsizetype

Die Zeile oder Spalte des Modells, die die ersten Werte der Balkensätze in der Balkenserie enthält. Der Standardwert ist 0.

Siehe auch orientation.

firstBarSetSection : qsizetype

Der Abschnitt des Modells, der als Datenquelle für den ersten Balkensatz verwendet wird. Der Standardwert ist -1 (ungültiges Mapping).

Siehe auch orientation.

lastBarSetSection : qsizetype

Der Abschnitt des Modells, der als Datenquelle für den letzten Balkensatz verwendet wird. Der Standardwert ist -1 (ungültiges Mapping).

Siehe auch orientation.

model : model

Das Datenmodell, das vom Mapper verwendet wird. Sie müssen das Modell implementieren und es QML zur Verfügung stellen.

Hinweis: Das Modell muss das Hinzufügen und Entfernen von Zeilen oder Spalten und das Ändern der Daten in den Zellen unterstützen.

orientation : orientation

Sagt dem Modelmapper, wie er Daten aus einem Modell abbilden soll. Wenn Qt.Vertical verwendet wird, definiert jede der Spalten des Modells einen Balkensatz und die Zeilen des Modells definieren die Kategorien. Wenn die Ausrichtung auf Qt.Horizontal eingestellt ist, definiert jede der Modellzeilen einen Balkensatz, und die Modellspalten definieren die Kategorien.

series : BarSeries

Die Balkenreihe, die vom Mapper verwendet wird. Alle Daten in der Serie werden verworfen, wenn sie für den Mapper festgelegt wird. Wenn die neue Serie angegeben wird, wird die alte Serie getrennt, aber ihre Daten bleiben erhalten.

Signal Dokumentation

countChanged()

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Zeilen oder Spalten ändert.

Hinweis: Der entsprechende Handler ist onCountChanged.

firstBarSetSectionChanged()

Dieses Signal wird ausgegeben, wenn sich der erste Abschnitt des Taktsets ändert.

Hinweis: Der entsprechende Handler ist onFirstBarSetSectionChanged.

firstChanged()

Dieses Signal wird ausgegeben, wenn sich die erste Zeile oder Spalte ändert.

Hinweis: Der entsprechende Handler ist onFirstChanged.

lastBarSetSectionChanged()

Dieses Signal wird ausgegeben, wenn sich der letzte eingestellte Balkenabschnitt ändert.

Hinweis: Der entsprechende Handler ist onLastBarSetSectionChanged.

modelChanged()

Dieses Signal wird ausgegeben, wenn sich das Modell, mit dem der Mapper verbunden ist, ändert.

Hinweis: Der entsprechende Handler ist onModelChanged.

orientationChanged()

Dieses Signal wird ausgegeben, wenn sich die Ausrichtung ändert.

Hinweis: Der entsprechende Handler ist onOrientationChanged.

orientationChanged()

Dieses Signal wird ausgegeben, wenn sich die Ausrichtung ändert.

Hinweis: Der entsprechende Handler ist onOrientationChanged.

seriesChanged()

Dieses Signal wird ausgegeben, wenn sich die Taktreihe, mit der der Mapper verbunden ist, ändert.

Hinweis: Der entsprechende Handler ist onSeriesChanged.

© 2025 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.