PieSlice QML Type

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

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

Eigenschaften

• angleSpan : real
• borderColor : color
• borderWidth : real
• color : color
• explodeDistanceFactor : real
• exploded : bool
• label : string
• labelArmLengthFactor : real
• labelColor : color
• labelFont : font
• labelPosition : enumeration
• labelVisible : bool
• percentage : real
• startAngle : real
• subSlicesCount : int
• subSlicesSum : real
• value : real

Signale

• angleSpanChanged()
• borderColorChanged()
• borderWidthChanged()
• colorChanged()
• explodeDistanceFactorChanged()
• explodedChanged()
• labelArmLengthFactorChanged()
• labelChanged()
• labelColorChanged()
• labelFontChanged()
• labelFontChanged()
• labelPositionChanged()
• labelVisibleChanged()
• percentageChanged()
• startAngleChanged()
• subSlicesAdded(list<PieSlice> slices)
• subSlicesCountChanged(qsizetype count)
• subSlicesRemoved(list<PieSlice> slices)
• subSlicesSumChanged(qreal sum)
• valueChanged()

Methoden

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void clear()
• PieSlice find(string label)
• bool remove(PieSlice slice)
• bool remove(int index)
• void removeMultiple(int index, int count)
• bool replace(PieSlice oldSlice, PieSlice newSlice)
• bool replace(int index, PieSlice slice)
• bool replaceAll(list<PieSlice> slices)
• bool take(PieSlice slice)

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.

Ein PieSlice kann Sub-Slices enthalten.

PieSeries {
    PieSlice {
        label: "example"
        value: 1
        color: "orange"
        exploded: true
        PieSlice {
            label: "example2"
            value: 2
            color: "red"
        }
        PieSlice {
            label: "example3"
            value: 3
            color: "yellow"
            exploded: true
        }
    }
    PieSlice {
        label: "example4"
        value: 4
        color: "green"
    }
}

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.

Siehe auch borderWidth.

borderWidth : real

Die Breite des Slice-Rahmens. 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 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.

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.

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.

subSlicesCount : int [read-only]

Die Anzahl der Sub-Slices im Slice.

subSlicesSum : real [read-only]

Die Summe aller Sub-Slices.

Das Slice behält die Summe aller Sub-Slices, die es enthält, im Auge.

value : real

Der Wert des Slice.

Signal Dokumentation

angleSpanChanged()

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

Siehe auch angleSpan.

borderColorChanged()

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

Siehe auch borderColor.

borderWidthChanged()

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

Siehe auch borderWidth.

colorChanged()

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

explodeDistanceFactorChanged()

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

Siehe auch explodeDistanceFactor.

explodedChanged()

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

Siehe auch exploded.

labelArmLengthFactorChanged()

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

Siehe auch labelArmLengthFactor.

labelChanged()

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

Siehe auch label.

labelColorChanged()

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

Siehe auch labelColor.

labelFontChanged()

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

Siehe auch labelFont.

labelFontChanged()

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

Siehe auch labelFont.

labelPositionChanged()

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

Siehe auch labelPosition.

labelVisibleChanged()

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

Siehe auch labelVisible.

percentageChanged()

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

Siehe auch percentage.

startAngleChanged()

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

Siehe auch startAngle.

subSlicesAdded(list<PieSlice> slices)

Dieses Signal wird ausgegeben, wenn die durch slices angegebenen Sub-Slices zum Slice hinzugefügt werden.

subSlicesCountChanged(qsizetype count)

Dieses Signal wird ausgegeben, wenn sich die Sub-Slices count ändern.

Siehe auch subSlicesCount.

subSlicesRemoved(list<PieSlice> slices)

Dieses Signal wird ausgegeben, wenn die durch slices angegebenen Sub-Slices aus dem Slice entfernt werden.

subSlicesSumChanged(qreal sum)

Dieses Signal wird ausgegeben, wenn sich die sum aller Sub-Slices ändert.

Siehe auch subSlicesSum.

valueChanged()

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

Siehe auch value.

Dokumentation der Methode

PieSlice append(string label, real value)

Fügt ein neues Sub-Slice mit der Bezeichnung label und dem Wert value zum Slice hinzu.

PieSlice at(int index)

Gibt das Sub-Slice an der durch index angegebenen Position zurück. Gibt null zurück, wenn der Index ungültig ist.

void clear()

Entfernt alle Sub-Slices aus dem Slice.

PieSlice find(string label)

Gibt das erste Sub-Slice zurück, das die Bezeichnung label hat. Gibt null zurück, wenn die Beschriftung nicht gefunden wird.

bool remove(PieSlice slice)

Entfernt das durch slice angegebene Sub-Slice aus dem Slice. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false.

bool remove(int index)

Entfernt das durch index angegebene Sub-Slice aus dem Slice. Gibt true zurück, wenn das Entfernen erfolgreich war, andernfalls false.

void removeMultiple(int index, int count)

Entfernt einen Bereich von Sub-Slices, wie durch index und count angegeben. Der Aufruf durchläuft alle Sub-Slices, auch wenn das Entfernen eines Slices fehlschlägt.

bool replace(PieSlice oldSlice, PieSlice newSlice)

Ersetzt das durch oldSlice angegebene Sub-Slice durch newSlice. Gibt true zurück, wenn das Ersetzen erfolgreich war, andernfalls false. oldSlice wird zerstört, wenn es erfolgreich ersetzt wurde.

bool replace(int index, PieSlice slice)

Ersetzt das durch slice angegebene Sub-Slice durch das Slice unter index. Gibt true zurück, wenn das Ersetzen erfolgreich war, andernfalls false.

bool replaceAll(list<PieSlice> slices)

Ersetzt alle aktuellen Sub-Slices vollständig durch slices. Die Größe muss nicht übereinstimmen. Gibt false zurück, wenn eines der PieSlice in slices ungültig ist.

bool take(PieSlice slice)

Entnimmt ein einzelnes Sub-Slice, angegeben durch slice, aus dem Slice. Löscht das Sub-Slice-Objekt nicht. Gibt bei Erfolg true zurück.