Auf dieser Seite

HPieModelMapper QML Type

Horizontaler Modell-Mapper für Kreisdiagramm-Reihen. Mehr...

Import Statement: import QtCharts 2.12
In C++: QHPieModelMapper
Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Ausführliche Beschreibung

Modell-Mapper ermöglichen die Verwendung eines aus der Klasse „ QAbstractItemModel “ abgeleiteten Datenmodells als Datenquelle für ein Diagramm. Ein horizontaler Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ PieSeries “ herzustellen, sodass jede Spalte im Datenmodell ein Tortenstück definiert und jede Zeile der Beschriftung oder dem Wert des Tortenstücks zugeordnet wird.

Zur Bearbeitung der Daten können sowohl die Eigenschaften der Modell- als auch 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 verfügt über mindestens fünf Spalten). Jedes Segment erhält eine Beschriftung aus Zeile 1 und einen Wert aus Zeile 2.

HPieModelMapper {
    series: pieSeries
    model: customModel
    labelsRow: 1
    valuesRow: 2
    firstColumn: 1
    columnCount: 4
}

Dokumentation zu den Eigenschaften

columnCount : int

Die Anzahl der Spalten des Modells, die als Daten für die Kreisdiagrammreihe zugeordnet werden. Der Standardwert ist -1 (die Anzahl ist durch die Anzahl der Spalten im Modell begrenzt).

firstColumn : int

Die Spalte des Modells, die den ersten Slice-Wert enthält. Der Standardwert ist 0.

labelsRow : int

Die Zeile des Modells, die mit den Beschriftungen der Tortenstücke synchronisiert wird. Der Standardwert ist -1 (ungültige Zuordnung).

model : SomeModel

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.

series : PieSeries

Das „PieSeries“-Objekt, das vom Mapper verwendet wird. Wenn Sie das Mapper-Element als untergeordnetes Element einer „PieSeries“ definieren, lassen Sie diese Eigenschaft undefiniert. Alle Daten der Serie werden verworfen, wenn sie dem Mapper zugewiesen wird. Wenn eine neue Serie angegeben wird, wird die Verbindung zur alten Serie getrennt (die Daten der alten Serie bleiben jedoch erhalten).

valuesRow : int

Die Zeile des Modells, die mit den Werten der Tortenstücke synchronisiert wird. Der Standardwert ist -1 (ungültige Zuordnung).

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