Back to Qt.io
Contact Us Blog Download Qt

PieSlice QML Type

Stellt eine einzelne Scheibe in einer Tortenreihe dar. Mehr...

Import Statement: import QtCharts 2.8
In C++: QPieSlice

Eigenschaften

Signale

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.

Eigenschaft Dokumentation

angleSpan : real [read-only]

Die Spannweite des Stücks in Grad. Ein voller Kuchen hat 360 Grad, wobei 0 Grad auf 12 Uhr steht. Wird automatisch aktualisiert, sobald das Slice zur Serie hinzugefügt wird.


borderColor : color

Die Farbe, mit der der Rand der Scheibe 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 das Slice verwendet wird.


color : color

Die Farbe der Füllung (Pinsel) des Slice.


explodeDistanceFactor : real

Legt fest, wie weit das Slice von der Torte entfernt explodiert wird.

  • 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 die Scheibe von der Torte getrennt wird.

Siehe auch explodeDistanceFactor.


label : string

Die Beschriftung des Scheibchens.

Hinweis: Die Zeichenfolge kann HTML-formatiert sein.


labelArmLengthFactor : real

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.

Siehe auch labelVisible.


labelColor : color

Die Farbe, mit der das Slice-Label gezeichnet wird.


labelFont : font

Die Schriftart, die für die Beschriftung der Scheibe verwendet wird.

Für weitere Informationen siehe font.

Siehe auch labelVisible und labelPosition.


labelPosition : enumeration

Beschreibt die Position der Slice-Beschriftung.

KonstanteBeschreibung
PieSlice.LabelOutsideDie Beschriftung befindet sich außerhalb des Slice, mit dem sie über einen Arm verbunden ist. Dies ist der Standardwert.
PieSlice.LabelInsideHorizontalDie Beschriftung ist innerhalb des Slice zentriert und horizontal angeordnet.
PieSlice.LabelInsideTangentialDie Beschriftung wird innerhalb der Scheibe zentriert und parallel zur Tangente des Scheibenbogens gedreht.
PieSlice.LabelInsideNormalDie 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 Slice-Beschriftung. Standardmäßig ist die Beschriftung nicht sichtbar.


percentage : real [read-only]

Der prozentuale 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 Slices zur Serie hinzugefügt wird.


startAngle : real [read-only]

Der Anfangswinkel dieses Scheibchens in der Serie, zu der es gehört. Ein voller Kuchen hat 360 Grad, wobei 0 Grad auf 12 Uhr steht. Wird automatisch aktualisiert, sobald das Slice der 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 das Slice angeklickt wird.

Der entsprechende Signalhandler ist onClicked().

Hinweis: Der entsprechende Handler ist onClicked.


doubleClicked()

Dieses Signal wird ausgegeben, wenn der Benutzer doppelt auf die Scheibe klickt.

Der entsprechende Signalhandler ist onDoubleClicked().

Hinweis: Der entsprechende Handler ist onDoubleClicked.


hovered(bool state)

Dieses Signal wird ausgegeben, wenn der Mauszeiger über das Slice bewegt wird. Wenn die Maus über die Scheibe bewegt wird, wird state zu true, und wenn die Maus wieder wegbewegt wird, 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.


© 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.