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.