PieSlice QML Type

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

Import Statement:	`import QtGraphs`
In C++:	QPieSlice

Liste aller Mitglieder, einschließlich geerbter Mitglieder
PieSlice ist Teil von Qt Graphs QML Types for 2D.

Eigenschaften

angleSpan : real
borderColor : color
borderWidth : qreal
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

Detaillierte Beschreibung

Ein Tortenstück hat einen Wert und eine Bezeichnung. 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 der Slice befinden und mit ihr durch einen Arm verbunden sein oder innerhalb der 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:

PieSeries {
    PieSlice {
        label: "example"
        value: 1
    }
}

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.

Siehe auch borderWidth.

borderWidth : qreal

Die Breite des Scheibenrandes. Dies ist eine bequeme Eigenschaft zum Ändern der Breite des Slice-Rahmens.

Siehe auch borderColor.

color : color

Die Füllfarbe des Slice.

explodeDistanceFactor : real

Legt fest, wie weit die Scheibe von der Torte 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 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.

Konstante	Beschreibung
`PieSlice.LabelPosition.Outside`	Die Beschriftung befindet sich außerhalb des Slice, mit dem sie über einen Arm verbunden ist. Dies ist der Standardwert.
`PieSlice.LabelPosition.InsideHorizontal`	Die Beschriftung ist innerhalb des Slice zentriert und horizontal angeordnet.
`PieSlice.LabelPosition.InsideTangential`	Die Beschriftung wird innerhalb der Scheibe zentriert und parallel zur Tangente des Scheibenbogens gedreht.
`PieSlice.LabelPosition.InsideNormal`	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 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

angleSpanChanged()

Dieses Signal wird ausgegeben, wenn sich die Winkelspanne des Slice ändert.

Hinweis: Der entsprechende Handler ist onAngleSpanChanged.

Siehe auch angleSpan.

borderColorChanged()

Dieses Signal wird ausgegeben, wenn sich die Farbe des Scheibenrandes ändert.

Hinweis: Der entsprechende Handler ist onBorderColorChanged.

Siehe auch borderColor.

borderWidthChanged()

Dieses Signal wird ausgegeben, wenn sich die Breite des Slice-Rahmens ändert.

Hinweis: Der entsprechende Handler ist onBorderWidthChanged.

Siehe auch borderWidth.

colorChanged()

Dieses Signal wird ausgegeben, wenn sich die Farbe der Scheibe ändert.

Hinweis: Der entsprechende Handler ist onColorChanged.

explodeDistanceFactorChanged()

Dieses Signal wird ausgegeben, wenn sich der Explosionsabstandsfaktor ändert.

Hinweis: Der entsprechende Handler ist onExplodeDistanceFactorChanged.

Siehe auch explodeDistanceFactor.

explodedChanged()

Dieses Signal wird ausgegeben, wenn sich die explodierte Eigenschaft ändert.

Hinweis: Der entsprechende Handler ist onExplodedChanged.

Siehe auch exploded.

labelArmLengthFactorChanged()

Dieses Signal wird ausgegeben, wenn sich der Längenfaktor des Etikettenarms ändert.

Hinweis: Der entsprechende Handler ist onLabelArmLengthFactorChanged.

Siehe auch labelArmLengthFactor.

labelChanged()

Dieses Signal wird ausgegeben, wenn sich das Slice-Label ändert.

Hinweis: Der entsprechende Handler ist onLabelChanged.

Siehe auch label.

labelColorChanged()

Dieses Signal wird ausgegeben, wenn sich die Farbe des Slice-Labels ändert.

Hinweis: Der entsprechende Handler ist onLabelColorChanged.

Siehe auch labelColor.

labelFontChanged()

Dieses Signal wird ausgegeben, wenn sich die Schriftart der Beschriftung des Slice ändert.

Hinweis: Der entsprechende Handler ist onLabelFontChanged.

Siehe auch labelFont.

labelFontChanged()

Dieses Signal wird ausgegeben, wenn sich die Schriftart der Beschriftung ändert.

Hinweis: Der entsprechende Handler ist onLabelFontChanged.

Siehe auch labelFont.

labelPositionChanged()

Dieses Signal wird ausgegeben, wenn sich die Position des Etiketts ändert.

Hinweis: Der entsprechende Handler ist onLabelPositionChanged.

Siehe auch labelPosition.

labelVisibleChanged()

Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit des Slice-Labels ändert.

Hinweis: Der entsprechende Handler ist onLabelVisibleChanged.

Siehe auch labelVisible.

percentageChanged()

Dieses Signal wird ausgegeben, wenn sich der Prozentsatz des Slice ändert.

Hinweis: Der entsprechende Handler ist onPercentageChanged.

Siehe auch percentage.

startAngleChanged()

Dieses Signal wird ausgegeben, wenn sich der Startwinkel der Scheibe ändert.

Hinweis: Der entsprechende Handler ist onStartAngleChanged.

Siehe auch startAngle.

valueChanged()

Dieses Signal wird ausgegeben, wenn sich der Slice-Wert ändert.

Hinweis: Der entsprechende Handler ist onValueChanged.

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.