QPieSeries Class

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

Kopfzeile: #include <QPieSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: PieSeries
Vererbt: QAbstractSeries

Eigenschaften

Öffentliche Funktionen

QPieSeries(QObject *parent = nullptr)
bool append(QPieSlice *slice)
bool append(const QList<QPieSlice *> &slices)
QPieSlice *append(const QString &label, qreal value)
QPieSlice *at(qsizetype index)
void clear()
qsizetype count() const
qreal endAngle() const
QPieSlice *find(const QString &label)
qreal holeSize() const
qreal horizontalPosition() const
bool insert(qsizetype index, QPieSlice *slice)
bool isEmpty() const
qreal pieSize() const
bool remove(QPieSlice *slice)
bool remove(qsizetype index)
void removeMultiple(qsizetype index, int count)
bool replace(const QList<QPieSlice *> &slices)
bool replace(QPieSlice *oldSlice, QPieSlice *newSlice)
bool replace(qsizetype index, QPieSlice *slice)
void setEndAngle(qreal angle)
void setHoleSize(qreal holeSize)
void setHorizontalPosition(qreal relativePosition)
void setLabelsPosition(QPieSlice::LabelPosition position)
void setLabelsVisible(bool visible)
void setPieSize(qreal relativeSize)
void setStartAngle(qreal angle)
void setVerticalPosition(qreal relativePosition)
QList<QPieSlice *> slices() const
qreal startAngle() 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 countChanged()
void endAngleChanged()
void holeSizeChanged()
void horizontalPositionChanged()
void pieSizeChanged()
void removed(const QList<QPieSlice *> &slices)
void startAngleChanged()
void sumChanged()
void verticalPositionChanged()

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 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. Eine vollständige Torte umfasst 360 Grad, wobei 0 auf 12 Uhr steht.

Siehe auch QPieSlice.

Dokumentation der Eigenschaft

[read-only] count : const qsizetype

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

Zugriffsfunktionen:

qsizetype 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 endAngle() const
void setEndAngle(qreal angle)

Melder-Signal:

void endAngleChanged()

holeSize : qreal

Diese Eigenschaft enthält 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 ist als die Kuchengröße.

Der Standardwert ist 0.0.

Zugriffsfunktionen:

qreal holeSize() const
void setHoleSize(qreal holeSize)

Benachrichtigungssignal:

void holeSizeChanged()

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)

Benachrichtigungssignal:

void horizontalPositionChanged()

Siehe auch verticalPosition.

pieSize : qreal

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

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.

Zugriffsfunktionen:

qreal pieSize() const
void setPieSize(qreal relativeSize)

Benachrichtigungssignal:

void pieSizeChanged()

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 startAngle() const
void setStartAngle(qreal angle)

Melder-Signal:

void startAngleChanged()

[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 das absolute Ende.

Der Standardwert ist 0,5 (Mitte).

Zugriffsfunktionen:

qreal verticalPosition() const
void setVerticalPosition(qreal relativePosition)

Benachrichtigungssignal:

void verticalPositionChanged()

Siehe auch horizontalPosition.

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Serienobjekt, das ein Kind von parent ist.

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

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

Siehe auch append().

[invokable] 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] QPieSlice *QPieSeries::at(qsizetype index)

Liefert den PieSlice an der Position index. Gibt null zurück, wenn kein PieSlice gefunden wurde.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QPieSeries::clear()

Löscht alle Slices aus der Serie.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

qsizetype QPieSeries::count() const

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

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

qreal QPieSeries::endAngle() const

Gibt den Endwinkel der Torte zurück.

Eine vollständige Torte hat 360 Grad, wobei 0 Grad bei 12 Uhr liegt.

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

Siehe auch setEndAngle(), startAngle(), und setStartAngle().

[invokable] QPieSlice *QPieSeries::find(const QString &label)

Sucht nach einem PieSlice, das die Bezeichnung label enthält. Gibt das PieSlice zurück, wenn es gefunden wurde, ansonsten null.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QPieSeries::insert(qsizetype 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

bool QPieSeries::isEmpty() const

Gibt true zurück, wenn die Reihe leer ist.

[invokable] 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QPieSeries::remove(qsizetype index)

Entfernt die Datei PieSlice an der Stelle index. Die Datei PieSlice wird dauerhaft gelöscht. Gibt true zurück, wenn das Entfernen erfolgreich war.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QPieSeries::removeMultiple(qsizetype index, int count)

Entfernt mehrere PieSlices aus der Serie beginnend mit index bis zu einer Anzahl von count. Die PieSlices werden dauerhaft gelöscht.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

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

[invokable] bool QPieSeries::replace(const QList<QPieSlice *> &slices)

Ersetzt die gesamte Liste der PieSlices in der Serie mit der durch slices angegebenen Liste. Alle ursprünglichen PieSlices werden dauerhaft gelöscht. Gibt true zurück, wenn alle PieSlices erfolgreich ersetzt wurden.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QPieSeries::replace(QPieSlice *oldSlice, QPieSlice *newSlice)

Ersetzt PieSlice oldSlice durch newSlice, falls in der Serie gefunden.oldSlice wird dauerhaft gelöscht. Gibt true zurück, wenn das Ersetzen erfolgreich war.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] bool QPieSeries::replace(qsizetype index, QPieSlice *slice)

Ersetzt das PieSlice an der Position index durch das durch slice angegebene. Das ursprüngliche PieSlice wird dauerhaft gelöscht. Gibt false zurück, wenn das Ersetzen eines der PieSlices fehlschlägt.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

void QPieSeries::setEndAngle(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 endAngle(), startAngle(), und setStartAngle().

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 des Labels QPieSlice::LabelOutside.

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

void QPieSeries::setLabelsVisible(bool visible)

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::setStartAngle(qreal angle)

Legt den Startwinkel des Kreises fest.

Ein voller Kreis ist 360 Grad, wobei 0 Grad auf 12 Uhr steht.

angle muss kleiner als der Endwinkel sein.

Hinweis: Setter-Funktion für die Eigenschaft startAngle.

Siehe auch startAngle(), endAngle(), und setEndAngle().

QList<QPieSlice *> QPieSeries::slices() const

Gibt eine Liste der Slices zurück, die zu dieser Serie gehören.

qreal QPieSeries::startAngle() const

Gibt den Startwinkel der Torte zurück.

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

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

Siehe auch setStartAngle(), endAngle(), und setEndAngle().

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

[invokable] 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.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

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