PieSlice QML Type
Stellt eine einzelne Scheibe in einer Tortenreihe dar. Mehr...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QPieSlice |
Eigenschaften
- angleSpan : real
- borderColor : color
- borderWidth : int
- brushFilename : string
- color : color
- explodeDistanceFactor : real
- exploded : bool
- label : string
- labelArmLengthFactor : real
- labelColor : color
- labelFont : font
- labelPosition : enumeration
- labelVisible : bool
- percentage : real
- startAngle : real
- value : real
Signale
- clicked()
- doubleClicked()
- hovered(bool state)
- pressed()
- released()
Detaillierte Beschreibung
Ein Tortenstück hat einen Wert und eine Beschriftung. Wenn die Scheibe zu einer Kuchenserie hinzugefügt wird, berechnet der Typ PieSeries den Prozentsatz der Scheibe im Vergleich zur Summe aller Scheiben in der Serie, um die tatsächliche Größe der Scheibe 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.
Der Typ PieSlice sollte als untergeordneter Typ eines PieSeries Typs verwendet werden. Ein Beispiel:
Alternativ können Slices zu einer Tortenreihe hinzugefügt werden, indem die Methode PieSeries.append() verwendet wird.
In diesem Fall kann PieSeries.at() oder PieSeries.find verwendet werden, um auf die Eigenschaften einer einzelnen PieSlice-Instanz zuzugreifen.
Siehe auch PieSeries.
Dokumentation der Eigenschaften
angleSpan : real [read-only]
Die Spannweite der Scheibe in Grad. Ein voller Kuchen hat 360 Grad, wobei 0 Grad bei 12 Uhr liegt. Wird automatisch aktualisiert, sobald die Scheibe zur Serie hinzugefügt wird.
borderColor : color
Die Farbe, mit der der Rand des Slice gezeichnet wird (Stiftfarbe).
Siehe auch borderWidth.
borderWidth : int
Die Breite des Slice-Rahmens. Dies ist eine bequeme Eigenschaft zum Ändern des Slice-Stifts.
Siehe auch borderColor.
brushFilename : string
Der Name der Datei, die als Pinsel für den Slice verwendet wird.
color : color
Die Füllfarbe (Pinsel) des Slice.
explodeDistanceFactor : real
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.
Siehe auch exploded.
exploded : bool
Ob das Stück vom Kuchen getrennt ist.
Siehe auch explodeDistanceFactor.
label : string
Die Bezeichnung des Slice.
Hinweis: Die Zeichenfolge kann HTML-formatiert sein.
labelArmLengthFactor : real
Die Länge des Etikettenarms. Der Faktor bezieht sich auf den 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.
Siehe auch labelVisible.
labelColor : color
Die Farbe, die zum Zeichnen des Slice-Labels verwendet wird.
labelFont : font
Die für die Beschriftung des Slice verwendete Schriftart.
Für weitere Informationen siehe font.
Siehe auch labelVisible und labelPosition.
labelPosition : enumeration
Beschreibt die Position des Slice-Labels.
| Konstante | Beschreibung |
|---|---|
PieSlice.LabelOutside | Die Beschriftung befindet sich außerhalb des mit ihr durch einen Arm verbundenen Slice. Dies ist der Standardwert. |
PieSlice.LabelInsideHorizontal | Die Beschriftung ist innerhalb des Slice zentriert und horizontal angeordnet. |
PieSlice.LabelInsideTangential | Die Beschriftung wird innerhalb der Scheibe zentriert und parallel zur Tangente des Scheibenbogens gedreht. |
PieSlice.LabelInsideNormal | Die Beschriftung wird in der Scheibe zentriert und so gedreht, dass sie parallel zur Normalen des Scheibenbogens verläuft. |
Siehe auch labelVisible.
labelVisible : bool
Die Sichtbarkeit der Beschriftung des Slice. Standardmäßig ist die Beschriftung nicht sichtbar.
percentage : real [read-only]
Der Prozentsatz 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.
startAngle : real [read-only]
Der Startwinkel dieser Scheibe in der Serie, zu der sie gehört. Ein voller Kuchen hat 360 Grad, wobei 0 Grad auf 12 Uhr steht. Wird automatisch aktualisiert, sobald die Scheibe zur Serie hinzugefügt wird.
value : real
Der Wert des Slice.
Hinweis: Ein negativer Wert wird in einen positiven Wert umgewandelt.
Signal-Dokumentation
clicked()
Dieses Signal wird ausgegeben, wenn der Slice angeklickt wird.
Der entsprechende Signalhandler ist onClicked().
Hinweis: Der entsprechende Handler ist onClicked.
doubleClicked()
Dieses Signal wird ausgegeben, wenn der Benutzer einen Doppelklick auf das Slice ausführt.
Der entsprechende Signalhandler ist onDoubleClicked().
Hinweis: Der entsprechende Handler ist onDoubleClicked.
hovered(bool state)
Dieses Signal wird ausgegeben, wenn der Mauszeiger über die Scheibe bewegt wird. Wenn sich die Maus über die Scheibe bewegt, wird state zu true, und wenn sich die Maus wieder wegbewegt, wird sie zu false.
Der entsprechende Signalhandler ist onHovered().
Hinweis: Der entsprechende Handler ist onHovered.
pressed()
Dieses Signal wird ausgegeben, wenn der Benutzer auf das Slice klickt und die Maustaste gedrückt hält.
Der entsprechende Signalhandler ist onPressed().
Hinweis: Der entsprechende Handler ist onPressed.
released()
Dieses Signal wird ausgegeben, wenn der Benutzer die Maustaste auf dem Slice loslässt.
Der entsprechende Signalhandler ist onReleased().
Hinweis: Der entsprechende Handler ist onReleased.
© 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.