QPieSeries Class
Die Klasse „QPieSeries“ stellt Daten in Kreisdiagrammen dar. Mehr...
| Header: | #include <QPieSeries> |
| In QML: | PieSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
|
|
Öffentliche Funktionen
| QPieSeries(QObject *parent = nullptr) | |
| virtual | ~QPieSeries() |
| bool | append(QPieSlice *slice) |
| bool | append(const QList<QPieSlice *> &slices) |
| QPieSlice * | append(const QString &label, qreal value) |
| void | clear() |
| int | count() const |
| qreal | holeSize() const |
| qreal | horizontalPosition() const |
| bool | insert(int index, QPieSlice *slice) |
| bool | isEmpty() const |
| qreal | pieEndAngle() const |
| qreal | pieSize() const |
| qreal | pieStartAngle() const |
| bool | remove(QPieSlice *slice) |
| void | setHoleSize(qreal holeSize) |
| void | setHorizontalPosition(qreal relativePosition) |
| void | setLabelsPosition(QPieSlice::LabelPosition position) |
| void | setLabelsVisible(bool visible = true) |
| void | setPieEndAngle(qreal angle) |
| void | setPieSize(qreal relativeSize) |
| void | setPieStartAngle(qreal startAngle) |
| void | setVerticalPosition(qreal relativePosition) |
| QList<QPieSlice *> | slices() const |
| qreal | sum() const |
| bool | take(QPieSlice *slice) |
| qreal | verticalPosition() const |
| QPieSeries & | operator<<(QPieSlice *slice) |
Neu implementierte öffentliche Funktionen
| virtual QAbstractSeries::SeriesType | type() const override |
Signale
| void | added(const QList<QPieSlice *> &slices) |
| void | clicked(QPieSlice *slice) |
| void | countChanged() |
| void | doubleClicked(QPieSlice *slice) |
| void | hovered(QPieSlice *slice, bool state) |
| void | pressed(QPieSlice *slice) |
| void | released(QPieSlice *slice) |
| void | removed(const QList<QPieSlice *> &slices) |
| void | sumChanged() |
Ausführliche Beschreibung
Eine Kreisdiagrammreihe besteht aus Segmenten, die als „ QPieSlice “-Objekte definiert sind. Die Segmente können beliebige Werte annehmen, da das „QPieSeries“-Objekt den prozentualen Anteil eines Segments im Verhältnis 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 ist das Kreisdiagramm als Vollkreis definiert. Ein Teilkreisdiagramm lässt sich erstellen, indem ein Startwinkel und ein Winkelspannbereich für die Reihe festgelegt werden. Ein Vollkreis umfasst 360 Grad, wobei 0 auf 12 Uhr liegt.
In der Galerie „Diagramme mit Widgets “ erfahren Sie, wie Sie QPieSeries verwenden.


Siehe auch QPieSlice und QChart.
Dokumentation zu den Eigenschaften
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der Segmente in der Reihe an.
Zugriffsfunktionen:
| int | count() const |
Benachrichtigungssignal:
| void | countChanged() |
endAngle : qreal
Diese Eigenschaft gibt den Endwinkel des Kreises an.
Ein vollständiger Kreis beträgt 360 Grad, wobei 0 Grad der 12-Uhr-Position entspricht.
Der Standardwert ist 360.
Zugriffsfunktionen:
| qreal | pieEndAngle() const |
| void | setPieEndAngle(qreal angle) |
holeSize : qreal
Diese Eigenschaft gibt die Größe des Donut-Lochs an.
Der Wert bezieht sich auf das Diagrammrechteck, sodass gilt:
- 0,0 die minimale Größe ist (vollständiger Kreis 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.
Zugriffsfunktionen:
| qreal | holeSize() const |
| void | setHoleSize(qreal holeSize) |
horizontalPosition : qreal
Diese Eigenschaft legt die horizontale Position des Kreisdiagramms fest.
Der Wert bezieht sich auf das Diagrammrechteck, sodass:
- 0,0 die absolute linke Position ist.
- 1,0 ist die absolute rechte Position.
Der Standardwert ist 0,5 (Mitte).
Zugriffsfunktionen:
| qreal | horizontalPosition() const |
| void | setHorizontalPosition(qreal relativePosition) |
Siehe auch verticalPosition.
size : qreal
Diese Eigenschaft gibt die Größe des Kreisdiagramms an.
Der Wert bezieht sich auf das Diagrammrechteck, sodass gilt:
- 0,0 die minimale Größe ist (Kuchendiagramm wird nicht gezeichnet).
- 1,0 ist die maximale Größe, die in das Diagramm passt.
Beim Festlegen 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.
Zugriffsfunktionen:
| qreal | pieSize() const |
| void | setPieSize(qreal relativeSize) |
startAngle : qreal
Diese Eigenschaft enthält den Startwinkel des Kreisdiagramms.
Ein vollständiger Kreis beträgt 360 Grad, wobei 0 Grad der 12-Uhr-Position entspricht.
Der Standardwert ist 0.
Zugriffsfunktionen:
| qreal | pieStartAngle() const |
| void | setPieStartAngle(qreal startAngle) |
[read-only] sum : qreal
Diese Eigenschaft enthält die Summe aller Segmente.
Die Reihe verfolgt die Summe aller in ihr enthaltenen Segmente.
Zugriffsfunktionen:
| qreal | sum() const |
Benachrichtigungssignal:
| void | sumChanged() |
verticalPosition : qreal
Diese Eigenschaft legt die vertikale Position des Kreisdiagramms fest.
Der Wert ist relativ zum Diagrammrechteck, sodass gilt:
- 0,0 die absolute Oberkante ist.
- 1,0 ist die absolute Unterkante.
Der Standardwert ist 0,5 (Mitte).
Zugriffsfunktionen:
| qreal | verticalPosition() const |
| void | setVerticalPosition(qreal relativePosition) |
Siehe auch „ horizontalPosition “.
Dokumentation zu Mitgliedsfunktionen
[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)
Erstellt ein Serienobjekt, das ein untergeordnetes Objekt von „ parent “ ist.
[virtual noexcept] QPieSeries::~QPieSeries()
Entfernt die Kreisdiagrammreihe und ihre Segmente.
[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)
Dieses Signal wird ausgelöst, wenn die durch „ slices “ angegebenen Schnitte zur Serie hinzugefügt werden.
Siehe auch „ append()“ und „ insert()“.
bool QPieSeries::append(QPieSlice *slice)
Fügt den durch „ slice “ angegebenen Ausschnitt an die Reihe an. Die Eigentumsrechte an dem Ausschnitt werden an die Reihe übertragen.
Gibt true zurück, wenn das Anhängen erfolgreich war.
bool QPieSeries::append(const QList<QPieSlice *> &slices)
Fügt das durch ` slices ` angegebene Array von Slices an die Serie an. Die Eigentumsrechte an den Slices werden an die Serie übertragen.
Gibt ` true ` zurück, wenn das Anhängen erfolgreich war.
QPieSlice *QPieSeries::append(const QString &label, qreal value)
Fügt der Reihe einen einzelnen Ausschnitt mit den angegebenen Werten „ value “ und „ label “ hinzu. Die Eigentumsrechte an dem Ausschnitt werden an die Reihe übertragen. Gibt „null“ zurück, wenn „ value “ den Wert „ NaN “, „ Inf “ oder „ -Inf “ hat, und fügt der Reihe nichts hinzu.
void QPieSeries::clear()
Löscht alle Segmente aus der Serie.
[signal] void QPieSeries::clicked(QPieSlice *slice)
Dieses Signal wird ausgelöst, wenn auf die durch „ slice “ angegebene Scheibe geklickt wird.
Siehe auch QPieSlice::clicked().
int QPieSeries::count() const
Gibt die Anzahl der Segmente in dieser Reihe zurück.
Hinweis: Getter -Funktion für die Eigenschaft „count“.
[signal] void QPieSeries::countChanged()
Dieses Signal wird ausgegeben, wenn sich die Anzahl der Schichten ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ count “.
Siehe auch „ count “.
[signal] void QPieSeries::doubleClicked(QPieSlice *slice)
Dieses Signal wird ausgelöst, wenn auf die unter „ slice “ angegebene Scheibe doppelt geklickt wird.
Siehe auch QPieSlice::doubleClicked().
[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)
Dieses Signal wird ausgelöst, wenn der Mauszeiger über die durch ` slice` angegebene Scheibe bewegt wird. Wenn sich der Mauszeiger über die Scheibe bewegt, wechselt ` state ` zu ` true`, und wenn der Mauszeiger wieder wegbewegt wird, wechselt es zu ` false`.
Siehe auch QPieSlice::hovered().
bool QPieSeries::insert(int index, QPieSlice *slice)
Fügt den durch slice angegebenen Ausschnitt vor den Ausschnitt an der durch index angegebenen Position in die Reihe ein. Die Eigentumsrechte am Ausschnitt werden an die Reihe übergeben.
Gibt true zurück, wenn das Einfügen erfolgreich war.
bool QPieSeries::isEmpty() const
Gibt „ true “ zurück, wenn die Reihe leer ist.
qreal QPieSeries::pieEndAngle() const
Gibt den Endwinkel des Kreises zurück.
Ein vollständiger Kreis beträgt 360 Grad, wobei 0 Grad bei 12 Uhr liegt.
Hinweis: Getter -Funktion für die Eigenschaft „ endAngle “.
Siehe auch „ setPieEndAngle()“, „ pieStartAngle()“ und „ setPieStartAngle()“.
[signal] void QPieSeries::pressed(QPieSlice *slice)
Dieses Signal wird ausgelöst, wenn der Benutzer auf den durch „ slice “ angegebenen Ausschnitt klickt und die Maustaste gedrückt hält.
Siehe auch QPieSlice::pressed().
[signal] void QPieSeries::released(QPieSlice *slice)
Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem durch ` slice` angegebenen Ausschnitt loslässt.
Siehe auch QPieSlice::released().
bool QPieSeries::remove(QPieSlice *slice)
Entfernt einen einzelnen Slice, der durch „ slice “ angegeben wird, aus der Serie und löscht ihn endgültig.
Auf den Zeiger kann nach diesem Aufruf nicht mehr verwiesen werden.
Gibt ` true ` zurück, wenn das Entfernen erfolgreich war.
[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)
Dieses Signal wird ausgegeben, wenn die durch „ slices “ angegebenen Schichten aus der Serie entfernt werden.
Siehe auch remove().
void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)
Legt die Position aller Segmentbeschriftungen auf „ position “ fest.
Hinweis: Diese Funktion wirkt sich nur auf die aktuellen Schnitten in der Reihe aus. Wird eine neue Schnittfläche hinzugefügt, lautet die Standardposition der Beschriftung „ QPieSlice::LabelOutside “.
Siehe auch „ QPieSlice::labelPosition()“ und „ QPieSlice::setLabelPosition()“.
void QPieSeries::setLabelsVisible(bool visible = true)
Legt die Sichtbarkeit aller Slice-Beschriftungen auf „ visible “ fest.
Hinweis: Diese Funktion wirkt sich nur auf die aktuellen Slices in der Serie aus. Wird ein neuer Slice hinzugefügt, ist die Standard-Sichtbarkeit der Beschriftung „ false “.
Siehe auch „ QPieSlice::isLabelVisible()“ und „ QPieSlice::setLabelVisible()“.
void QPieSeries::setPieEndAngle(qreal angle)
Legt den Endwinkel des Kreisdiagramms fest.
Ein vollständiger Kreis beträgt 360 Grad, wobei 0 Grad der 12-Uhr-Position entspricht.
angle muss größer sein als der Startwinkel.
Hinweis: Setter -Funktion für die Eigenschaft endAngle.
Siehe auch „ pieEndAngle()“, „ pieStartAngle()“ und „ setPieStartAngle()“.
QList<QPieSlice *> QPieSeries::slices() const
Gibt eine Liste der zu dieser Reihe gehörenden Ausschnitte zurück.
qreal QPieSeries::sum() const
Gibt die Summe aller Werte der Teilmenge in dieser Reihe zurück.
Hinweis: Getter -Funktion für die Eigenschaft „sum“.
Siehe auch „ QPieSlice::value()“, „ QPieSlice::setValue()“ und „ QPieSlice::percentage()“.
[signal] void QPieSeries::sumChanged()
Dieses Signal wird ausgegeben, wenn sich die Summe aller Slices ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ sum “.
Siehe auch „ sum “.
bool QPieSeries::take(QPieSlice *slice)
Entnimmt einen einzelnen Ausschnitt, der durch ` slice` angegeben wird, aus der Serie. Das Ausschnitt-Objekt wird dabei nicht gelöscht.
Hinweis: Die Serie bleibt das übergeordnete Objekt des Ausschnitts. Sie müssen das übergeordnete Objekt festlegen, um die vollständige Eigentümerschaft zu übernehmen.
Gibt ` true ` zurück, wenn der `take`-Vorgang erfolgreich war.
[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QAbstractSeries::type “ neu.
Gibt den Typ der Reihe zurück.
QPieSeries &QPieSeries::operator<<(QPieSlice *slice)
Fügt den durch „ slice “ angegebenen Ausschnitt an die Reihe an und gibt eine Referenz auf die Reihe zurück. Die Eigentumsrechte an dem Ausschnitt werden an die Reihe übertragen.
© 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.