PieSlice QML Type

Stellt einen einzelnen Ausschnitt in einer Kreisdiagrammreihe dar. Mehr...

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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()

Ausführliche Beschreibung

Ein Kreisdiagrammsegment verfügt über einen Wert und eine Beschriftung. Wenn das Segment zu einer Kreisdiagrammreihe hinzugefügt wird, berechnet der Typ „ PieSeries “ 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 platziert und über einen Arm mit diesem verbunden sein oder innerhalb des Segments zentriert werden – entweder horizontal oder parallel zur Tangente oder Normalen des Segmentbogens.

Standardmäßig wird das Erscheinungsbild des Segments durch ein Design festgelegt, das jedoch durch die Angabe von Segmenteigenschaften überschrieben werden kann. Wird das Design jedoch geändert, nachdem die Segmente angepasst wurden, gehen alle Anpassungen verloren.

Der Typ „PieSlice“ sollte als untergeordneter Element eines „ PieSeries “-Typs verwendet werden. Beispiel:

Alternativ können Segmente mithilfe der Methode ` PieSeries.append()` zu einer Kreisdiagrammreihe hinzugefügt werden.

In diesem Fall kann mit ` PieSeries.at()` oder ` PieSeries.find ` auf die Eigenschaften einer einzelnen `PieSlice`-Instanz zugegriffen werden.

Siehe auch „ PieSeries “.

Dokumentation zu den Eigenschaften

angleSpan : real [read-only]

Der Winkelbereich des Segments in Grad. 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.

borderColor : color

Die Farbe, mit der der Rand des Ausschnitts gezeichnet wird (Stiftfarbe).

Siehe auch borderWidth.

borderWidth : int

Die Breite des Schnittkantenrandes. Dies ist eine Komfort-Eigenschaft zum Anpassen des Schnittstifts.

Siehe auch „ borderColor “.

brushFilename : string

Der Name der Datei, die als Pinsel für den Ausschnitt verwendet wird.

color : color

Die Füllfarbe (Pinsel) des Segments.

explodeDistanceFactor : real

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

Siehe auch exploded.

exploded : bool

Ob das Stück vom Kuchen getrennt ist.

Siehe auch explodeDistanceFactor.

label : string

Die Bezeichnung der Scheibe.

labelArmLengthFactor : real

Die Länge des Beschriftungsarms. 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

Siehe auch labelVisible.

labelColor : color

Die Farbe, mit der die Scheibenbeschriftung gezeichnet wird.

labelFont : font

Die für die Scheibenbeschriftung verwendete Schriftart.

Weitere Informationen finden Sie unter font.

Siehe auch labelVisible und labelPosition.

labelPosition : enumeration

Beschreibt die Position der Schnittbezeichnung.

Siehe auch „ labelVisible “.

labelVisible : bool

Die Sichtbarkeit der Schnittbezeichnung. Standardmäßig ist die Bezeichnung nicht sichtbar.

percentage : real [read-only]

Der prozentuale Anteil des Segments im Verhältnis zur Summe aller Segmente der Reihe. Der tatsächliche Wert liegt zwischen 0,0 und 1,0. Wird automatisch aktualisiert, sobald das Segment zur Reihe hinzugefügt wird.

startAngle : real [read-only]

Der Startwinkel dieses Segments in der Reihe, 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 Reihe hinzugefügt wird.

value : real

Der Wert des Slices.

Signal-Dokumentation

clicked()

Dieses Signal wird ausgelöst, wenn auf den Ausschnitt geklickt wird.

Der zugehörige Signal-Handler ist „ onClicked() “.

doubleClicked()

Dieses Signal wird ausgelöst, wenn der Benutzer auf den Ausschnitt doppelklickt.

Der zugehörige Signal-Handler lautet „ onDoubleClicked() “.

hovered(bool state)

Dieses Signal wird ausgelöst, wenn der Mauszeiger über den Ausschnitt bewegt wird. Wenn sich der Mauszeiger über den Ausschnitt bewegt, wechselt state zu true, und wenn der Mauszeiger wieder wegbewegt wird, wechselt es zu false.

Der zugehörige Signal-Handler ist onHovered().

pressed()

Dieses Signal wird ausgelöst, wenn der Benutzer auf den Ausschnitt klickt und die Maustaste gedrückt hält.

Der zugehörige Signal-Handler lautet „ onPressed() “.

released()

Dieses Signal wird ausgelöst, wenn der Benutzer den Mausklick auf dem Slice löst.

Der entsprechende Signal-Handler lautet „ onReleased() “.