Back to Qt.io
Contact Us Blog Download Qt

PieSeries QML Type

Stellt Daten in Kreisdiagrammen dar. Mehr...

Import Statement: import QtGraphs
In C++: QPieSeries
Inherits:

AbstractSeries

Eigenschaften

Signale

Methoden

  • PieSlice append(string label, real value)
  • PieSlice at(int index)
  • clear()
  • PieSlice find(string label)
  • bool remove(PieSlice slice)
  • bool remove(int index)
  • void removeMultiple(int index, int count)
  • bool replace(list<PieSlice> slices)
  • bool replace(PieSlice oldSlice, PieSlice newSlice)
  • bool replace(int index, PieSlice slice)
  • bool take(PieSlice slice)

Detaillierte Beschreibung

Eine Kuchenserie besteht aus Abschnitten, die mit dem Typ PieSlice definiert werden. Die Slices können beliebige Werte haben, da der Typ PieSeries den Prozentsatz eines Slices im Vergleich zur Summe aller Slices in der Serie berechnet, um die tatsächliche Größe des Slices im Diagramm zu bestimmen.

Größe und Position des Kreises im Diagramm werden durch relative Werte zwischen 0,0 und 1,0 gesteuert. Diese beziehen sich auf das tatsächliche Diagrammrechteck.

Standardmäßig ist die Torte als vollständige Torte definiert. Ein partieller Kreis kann erstellt werden, indem ein Startwinkel und eine Winkelspanne für die Serie festgelegt werden. Ein vollständiger Kreis umfasst 360 Grad, wobei 0 auf 12 Uhr steht.

Das folgende QML-Beispiel zeigt, wie man ein einfaches Kreisdiagramm erstellt.

import QtQuick
import QtGraphs

Item {
    id: mainView
    width: 1280
    height: 720

    GraphsView {
        anchors.fill: parent
        theme: GraphsTheme {
             colorScheme: GraphsTheme.ColorScheme.Dark
             theme: GraphsTheme.Theme.QtGreen
        }
        PieSeries {
            id: pieSeries
            PieSlice {
                value: 1
            }
            PieSlice {
                value: 2
            }
        }
    }
}

Siehe auch PieSlice und GraphsView.

Eigenschaft Dokumentation

count : int [read-only]

Die Anzahl der Scheiben in der Serie.


endAngle : real

Der Endwinkel der Torte.

Ein voller Kuchen hat 360 Grad, wobei 0 Grad auf 12 Uhr steht.

Der Standardwert ist 360.


holeSize : real

Die Größe des Donut-Lochs.

Beim Einstellen der Eigenschaft pieSize wird diese Eigenschaft bei Bedarf angepasst, um sicherzustellen, dass die Lochgröße nicht größer als die Kuchengröße ist.

Der Standardwert ist 0.0.


horizontalPosition : real

Die horizontale Position des Kuchens.

Der Wert ist relativ zum Diagrammrechteck, so dass:

  • 0.0 ist die absolut linke Seite.
  • 1.0 ist der absolute rechte Rand.

Der Standardwert ist 0.5 (Mitte).

Siehe auch verticalPosition.


pieSize : real

Die Tortengröße.

Der Wert ist relativ zum Diagrammrechteck, so dass:

  • 0.0 ist die minimale pieSize (Torte wird nicht gezeichnet).
  • 1.0 ist die maximale pieSize, die in das Diagramm passt.

Beim Einstellen dieser Eigenschaft wird die Eigenschaft holeSize gegebenenfalls angepasst, um sicherzustellen, dass die Lochgröße nicht größer als die Tortengröße ist.

Der Standardwert ist 0.7.


startAngle : real

Der Startwinkel des Kreises.

Ein voller Kuchen hat 360 Grad, wobei 0 Grad auf 12 Uhr steht.

Der Standardwert ist 0.


sum : real [read-only]

Die Summe aller Slices.

Die Serie speichert die Summe aller Scheiben, die sie enthält.


verticalPosition : real

Die vertikale Position des Kuchens.

Der Wert ist relativ zum Diagrammrechteck, so dass:

  • 0.0 ist der absolute obere Rand.
  • 1.0 ist das absolute Ende.

Der Standardwert ist 0.5 (Mitte).

Siehe auch horizontalPosition.


Signal Dokumentation

added(list<PieSlice> slices)

Dieses Signal wird ausgegeben, wenn die durch slices angegebenen Slices zur Serie hinzugefügt werden.

Hinweis: Der entsprechende Handler ist onAdded.


countChanged()

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Slices ändert.

Hinweis: Der entsprechende Handler ist onCountChanged.

Siehe auch count.


endAngleChanged()

Dieses Signal wird ausgegeben, wenn sich der Tortenendwinkel ändert.

Hinweis: Der entsprechende Handler ist onEndAngleChanged.

Siehe auch endAngle.


holeSizeChanged()

Dieses Signal wird ausgegeben, wenn sich die Größe des Donut-Lochs ändert.

Hinweis: Der entsprechende Handler ist onHoleSizeChanged.

Siehe auch holeSize.


horizontalPositionChanged()

Dieses Signal wird ausgegeben, wenn sich die horizontale Position ändert.

Hinweis: Der entsprechende Handler ist onHorizontalPositionChanged.

Siehe auch horizontalPosition.


pieSizeChanged()

Dieses Signal wird ausgegeben, wenn sich die Tortengröße ändert.

Hinweis: Der entsprechende Handler ist onPieSizeChanged.

Siehe auch pieSize.


removed(list<PieSlice> slices)

Dieses Signal wird ausgegeben, wenn die durch slices angegebenen Scheiben aus der Serie entfernt werden.

Hinweis: Der entsprechende Handler ist onRemoved.


startAngleChanged()

Dieses Signal wird ausgegeben, wenn sich der Startwinkel des Kuchens ändert.

Hinweis: Der entsprechende Handler ist onStartAngleChanged.

Siehe auch startAngle.


sumChanged()

Dieses Signal wird ausgegeben, wenn sich die Summe aller Slices ändert.

Hinweis: Der entsprechende Handler ist onSumChanged.

Siehe auch sum.


verticalPositionChanged()

Dieses Signal wird ausgegeben, wenn sich die vertikale Position ändert.

Hinweis: Der entsprechende Handler ist onVerticalPositionChanged.

Siehe auch verticalPosition.


Methode Dokumentation

PieSlice append(string label, real value)

Fügt dem Kuchen ein neues Stück mit der Beschriftung label und dem Wert value hinzu.


PieSlice at(int index)

Gibt die Scheibe an der durch index angegebenen Position zurück. Gibt null zurück, wenn der Index ungültig ist.


clear()

Entfernt alle Scheiben aus dem Kuchen.


PieSlice find(string label)

Gibt das erste Stück zurück, das die Beschriftung label hat. Gibt null zurück, wenn die Beschriftung nicht gefunden wird.


bool remove(PieSlice slice)

Entfernt das durch slice angegebene Stück aus der Torte. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false.


bool remove(int index)

Entfernt das durch index angegebene Stück aus dem Kuchen. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false.


void removeMultiple(int index, int count)

Entfernt einen Bereich von Slices, wie durch index und count angegeben. Der Aufruf durchläuft alle Slices, auch wenn das Entfernen eines Slices fehlschlägt.


bool replace(list<PieSlice> slices)

Ersetzt alle aktuellen Slices vollständig durch slices. Die Größe muss nicht übereinstimmen. Gibt false zurück, wenn eines der PieSlice in slices ungültig ist.


bool replace(PieSlice oldSlice, PieSlice newSlice)

Ersetzt das durch oldSlice angegebene Slice durch newSlice. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false. oldSlice wird zerstört, wenn dies erfolgreich ist.


bool replace(int index, PieSlice slice)

Ersetzt das durch slice angegebene Stück aus dem Kuchen durch index. Gibt true zurück, wenn das Ersetzen erfolgreich war, andernfalls false.


bool take(PieSlice slice)

Entnimmt ein einzelnes Stück, angegeben durch slice, aus der Serie. Das Objekt slice wird nicht gelöscht. Gibt bei Erfolg true zurück.


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