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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QPieSeries ist Teil von Qt Graphs C++ Classes for 2D.
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.