QPieSlice Class
Die Klasse „QPieSlice“ stellt ein einzelnes Segment in einer Kreisdiagrammreihe dar. Mehr...
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal } |
Eigenschaften
|
|
Öffentliche Funktionen
| QPieSlice(QObject *parent = nullptr) | |
| QPieSlice(QString label, qreal value, QObject *parent = nullptr) | |
| virtual | ~QPieSlice() |
| qreal | angleSpan() const |
| QColor | borderColor() |
| int | borderWidth() |
| QBrush | brush() const |
| QColor | color() |
| qreal | explodeDistanceFactor() const |
| bool | isExploded() const |
| bool | isLabelVisible() const |
| QString | label() const |
| qreal | labelArmLengthFactor() const |
| QBrush | labelBrush() const |
| QColor | labelColor() |
| QFont | labelFont() const |
| QPieSlice::LabelPosition | labelPosition() |
| QPen | pen() const |
| qreal | percentage() const |
| QPieSeries * | series() const |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(int width) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setExplodeDistanceFactor(qreal factor) |
| void | setExploded(bool exploded = true) |
| void | setLabel(QString label) |
| void | setLabelArmLengthFactor(qreal factor) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setLabelFont(const QFont &font) |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
| void | setLabelVisible(bool visible = true) |
| void | setPen(const QPen &pen) |
| void | setValue(qreal value) |
| qreal | startAngle() const |
| qreal | value() const |
Signale
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | brushChanged() |
| void | clicked() |
| void | colorChanged() |
| void | doubleClicked() |
| void | hovered(bool state) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelVisibleChanged() |
| void | penChanged() |
| void | percentageChanged() |
| void | pressed() |
| void | released() |
| void | startAngleChanged() |
| void | valueChanged() |
Ausführliche Beschreibung
Ein Kreisdiagrammsegment verfügt über einen Wert und eine Beschriftung. Wenn das Segment zu einer Kreisdiagrammreihe hinzugefügt wird, berechnet das Objekt „ QPieSeries “ den prozentualen Anteil des Segments im Vergleich zur Summe aller Segmente der Reihe, um die tatsächliche Größe des Segments im Diagramm zu bestimmen.
Standardmäßig ist die Beschriftung ausgeblendet. Ist sie sichtbar, kann sie entweder außerhalb des Segments liegen und über einen Arm mit diesem verbunden sein oder innerhalb des Segments zentriert werden – entweder horizontal oder parallel zur Tangente oder Normalen des Segmentsbogens.
Standardmäßig wird das Erscheinungsbild des Segments durch ein Design festgelegt, das jedoch durch die Angabe von Segment-Eigenschaften überschrieben werden kann. Wird das Design jedoch geändert, nachdem die Segmente angepasst wurden, gehen alle Anpassungen verloren.
Um die Benutzerinteraktion mit dem Kreisdiagramm zu ermöglichen, werden einige grundlegende Signale ausgegeben, wenn Benutzer auf Kreissegmente klicken oder mit der Maus darüber fahren.
Siehe auch „ QPieSeries “.
Dokumentation zu Mitgliedstypen
enum QPieSlice::LabelPosition
Diese Enumeration beschreibt die Position der Slice-Bezeichnung.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPieSlice::LabelOutside | 0 | Die Beschriftung befindet sich außerhalb des Schnitts und ist über einen Arm mit diesem verbunden. Dies ist der Standardwert. |
QPieSlice::LabelInsideHorizontal | 1 | Die Beschriftung ist innerhalb des Segments zentriert und horizontal angeordnet. |
QPieSlice::LabelInsideTangential | 2 | Die Beschriftung ist innerhalb des Schnitts zentriert und so gedreht, dass sie parallel zur Tangente des Schnittbogens verläuft. |
QPieSlice::LabelInsideNormal | 3 | Die Beschriftung ist innerhalb des Schnitts zentriert und so gedreht, dass sie parallel zur Normalen des Bogenabschnitts verläuft. |
Dokumentation zu den Eigenschaften
[read-only] angleSpan : qreal
Diese Eigenschaft gibt den Winkelbereich des Segments in Grad an. Ein vollständiger Kreis umfasst 360 Grad, wobei 0 Grad der 12-Uhr-Position entspricht. Wird automatisch aktualisiert, sobald das Segment zur Reihe hinzugefügt wird.
Zugriffsfunktionen:
| qreal | angleSpan() const |
Benachrichtigungssignal:
| void | angleSpanChanged() |
borderColor : QColor
Diese Eigenschaft enthält die Farbe, die zum Zeichnen des Scheibchenrandes verwendet wird. Dies ist eine Komfort-Eigenschaft zum Ändern der Scheibchenfarbe.
Zugriffsfunktionen:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Benachrichtigungssignal:
| void | borderColorChanged() |
Siehe auch pen und borderWidth.
borderWidth : int
Diese Eigenschaft gibt die Breite des Slice-Rahmens an. Es handelt sich hierbei um eine Komfort-Eigenschaft zum Anpassen des Slice-Stifts.
Zugriffsfunktionen:
| int | borderWidth() |
| void | setBorderWidth(int width) |
Benachrichtigungssignal:
| void | borderWidthChanged() |
Siehe auch pen und borderColor.
brush : QBrush
Diese Eigenschaft enthält den Pinsel, der zum Ausfüllen des Ausschnitts verwendet wird.
Zugriffsfunktionen:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
Notifier-Signal:
| void | brushChanged() |
color : QColor
Diese Eigenschaft enthält die Füllfarbe (Pinselfarbe) des Ausschnitts. Es handelt sich hierbei um eine Komfort-Eigenschaft zum Anpassen des Ausschnittpinsels.
Zugriffsfunktionen:
| QColor | color() |
| void | setColor(QColor color) |
Benachrichtigungssignal:
| void | colorChanged() |
Siehe auch „ brush “.
explodeDistanceFactor : qreal
Legt fest, wie weit das Stück vom Kreis entfernt dargestellt wird.
- 1,0 bedeutet, dass der Abstand dem Radius entspricht.
- 0,5 bedeutet, dass der Abstand der Hälfte des Radius entspricht.
Standardmäßig beträgt der Abstand 0,15
Zugriffsfunktionen:
| qreal | explodeDistanceFactor() const |
| void | setExplodeDistanceFactor(qreal factor) |
Siehe auch exploded.
exploded : bool
Diese Eigenschaft gibt an, ob das Stück vom Kuchen getrennt ist.
Zugriffsfunktionen:
| bool | isExploded() const |
| void | setExploded(bool exploded = true) |
Siehe auch „ explodeDistanceFactor “.
label : QString
Diese Eigenschaft enthält die Bezeichnung des Ausschnitts.
Hinweis: Die Zeichenkette kann HTML-formatiert sein.
Zugriffsfunktionen:
| QString | label() const |
| void | setLabel(QString label) |
Benachrichtigungssignal:
| void | labelChanged() |
Siehe auch labelVisible, labelBrush, labelFont und labelArmLengthFactor.
labelArmLengthFactor : qreal
Diese Eigenschaft gibt die Länge des Beschriftungsarms an. Der Faktor bezieht sich auf den Radius des Kreisdiagramms. Beispiel:
- 1,0 bedeutet, dass die Länge dem Radius entspricht.
- 0,5 bedeutet, dass die Länge halb so groß ist wie der Radius.
Standardmäßig beträgt die Länge des Etikettenarms 0,15
Zugriffsfunktionen:
| qreal | labelArmLengthFactor() const |
| void | setLabelArmLengthFactor(qreal factor) |
Siehe auch label, labelVisible, labelBrush und labelFont.
labelBrush : QBrush
Diese Eigenschaft enthält den Pinsel, der zum Zeichnen der Beschriftung und des Beschriftungsarms des Schnitts verwendet wird.
Zugriffsfunktionen:
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
Benachrichtigungssignal:
| void | labelBrushChanged() |
Siehe auch „ label“ , „ labelVisible “, „ labelFont “ und „ labelArmLengthFactor “.
labelColor : QColor
Diese Eigenschaft enthält die Farbe, die zum Zeichnen der Scheibenbeschriftung verwendet wird. Es handelt sich hierbei um eine Komfort-Eigenschaft zum Anpassen des Pinsels für die Scheibenbeschriftung.
Zugriffsfunktionen:
| QColor | labelColor() |
| void | setLabelColor(QColor color) |
Benachrichtigungssignal:
| void | labelColorChanged() |
Siehe auch „ labelBrush “.
labelFont : QFont
Diese Eigenschaft enthält die Schriftart, die zum Zeichnen des Beschriftungstextes verwendet wird.
Zugriffsfunktionen:
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
Benachrichtigungssignal:
| void | labelFontChanged() |
Siehe auch „ label “, „ labelVisible “ und „ labelArmLengthFactor “.
labelPosition : LabelPosition
Diese Eigenschaft gibt die Position der Slice-Beschriftung an.
Zugriffsfunktionen:
| QPieSlice::LabelPosition | labelPosition() |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
Siehe auch label und labelVisible.
labelVisible : bool
Diese Eigenschaft legt die Sichtbarkeit der Schnittbezeichnung fest. Standardmäßig ist die Bezeichnung nicht sichtbar.
Zugriffsfunktionen:
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
Benachrichtigungssignal:
| void | labelVisibleChanged() |
Siehe auch label, labelBrush, labelFont und labelArmLengthFactor.
pen : QPen
Diese Eigenschaft enthält den Stift, mit dem der Rand des Ausschnitts gezeichnet wurde.
Zugriffsfunktionen:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Benachrichtigungssignal:
| void | penChanged() |
[read-only] percentage : qreal
Diese Eigenschaft gibt den prozentualen Anteil des Segments im Verhältnis zur Summe aller Segmente der Reihe an. Der tatsächliche Wert liegt zwischen 0,0 und 1,0. Wird automatisch aktualisiert, sobald das Segment zur Reihe hinzugefügt wird.
Zugriffsfunktionen:
| qreal | percentage() const |
Benachrichtigungssignal:
| void | percentageChanged() |
Siehe auch value und QPieSeries::sum.
[read-only] startAngle : qreal
Diese Eigenschaft enthält den Startwinkel dieses Segments in der Serie, zu der es gehört. Ein vollständiger Kreis umfasst 360 Grad, wobei 0 Grad der 12-Uhr-Position entspricht. Wird automatisch aktualisiert, sobald das Segment zur Serie hinzugefügt wird.
Zugriffsfunktionen:
| qreal | startAngle() const |
Benachrichtigungssignal:
| void | startAngleChanged() |
value : qreal
Diese Eigenschaft enthält den Wert des Ausschnitts.
Hinweis: Ein negativer Wert wird in einen positiven Wert umgewandelt.
Zugriffsfunktionen:
| qreal | value() const |
| void | setValue(qreal value) |
Benachrichtigungssignal:
| void | valueChanged() |
Siehe auch „ percentage()“ und „ QPieSeries::sum()“.
Dokumentation zu den Member-Funktionen
[explicit] QPieSlice::QPieSlice(QObject *parent = nullptr)
Erstellt einen leeren Ausschnitt mit der übergeordneten parent.
Siehe auch „ QPieSeries::append()“ und „ QPieSeries::insert()“.
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)
Erstellt einen leeren Ausschnitt mit den angegebenen Werten für „ value “, „ label “ und „ parent “.
Siehe auch QPieSeries::append() und QPieSeries::insert().
[virtual noexcept] QPieSlice::~QPieSlice()
Entfernt den Ausschnitt. Der Ausschnitt sollte nicht entfernt werden, wenn er einer Serie hinzugefügt wurde.
[signal] void QPieSlice::angleSpanChanged()
Dieses Signal wird ausgegeben, wenn sich der Winkelbereich der Schicht ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ angleSpan “.
Siehe auch „ angleSpan “.
[signal] void QPieSlice::borderColorChanged()
Dieses Signal wird ausgelöst, wenn sich die Farbe der Slice-Grenze ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ borderColor “.
Siehe auch „ pen “ und „ borderColor “.
[signal] void QPieSlice::borderWidthChanged()
Dieses Signal wird ausgegeben, wenn sich die Breite der Slice-Grenze ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ borderWidth “.
Siehe auch „ pen “ und „ borderWidth “.
[signal] void QPieSlice::brushChanged()
Dieses Signal wird ausgegeben, wenn sich der Pinsel ändert, der zum Ausfüllen des Schnitts verwendet wird.
Hinweis: Notifier -Signal für die Eigenschaft „ brush “.
Siehe auch „ brush “.
[signal] void QPieSlice::clicked()
Dieses Signal wird ausgelöst, wenn auf die Scheibe geklickt wird.
Siehe auch „ QPieSeries::clicked()“.
[signal] void QPieSlice::colorChanged()
Dieses Signal wird ausgegeben, wenn sich die Farbe des Schnitts ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ color “.
Siehe auch „ brush “.
[signal] void QPieSlice::doubleClicked()
Dieses Signal wird ausgelöst, wenn der Benutzer auf den Ausschnitt doppelklickt.
Siehe auch „ QPieSeries::doubleClicked()“.
[signal] void QPieSlice::hovered(bool state)
Dieses Signal wird ausgelöst, wenn der Mauszeiger über den Ausschnitt bewegt wird. Wenn die Maus über den Ausschnitt bewegt wird, wechselt „ state “ zu „ true “, und wenn die Maus wieder wegbewegt wird, wechselt es zu „ false “.
Siehe auch QPieSeries::hovered().
[signal] void QPieSlice::labelBrushChanged()
Dieses Signal wird ausgelöst, wenn sich der Beschriftungspinsel des Schnitts ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelBrush “.
Siehe auch „ labelBrush “.
[signal] void QPieSlice::labelChanged()
Dieses Signal wird ausgegeben, wenn sich die Slice-Bezeichnung ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ label “.
Siehe auch „ label “.
[signal] void QPieSlice::labelColorChanged()
Dieses Signal wird ausgelöst, wenn sich die Farbe der Schnittbezeichnung ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelColor “.
Siehe auch „ labelColor “.
[signal] void QPieSlice::labelFontChanged()
Dieses Signal wird ausgelöst, wenn sich die Schriftart der Beschriftung des Schnitts ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelFont “.
Siehe auch „ labelFont “.
[signal] void QPieSlice::labelVisibleChanged()
Dieses Signal wird ausgelöst, wenn sich die Sichtbarkeit der Schnittbezeichnung ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ labelVisible “.
Siehe auch „ labelVisible “.
[signal] void QPieSlice::penChanged()
Dieses Signal wird ausgelöst, wenn sich der Stift ändert, mit dem der Rand des Ausschnitts gezeichnet wird.
Hinweis: Notifier -Signal für die Eigenschaft „ pen “.
Siehe auch „ pen “.
[signal] void QPieSlice::percentageChanged()
Dieses Signal wird ausgegeben, wenn sich der Prozentsatz des Segments ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ percentage “.
Siehe auch „ percentage “.
[signal] void QPieSlice::pressed()
Dieses Signal wird ausgelöst, wenn der Benutzer auf den Ausschnitt klickt und die Maustaste gedrückt hält.
Siehe auch „ QPieSeries::pressed()“.
[signal] void QPieSlice::released()
Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem Ausschnitt aufhebt.
Siehe auch „ QPieSeries::released()“.
QPieSeries *QPieSlice::series() const
Gibt die Reihe zurück, zu der dieser Ausschnitt gehört.
Siehe auch „ QPieSeries::append()“.
[signal] void QPieSlice::startAngleChanged()
Dieses Signal wird ausgegeben, wenn sich der Startwinkel der Schicht ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ startAngle “.
Siehe auch „ startAngle “.
[signal] void QPieSlice::valueChanged()
Dieses Signal wird ausgegeben, wenn sich der Slice-Wert ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ value “.
Siehe auch „ value “.
© 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.
