QPieSlice Class
Die Klasse QPieSlice repräsentiert eine einzelne Scheibe in einer Tortenreihe. Mehr...
Ö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() |
Detaillierte Beschreibung
Ein Tortenstück hat einen Wert und eine Beschriftung. Wenn das Slice zu einer Kuchenserie hinzugefügt wird, berechnet das QPieSeries Objekt den Prozentsatz des Slice im Vergleich zur Summe aller Slices in der Serie, um die tatsächliche Größe des Slice im Diagramm zu bestimmen.
Standardmäßig ist die Beschriftung ausgeblendet. Wenn es sichtbar ist, kann es sich entweder außerhalb des Slice befinden und mit diesem durch einen Arm verbunden sein oder innerhalb des Slice entweder horizontal oder parallel zur Tangente oder Normalen des Slice-Bogens zentriert sein.
Standardmäßig wird das visuelle Erscheinungsbild der Scheibe durch ein Thema festgelegt, aber das Thema kann durch Angabe von Scheibeneigenschaften außer Kraft gesetzt werden. Wenn das Thema jedoch geändert wird, nachdem die Slices angepasst wurden, gehen alle Anpassungen verloren.
Um die Interaktion des Benutzers mit dem Kreisdiagramm zu ermöglichen, werden einige grundlegende Signale ausgegeben, wenn der Benutzer auf Kreisscheiben klickt oder mit der Maus über sie fährt.
Siehe auch QPieSeries.
Member-Typ-Dokumentation
enum QPieSlice::LabelPosition
Diese Aufzählung beschreibt die Position des Slice-Labels.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPieSlice::LabelOutside | 0 | Die Beschriftung befindet sich außerhalb der Scheibe, mit der sie über einen Arm verbunden ist. Dies ist der Standardwert. |
QPieSlice::LabelInsideHorizontal | 1 | Die Beschriftung ist innerhalb des Slice zentriert und horizontal angeordnet. |
QPieSlice::LabelInsideTangential | 2 | Die Beschriftung ist innerhalb des Slice zentriert und parallel zur Tangente des Slice-Bogens gedreht. |
QPieSlice::LabelInsideNormal | 3 | Die Beschriftung wird in der Scheibe zentriert und so gedreht, dass sie parallel zur Normalen des Scheibenbogens verläuft. |
Dokumentation der Eigenschaft
[read-only] angleSpan : const qreal
Diese Eigenschaft gibt die Spannweite des Stücks in Grad an. Ein voller Kuchen hat 360 Grad, wobei 0 Grad bei 12 Uhr liegt. Sie wird automatisch aktualisiert, sobald die Scheibe zur Serie hinzugefügt wird.
Zugriffsfunktionen:
| qreal | angleSpan() const |
Benachrichtigungssignal:
| void | angleSpanChanged() |
borderColor : QColor
Diese Eigenschaft enthält die Farbe, die zum Zeichnen des Slice-Rahmens verwendet wird. Dies ist eine bequeme Eigenschaft zum Ändern des Slice-Stifts.
Zugriffsfunktionen:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Benachrichtigungssignal:
| void | borderColorChanged() |
Siehe auch pen und borderWidth.
borderWidth : int
Diese Eigenschaft gibt die Breite des Scheibenrandes an. Dies ist eine bequeme Eigenschaft, um den Slice-Stift zu verändern.
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 Füllen des Slice verwendet wird.
Zugriffsfunktionen:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
Benachrichtigungssignal:
| void | brushChanged() |
color : QColor
Diese Eigenschaft enthält die Füllfarbe (Pinsel) des Slice. Dies ist eine bequeme Eigenschaft zum Ändern des Slice-Pinsels.
Zugriffsfunktionen:
| QColor | color() |
| void | setColor(QColor color) |
Benachrichtigungssignal:
| void | colorChanged() |
Siehe auch brush.
explodeDistanceFactor : qreal
Legt fest, wie weit die Scheibe vom Kuchen entfernt explodiert.
- 1,0 bedeutet, dass der Abstand gleich dem Radius ist.
- 0,5 bedeutet, dass der Abstand die Hälfte des Radius beträgt.
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 die Scheibe 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 Slice.
Hinweis: Die Zeichenfolge 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 bestimmt die Länge des Beschriftungsarms. Der Faktor ist relativ zum Tortenradius. Zum Beispiel:
- 1,0 bedeutet, dass die Länge gleich dem Radius ist.
- 0,5 bedeutet, dass die Länge die Hälfte des Radius beträgt.
Standardmäßig beträgt die Länge des Arms 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 Slice 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 des Slice-Labels verwendet wird. Dies ist eine bequeme Eigenschaft zum Ändern des Slice-Label-Pinsels.
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 Etikettentextes verwendet wird.
Zugriffsfunktionen:
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
Melder-Signal:
| void | labelFontChanged() |
Siehe auch label, labelVisible, und labelArmLengthFactor.
labelPosition : LabelPosition
Diese Eigenschaft enthält die Position des Slice-Labels.
Zugriffsfunktionen:
| QPieSlice::LabelPosition | labelPosition() |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
Siehe auch label und labelVisible.
labelVisible : bool
Diese Eigenschaft bestimmt die Sichtbarkeit des Slice-Labels. Standardmäßig ist die Beschriftung 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, der zum Zeichnen des Slice-Randes verwendet wird.
Zugriffsfunktionen:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Benachrichtigungssignal:
| void | penChanged() |
[read-only] percentage : const qreal
Diese Eigenschaft enthält den prozentualen Anteil des Slices im Vergleich zur Summe aller Slices in der Serie. Der aktuelle Wert reicht von 0,0 bis 1,0. Wird automatisch aktualisiert, sobald das Slice zur Serie hinzugefügt wird.
Zugriffsfunktionen:
| qreal | percentage() const |
Melder-Signal:
| void | percentageChanged() |
Siehe auch value und QPieSeries::sum.
[read-only] startAngle : const qreal
Diese Eigenschaft enthält den Anfangswinkel dieser Scheibe in der Serie, zu der sie gehört. Ein voller Kuchen hat 360 Grad, wobei 0 Grad bei 12 Uhr liegt. Sie wird automatisch aktualisiert, sobald die Scheibe zur Serie hinzugefügt wird.
Zugriffsfunktionen:
| qreal | startAngle() const |
Melder-Signal:
| void | startAngleChanged() |
value : qreal
Diese Eigenschaft enthält den Wert des Slice.
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 der Mitgliedsfunktionen
[explicit] QPieSlice::QPieSlice(QObject *parent = nullptr)
Konstruiert ein leeres Slice mit dem übergeordneten parent.
Siehe auch QPieSeries::append() und QPieSeries::insert().
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)
Konstruiert ein leeres Slice mit den angegebenen value, label und parent.
Siehe auch QPieSeries::append() und QPieSeries::insert().
[virtual noexcept] QPieSlice::~QPieSlice()
Entfernt das Slice. Das Slice sollte nicht entfernt werden, wenn es zu einer Serie hinzugefügt wurde.
[signal] void QPieSlice::angleSpanChanged()
Dieses Signal wird ausgegeben, wenn sich der Winkelbereich der Scheibe ändert.
Hinweis: Meldersignal für die Eigenschaft angleSpan.
Siehe auch angleSpan.
[signal] void QPieSlice::borderColorChanged()
Dieses Signal wird ausgegeben, wenn sich die Farbe des Slice-Rahmens ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft borderColor.
Siehe auch pen und borderColor.
[signal] void QPieSlice::borderWidthChanged()
Dieses Signal wird ausgegeben, wenn sich die Breite des Slice-Rahmens ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft borderWidth.
Siehe auch pen und borderWidth.
[signal] void QPieSlice::brushChanged()
Dieses Signal wird ausgegeben, wenn sich der zum Füllen des Slice verwendete Pinsel ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft brush.
Siehe auch brush.
[signal] void QPieSlice::clicked()
Dieses Signal wird ausgegeben, wenn der Slice angeklickt wird.
Siehe auch QPieSeries::clicked().
[signal] void QPieSlice::colorChanged()
Dieses Signal wird ausgegeben, wenn sich die Farbe des Slice ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft color.
Siehe auch brush.
[signal] void QPieSlice::doubleClicked()
Dieses Signal wird ausgegeben, wenn der Benutzer einen Doppelklick auf das Slice ausführt.
Siehe auch QPieSeries::doubleClicked().
[signal] void QPieSlice::hovered(bool state)
Dieses Signal wird ausgegeben, wenn der Mauszeiger über die Scheibe bewegt wird. Wenn die Maus über die Scheibe bewegt wird, verwandelt sich state in true, und wenn die Maus wieder wegbewegt wird, verwandelt sie sich in false.
Siehe auch QPieSeries::hovered().
[signal] void QPieSlice::labelBrushChanged()
Dieses Signal wird ausgegeben, wenn sich der Beschriftungspinsel des Slice ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft labelBrush.
Siehe auch labelBrush.
[signal] void QPieSlice::labelChanged()
Dieses Signal wird ausgegeben, wenn sich die Beschriftung des Slice ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft label.
Siehe auch label.
[signal] void QPieSlice::labelColorChanged()
Dieses Signal wird ausgegeben, wenn sich die Farbe des Slice-Labels ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft labelColor.
Siehe auch labelColor.
[signal] void QPieSlice::labelFontChanged()
Dieses Signal wird ausgegeben, wenn sich die Schriftart des Slice ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft labelFont.
Siehe auch labelFont.
[signal] void QPieSlice::labelVisibleChanged()
Dieses Signal wird ausgesendet, wenn sich die Sichtbarkeit des Slice-Labels ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft labelVisible.
Siehe auch labelVisible.
[signal] void QPieSlice::penChanged()
Dieses Signal wird ausgegeben, wenn sich der zum Zeichnen des Slice-Rahmens verwendete Stift ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft pen.
Siehe auch pen.
[signal] void QPieSlice::percentageChanged()
Dieses Signal wird ausgegeben, wenn sich der Prozentsatz des Slice ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft percentage.
Siehe auch percentage.
[signal] void QPieSlice::pressed()
Dieses Signal wird ausgegeben, wenn der Benutzer auf das Slice klickt und die Maustaste gedrückt hält.
Siehe auch QPieSeries::pressed().
[signal] void QPieSlice::released()
Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem Slice loslässt.
Siehe auch QPieSeries::released().
QPieSeries *QPieSlice::series() const
Gibt die Serie zurück, zu der dieses Slice gehört.
Siehe auch QPieSeries::append().
[signal] void QPieSlice::startAngleChanged()
Dieses Signal wird ausgegeben, wenn sich der Startwinkel des Slice ändert.
Hinweis: Meldesignal für die Eigenschaft startAngle.
Siehe auch startAngle.
[signal] void QPieSlice::valueChanged()
Dieses Signal wird ausgesendet, wenn sich der Wert des Slice ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft value.
Siehe auch value.
© 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.
