HPieModelMapper QML Type

Horizontaler Modell-Mapper für Tortenreihen. Mehr...

Import Statement: import QtCharts 2.8
In C++: QHPieModelMapper

Eigenschaften

Ausführliche Beschreibung

Modell-Mapper ermöglichen 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 PieSeries herzustellen, so dass jede Spalte im Datenmodell einen Kreisausschnitt definiert und jede Zeile der Beschriftung oder dem Wert des Kreisausschnitts entspricht.

Sowohl Modell- als auch Kreisreiheneigenschaften können zur Manipulation der Daten verwendet werden. Der Modell-Mapper hält die Tortenreihe und das Datenmodell auf dem gleichen Stand.

Das folgende QML-Beispiel erstellt eine Kuchenserie mit vier Segmenten (vorausgesetzt, das Modell hat mindestens fünf Spalten). Jedes Slice 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
}

Eigenschaft Dokumentation

columnCount : int

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


firstColumn : int

Die Spalte des Modells, die den ersten Tortenstückwert enthält. Der Standardwert ist 0.


labelsRow : int

Die Zeile des Modells, die mit den Beschriftungen der Tortenscheiben synchron gehalten wird. Der Standardwert ist -1 (ungültiges Mapping).


model : SomeModel

Das QAbstractItemModel basierte Modell, 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.


series : PieSeries

Das PieSeries Objekt, das vom Mapper verwendet wird. Wenn Sie das Mapper-Element als untergeordnetes Element für ein PieSeries definieren, lassen Sie diese Eigenschaft undefiniert. Alle Daten in der Serie werden verworfen, wenn sie auf den Mapper gesetzt wird. Wenn eine neue Reihe angegeben wird, wird die alte Reihe getrennt (ihre Daten bleiben jedoch erhalten).


valuesRow : int

Die Zeile des Modells, die mit den Werten der Tortenscheiben synchronisiert wird. Der Standardwert ist -1 (ungültiges Mapping).


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