PieSeries QML Type
Stellt Daten in Kreisdiagrammen dar. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QPieSeries |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- count : int
- endAngle : real
- holeSize : real
- horizontalPosition : real
- size : real
- startAngle : real
- sum : real
- verticalPosition : real
Signale
- added(list<PieSlice> slices)
- clicked(PieSlice slice)
- doubleClicked(PieSlice slice)
- hovered(PieSlice slice, bool state)
- pressed(PieSlice slice)
- released(PieSlice slice)
- removed(list<PieSlice> slices)
- sliceAdded(PieSlice slice)
- sliceRemoved(PieSlice slice)
Methoden
- PieSlice append(string label, real value)
- PieSlice at(int index)
- void clear()
- PieSlice find(string label)
- bool remove(PieSlice slice)
Ausführliche Beschreibung
Eine Kreisdiagrammreihe besteht aus Segmenten, die mithilfe des Typs „ PieSlice “ definiert werden. Die Segmente können beliebige Werte annehmen, da der Typ „PieSeries“ den prozentualen Anteil eines Segments im Vergleich zur Summe aller Segmente der Reihe berechnet, um die tatsächliche Größe des Segments im Diagramm zu bestimmen.
Die Größe und Position des Kreisdiagramms im Diagramm werden mithilfe relativer Werte zwischen 0,0 und 1,0 gesteuert. Diese beziehen sich auf das tatsächliche Diagrammrechteck.
Standardmäßig wird das Kreisdiagramm als vollständiges Kreisdiagramm definiert. Ein Teilkreisdiagramm kann erstellt werden, indem ein Startwinkel und eine Winkelspanne für die Reihe festgelegt werden. Ein vollständiges Kreisdiagramm umfasst 360 Grad, wobei 0 auf 12 Uhr liegt.
Das folgende QML-Beispiel zeigt, wie man ein einfaches Kreisdiagramm erstellt.
ChartView {
id: chart
title: "Top-5 car brand shares in Finland"
anchors.fill: parent
legend.alignment: Qt.AlignBottom
antialiasing: true
property variant othersSlice: 0
PieSeries {
id: pieSeries
PieSlice { label: "Volkswagen"; value: 13.5 }
PieSlice { label: "Toyota"; value: 10.9 }
PieSlice { label: "Ford"; value: 8.6 }
PieSlice { label: "Skoda"; value: 8.2 }
PieSlice { label: "Volvo"; value: 6.8 }
}
Component.onCompleted: {
// You can also manipulate slices dynamically, like append a slice or set a slice exploded
othersSlice = pieSeries.append("Others", 52.0);
pieSeries.find("Volkswagen").exploded = true;
}
}
Siehe auch PieSlice und ChartView.
Dokumentation zu den Eigenschaften
count : int [read-only]
Die Anzahl der Schichten in der Serie.
endAngle : real
Der Endwinkel des Kreises.
Ein voller Kreis umfasst 360 Grad, wobei 0 Grad bei 12 Uhr liegt.
Der Standardwert ist 360.
holeSize : real
Die Größe des „Donut-Lochs“.
Der Wert bezieht sich auf das Diagrammrechteck, sodass gilt:
- 0,0 die Mindestgröße darstellt (vollständiges Kreisdiagramm ohne Loch).
- 1,0 ist die maximale Größe, die in das Diagramm passt (der Donut hat keine Breite).
Beim Festlegen dieser Eigenschaft wird die Eigenschaft „ size “ bei Bedarf angepasst, um sicherzustellen, dass die Lochgröße nicht größer ist als die Kreisgröße.
Der Standardwert ist 0,0.
horizontalPosition : real
Die horizontale Position des Kreisdiagramms.
Der Wert bezieht sich auf das Diagrammrechteck, sodass gilt:
- 0,0 die absolute linke Position ist.
- 1,0 ist die absolute rechte Position.
Der Standardwert ist 0,5 (Mitte).
Siehe auch verticalPosition.
size : real
Die Größe des Kreisdiagramms.
Der Wert bezieht sich auf das Diagrammrechteck, sodass gilt:
- 0,0 die minimale Größe ist (Kreisdiagramm wird nicht gezeichnet).
- 1,0 ist die maximale Größe, die in das Diagramm passt.
Bei der Festlegung dieser Eigenschaft wird die Eigenschaft „ holeSize “ bei Bedarf angepasst, um sicherzustellen, dass die Lochgröße nicht größer ist als die Kreisdiagrammgröße.
Der Standardwert ist 0,7.
startAngle : real
Der Startwinkel des Kreises.
Ein vollständiger Kreis beträgt 360 Grad, wobei 0 Grad bei 12 Uhr liegt.
Der Standardwert ist 0.
sum : real [read-only]
Die Summe aller Teilmengen.
Die Reihe verfolgt die Summe aller darin enthaltenen Segmente.
verticalPosition : real
Die vertikale Position des Kreisdiagramms.
Der Wert bezieht sich auf das Diagrammrechteck, sodass:
- 0,0 die absolute Oberkante ist.
- 1,0 ist die absolute Unterseite.
Der Standardwert ist 0,5 (Mitte).
Siehe auch horizontalPosition.
Signal-Dokumentation
added(list<PieSlice> slices)
Dieses Signal wird ausgelöst, wenn die durch slices angegebenen Schnitte zur Serie hinzugefügt werden.
Der zugehörige Signal-Handler lautet „ onAdded “.
Hinweis: Der zugehörige Handler lautet „ onAdded “.
clicked(PieSlice slice)
Dieses Signal wird ausgelöst, wenn auf den durch „ slice “ angegebenen Ausschnitt geklickt wird.
Der zugehörige Signal-Handler ist „ onClicked “.
Hinweis: Der entsprechende Handler ist „ onClicked “.
doubleClicked(PieSlice slice)
Dieses Signal wird ausgelöst, wenn auf den unter slice angegebenen Ausschnitt doppelt geklickt wird.
Der zugehörige Signal-Handler ist „ onDoubleClicked “.
Hinweis: Der zugehörige Handler ist „ onDoubleClicked “.
hovered(PieSlice slice, bool state)
Dieses Signal wird ausgelöst, wenn der Mauszeiger über den durch slice angegebenen Ausschnitt geführt wird. Wenn sich der Mauszeiger über den Ausschnitt bewegt, wechselt state den Status zu true, und wenn der Mauszeiger wieder wegbewegt wird, wechselt er zu false.
Der zugehörige Signal-Handler ist onHovered.
Hinweis: Der entsprechende Handler ist onHovered.
pressed(PieSlice slice)
Dieses Signal wird ausgelöst, wenn der Benutzer auf den durch „ slice “ angegebenen Ausschnitt klickt und die Maustaste gedrückt hält.
Der zugehörige Signal-Handler lautet „ onPressed “.
Hinweis: Der entsprechende Handler ist „ onPressed “.
released(PieSlice slice)
Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem durch slice angegebenen Ausschnitt aufhebt.
Der zugehörige Signal-Handler ist „ onReleased “.
Hinweis: Der entsprechende Handler ist „ onReleased “.
removed(list<PieSlice> slices)
Dieses Signal wird ausgelöst, wenn die durch „ slices “ angegebenen Schichten aus der Serie entfernt werden.
Der zugehörige Signal-Handler ist „ onRemoved “.
Hinweis: Der zugehörige Handler ist „ onRemoved “.
sliceAdded(PieSlice slice)
Dieses Signal wird ausgelöst, wenn der durch „ slice “ angegebene Ausschnitt zur Serie hinzugefügt wird.
Der zugehörige Signal-Handler lautet „ onSliceAdded “.
Hinweis: Der zugehörige Handler lautet „ onSliceAdded “.
sliceRemoved(PieSlice slice)
Dieses Signal wird ausgelöst, wenn der durch „ slice “ angegebene Ausschnitt aus der Serie entfernt wird.
Der zugehörige Signal-Handler lautet „ onSliceRemoved “.
Hinweis: Der entsprechende Handler ist „ onSliceRemoved “.
Methodendokumentation
PieSlice append(string label, real value)
Fügt dem Kreisdiagramm einen neuen Sektor mit der Bezeichnung „ label “ und dem Wert „ value “ hinzu.
PieSlice at(int index)
Gibt den Ausschnitt an der durch ` index` angegebenen Position zurück. Gibt `null` zurück, wenn der Index ungültig ist.
void clear()
Entfernt alle Stücke aus dem Kuchen.
PieSlice find(string label)
Gibt das erste Segment zurück, das die Bezeichnung „ label “ trägt. Gibt „null“ zurück, wenn die Bezeichnung nicht gefunden wird.
bool remove(PieSlice slice)
Entfernt den durch „ slice “ angegebenen Sektor aus dem Kreisdiagramm. Gibt „ true “ zurück, wenn das Entfernen erfolgreich war, andernfalls „ false “.
© 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.
