QPieSeries Class

Die Klasse QPieSeries stellt Daten in Kreisdiagrammen dar. Mehr...

Header: #include <QPieSeries>
In QML: PieSeries
Inherits: QAbstractSeries

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)

Reimplementierte ö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()

Detaillierte Beschreibung

Eine Kuchenserie besteht aus Slices, die als QPieSlice Objekte definiert sind. Die Slices können beliebige Werte haben, da das QPieSeries-Objekt 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.

Die Größe und Position des Kuchens im Diagramm wird durch die Verwendung von relativen Werten zwischen 0,0 und 1,0 gesteuert. Diese beziehen sich auf das tatsächliche Diagrammrechteck.

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

In der Galerie Diagramme mit Widgets erfahren Sie, wie Sie QPieSeries verwenden können.

Siehe auch QPieSlice und QChart.

Dokumentation der Eigenschaft

[read-only] count : const int

Diese Eigenschaft enthält die Anzahl der Slices in der Serie.

Zugriffsfunktionen:

int count() const

Melder-Signal:

void countChanged()

endAngle : qreal

Diese Eigenschaft gibt den Endwinkel der Torte an.

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

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 ist relativ zum Diagrammrechteck, so dass:

  • 0.0 ist die Mindestgröße (der gesamte Kuchen wird ohne Loch gezeichnet).
  • 1.0 ist die maximale Größe, die in das Diagramm passen kann (der Donut hat keine Breite).

Beim Einstellen dieser Eigenschaft wird die Eigenschaft size gegebenenfalls angepasst, um sicherzustellen, dass die Größe des Lochs nicht größer als die Größe des Kreises ist.

Der Standardwert ist 0.0.

Zugriffsfunktionen:

qreal holeSize() const
void setHoleSize(qreal holeSize)

horizontalPosition : qreal

Diese Eigenschaft gibt die horizontale Position des Kreises an.

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

Zugriffsfunktionen:

qreal horizontalPosition() const
void setHorizontalPosition(qreal relativePosition)

Siehe auch verticalPosition.

size : qreal

Diese Eigenschaft gibt die Größe des Kreises an.

Der Wert ist relativ zum Diagrammrechteck, so dass:

  • 0.0 ist die Mindestgröße (Kuchen wird nicht gezeichnet).
  • 1.0 ist die maximale Größe, die in das Diagramm passen kann.

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.

Zugriffsfunktionen:

qreal pieSize() const
void setPieSize(qreal relativeSize)

startAngle : qreal

Diese Eigenschaft gibt den Anfangswinkel der Torte an.

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

Der Standardwert ist 0.

Zugriffsfunktionen:

qreal pieStartAngle() const
void setPieStartAngle(qreal startAngle)

[read-only] sum : const qreal

Diese Eigenschaft enthält die Summe aller Slices.

Die Serie behält die Summe aller Slices, die sie enthält, im Auge.

Zugriffsfunktionen:

qreal sum() const

Benachrichtigungssignal:

void sumChanged()

verticalPosition : qreal

Diese Eigenschaft gibt die vertikale Position des Kreises an.

Der Wert ist relativ zum Diagrammrechteck, so dass:

  • 0.0 ist der absolute obere Rand.
  • 1.0 ist der absolute Boden.

Der Standardwert ist 0,5 (Mitte).

Zugriffsfunktionen:

qreal verticalPosition() const
void setVerticalPosition(qreal relativePosition)

Siehe auch horizontalPosition.

Dokumentation der Mitgliedsfunktionen

[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)

Konstruiert ein Serienobjekt, das ein Kind von parent ist.

[virtual noexcept] QPieSeries::~QPieSeries()

Entfernt die Tortenreihe und ihre Scheiben.

[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)

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

Siehe auch append() und insert().

bool QPieSeries::append(QPieSlice *slice)

Fügt den durch slice angegebenen Slice an die Serie an. Der Besitz des Slice wird an die Serie übergeben.

Gibt true zurück, wenn das Anhängen erfolgreich war.

bool QPieSeries::append(const QList<QPieSlice *> &slices)

Hängt das durch slices angegebene Array von Slices an die Serie an. Das Eigentum an den Slices wird an die Serie übergeben.

Gibt true zurück, wenn das Anhängen erfolgreich war.

QPieSlice *QPieSeries::append(const QString &label, qreal value)

Fügt ein einzelnes Slice mit dem angegebenen value und label an die Serie an. Der Besitz des Slice wird an die Serie übergeben. Gibt null zurück, wenn value NaN , Inf oder -Inf ist und fügt der Serie nichts hinzu.

void QPieSeries::clear()

Löscht alle Slices aus der Serie.

[signal] void QPieSeries::clicked(QPieSlice *slice)

Dieses Signal wird ausgegeben, wenn der durch slice angegebene Slice angeklickt wird.

Siehe auch QPieSlice::clicked().

int QPieSeries::count() const

Gibt die Anzahl der Slices in dieser Serie zurück.

Hinweis: Getter-Funktion für die Eigenschaft count.

[signal] void QPieSeries::countChanged()

Dieses Signal wird ausgegeben, wenn sich die Slice-Anzahl ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft count.

Siehe auch count.

[signal] void QPieSeries::doubleClicked(QPieSlice *slice)

Dieses Signal wird ausgegeben, wenn ein Doppelklick auf den durch slice angegebenen Slice erfolgt.

Siehe auch QPieSlice::doubleClicked().

[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über das durch slice angegebene Slice bewegt wird. Wenn sich die Maus über den Bereich bewegt, wird state zu true, und wenn sich die Maus wieder wegbewegt, wird sie zu false.

Siehe auch QPieSlice::hovered().

bool QPieSeries::insert(int index, QPieSlice *slice)

Fügt das durch slice angegebene Slice in die Reihe vor dem Slice an der durch index angegebenen Position ein. Der Besitz des Teilstücks wird an die Serie ü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 der Torte zurück.

Eine volle Torte hat 360 Grad, wobei 0 Grad auf 12 Uhr steht.

Hinweis: Getter-Funktion für die Eigenschaft endAngle.

Siehe auch setPieEndAngle(), pieStartAngle(), und setPieStartAngle().

[signal] void QPieSeries::pressed(QPieSlice *slice)

Dieses Signal wird ausgegeben, wenn der Benutzer auf das durch slice angegebene Slice klickt und die Maustaste gedrückt hält.

Siehe auch QPieSlice::pressed().

[signal] void QPieSeries::released(QPieSlice *slice)

Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem durch slice angegebenen Slice loslässt.

Siehe auch QPieSlice::released().

bool QPieSeries::remove(QPieSlice *slice)

Entfernt ein einzelnes Slice, angegeben durch slice, aus der Serie und löscht es dauerhaft.

Der Zeiger kann nach diesem Aufruf nicht mehr referenziert 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 Slices aus der Serie entfernt werden.

Siehe auch remove().

void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)

Setzt die Position aller Slices-Beschriftungen auf position.

Hinweis: Diese Funktion wirkt sich nur auf die aktuellen Slices in der Serie aus. Wenn ein neues Slice hinzugefügt wird, ist die Standardposition der Beschriftung QPieSlice::LabelOutside.

Siehe auch QPieSlice::labelPosition() und QPieSlice::setLabelPosition().

void QPieSeries::setLabelsVisible(bool visible = true)

Setzt die Sichtbarkeit aller Slice-Beschriftungen auf visible.

Hinweis: Diese Funktion wirkt sich nur auf die aktuellen Slices in der Serie aus. Wenn ein neues Slice hinzugefügt wird, ist die Standardsichtbarkeit der Beschriftung false.

Siehe auch QPieSlice::isLabelVisible() und QPieSlice::setLabelVisible().

void QPieSeries::setPieEndAngle(qreal angle)

Legt den Endwinkel des Kreises fest.

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

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 Slices zurück, die zu dieser Serie gehören.

qreal QPieSeries::sum() const

Gibt die Summe aller Slice-Werte in dieser Serie 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 ausgesendet, wenn sich die Summe aller Slices ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft sum.

Siehe auch sum.

bool QPieSeries::take(QPieSlice *slice)

Entnimmt ein einzelnes Slice, angegeben durch slice, aus der Serie. Das Objekt "slice" wird nicht gelöscht.

Hinweis: Die Serie bleibt das übergeordnete Objekt des Slice. Sie müssen das übergeordnete Objekt setzen, um den vollen Besitz zu übernehmen.

Gibt true zurück, wenn der Take-Vorgang erfolgreich war.

[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QAbstractSeries::type.

Gibt den Typ der Reihe zurück.

QPieSeries &QPieSeries::operator<<(QPieSlice *slice)

Hängt das durch slice angegebene Slice an die Serie an und gibt einen Verweis auf die Serie zurück. Das Eigentum an der Scheibe wird an die Serie übergeben.

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