Auf dieser Seite

VPieModelMapper QML Type

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

Import Statement: import QtCharts 2.12
In C++: QVPieModelMapper
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 vertikaler Modell-Mapper wird verwendet, um eine Verbindung zwischen einem Datenmodell und „ PieSeries “ herzustellen, sodass jede Zeile im Datenmodell ein Tortenstück definiert und jede Spalte 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 Zeilen). Jedes Segment erhält eine Beschriftung aus Spalte 1 und einen Wert aus Spalte 2.

VPieModelMapper {
    series: pieSeries
    model: customModel
    labelsColumn: 1
    valuesColumn: 2
    firstRow: 1
    rowCount: 4
}

Dokumentation zu den Eigenschaften

firstRow : int

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

labelsColumn : int

Die Spalte 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.

rowCount : int

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

series : PieSeries

Die vom Mapper verwendete Kreisdiagramm-Serie. Wenn Sie das Mapper-Element als untergeordnetes Element einer PieSeries definieren, lassen Sie diese Eigenschaft undefiniert. Alle Daten der Serie werden verworfen, wenn diese dem Mapper zugewiesen wird. Wenn eine neue Serie angegeben wird, wird die alte Serie getrennt (ihre Daten bleiben jedoch erhalten).

valuesColumn : int

Die Spalte 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.