PieSlice QML Type

Représente une part individuelle dans une série de graphiques circulaires. En savoir plus…

• Liste de tous les membres, y compris les membres hérités
• PieSlice fait partie des types QML 2D d'Qt Graphs .

Propriétés

• 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

Signaux

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

Méthodes

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

Description détaillée

Une part de camembert possède une valeur et une étiquette. Lorsque la part est ajoutée à une série de camemberts, le type d'PieSeries e calcule le pourcentage de la part par rapport à la somme de toutes les parts de la série afin de déterminer la taille réelle de la part dans le graphique.

Par défaut, l'étiquette est masquée. Si elle est visible, elle peut soit être située à l'extérieur de la part et reliée à celle-ci par un bras, soit être centrée à l'intérieur de la part, soit horizontalement, soit parallèlement à la tangente ou à la normale de l'arc de la part.

Par défaut, l’apparence visuelle de la part est définie par un thème, mais celui-ci peut être remplacé en spécifiant les propriétés de la part. Toutefois, si le thème est modifié après la personnalisation des parts, toutes les personnalisations seront perdues.

Le type `PieSlice` doit être utilisé en tant qu’enfant d’un type ` PieSeries `. Par exemple :

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

Il est également possible d’ajouter des parts à une série de diagrammes circulaires à l’aide de la méthode ` PieSeries.append()`.

Dans ce cas, les méthodes ` PieSeries.at()` ou ` PieSeries.find()` peuvent être utilisées pour accéder aux propriétés d’une instance `PieSlice` individuelle.

Une part de camembert peut contenir des sous-parts.

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"
    }
}

Voir également PieSeries.

Documentation sur les propriétés

angleSpan : real [read-only]

L'angle de la part en degrés. Un cercle complet correspond à 360 degrés, 0 degré correspondant à la position 12 heures. Cette valeur est mise à jour automatiquement dès que la part est ajoutée à la série.

borderColor : color

Couleur utilisée pour dessiner le contour de la tranche.

Voir aussi borderWidth.

borderWidth : real

La largeur de la bordure de la tranche. Il s'agit d'une propriété pratique permettant de modifier la largeur de la bordure de la tranche.

Voir également borderColor.

color : color

La couleur de remplissage de la tranche.

explodeDistanceFactor : real

Détermine à quelle distance de la tarte la part est projetée.

• 1,0 signifie que la distance est égale au rayon.
• 0,5 signifie que la distance correspond à la moitié du rayon.

Par défaut, la distance est de 0,15

Voir aussi exploded.

exploded : bool

Si la part est séparée de la tarte.

Voir aussi explodeDistanceFactor.

label : string

Le libellé de la tranche.

labelArmLengthFactor : real

La longueur du bras de l'étiquette. Ce facteur est proportionnel au rayon du secteur. Par exemple :

• 1,0 signifie que la longueur est égale au rayon.
• 0,5 signifie que la longueur correspond à la moitié du rayon.

Par défaut, la longueur du bras est de 0,15

Voir également labelVisible.

labelColor : color

La couleur utilisée pour dessiner l'étiquette de la tranche.

labelFont : font

La police utilisée pour l'étiquette de la tranche.

Pour plus d'informations, consultez font.

Voir également labelVisible et labelPosition.

labelPosition : enumeration

Décrit la position de l'étiquette de la coupe.

Voir aussi labelVisible.

labelVisible : bool

Visibilité de l'étiquette de la coupe. Par défaut, l'étiquette n'est pas visible.

percentage : real [read-only]

Pourcentage de la tranche par rapport à la somme de toutes les tranches de la série. La valeur réelle est comprise entre 0,0 et 1,0. Elle est mise à jour automatiquement dès que la tranche est ajoutée à la série.

startAngle : real [read-only]

Angle de départ de cette part dans la série à laquelle elle appartient. Un cercle complet correspond à 360 degrés, 0 degré correspondant à la position 12 heures. Cette valeur est mise à jour automatiquement dès que la part est ajoutée à la série.

subSlicesCount : int [read-only]

Le nombre de sous-tranches dans la tranche.

subSlicesSum : real [read-only]

La somme de toutes les sous-tranches.

La tranche garde la trace de la somme de toutes les sous-tranches qu'elle contient.

value : real

La valeur de la tranche.

Documentation sur les signaux

angleSpanChanged()

Ce signal est émis lorsque l'amplitude angulaire de la coupe change.

Voir également angleSpan.

borderColorChanged()

Ce signal est émis lorsque la couleur de la bordure d'une tranche change.

Voir également borderColor.

borderWidthChanged()

Ce signal est émis lorsque la largeur de la bordure de la tranche change.

Voir également borderWidth.

colorChanged()

Ce signal est émis lorsque la couleur de la tranche change.

explodeDistanceFactorChanged()

Ce signal est émis lorsque le facteur de distance d'explosion change.

Voir également explodeDistanceFactor.

explodedChanged()

Ce signal est émis lorsque la propriété « exploded » change.

Voir également exploded.

labelArmLengthFactorChanged()

Ce signal est émis lorsque le facteur de longueur du bras d'étiquetage change.

Voir également labelArmLengthFactor.

labelChanged()

Ce signal est émis lorsque l'étiquette de tranche change.

Voir également label.

labelColorChanged()

Ce signal est émis lorsque la couleur de l'étiquette d'une tranche change.

Voir également labelColor.

labelFontChanged()

Ce signal est émis lorsque la police de l'étiquette de la tranche change.

Voir également labelFont.

labelFontChanged()

Ce signal est émis lorsque la police de l'étiquette change.

Voir également labelFont.

labelPositionChanged()

Ce signal est émis lorsque la position de l'étiquette change.

Voir également labelPosition.

labelVisibleChanged()

Ce signal est émis lorsque la visibilité de l'étiquette de tranche change.

Voir également labelVisible.

percentageChanged()

Ce signal est émis lorsque le pourcentage de la tranche change.

Voir également percentage.

startAngleChanged()

Ce signal est émis lorsque l'angle de départ de la coupe change.

Voir également startAngle.

subSlicesAdded(list<PieSlice> slices)

Ce signal est émis lorsque les sous-tranches spécifiées par slices sont ajoutées à la tranche.

subSlicesCountChanged(qsizetype count)

Ce signal est émis lorsque la sous-tranche count change.

Voir également subSlicesCount.

subSlicesRemoved(list<PieSlice> slices)

Ce signal est émis lorsque les sous-tranches spécifiées par slices sont supprimées de la tranche.

subSlicesSumChanged(qreal sum)

Ce signal est émis lorsque la sum de toutes les sous-tranches change.

Voir également subSlicesSum.

valueChanged()

Ce signal est émis lorsque la valeur de la tranche change.

Voir également value.

Documentation des méthodes

PieSlice append(string label, real value)

Ajoute à la tranche une nouvelle sous-tranche portant le libellé « label » et la valeur « value ».

PieSlice at(int index)

Renvoie la sous-tranche située à la position indiquée par ` index`. Renvoie `null` si l'index n'est pas valide.

void clear()

Supprime toutes les sous-tranches de la tranche.

PieSlice find(string label)

Renvoie la première sous-tranche portant le libellé « label ». Renvoie null si le libellé n'est pas trouvé.

bool remove(PieSlice slice)

Supprime de la tranche la sous-tranche spécifiée par slice. Renvoie true si la suppression a abouti, false dans le cas contraire.

bool remove(int index)

Supprime de la tranche la sous-tranche spécifiée par index. Renvoie true si la suppression a réussi, false dans le cas contraire.

void removeMultiple(int index, int count)

Supprime une série de sous-tranches, telles que spécifiées par les paramètres « index » et « count ». L'appel parcourt toutes les sous-tranches, même si la suppression de l'une d'entre elles échoue.

bool replace(PieSlice oldSlice, PieSlice newSlice)

Remplace la sous-tranche spécifiée par ` oldSlice ` par ` newSlice`. Renvoie ` true ` si le remplacement a réussi, ` false ` dans le cas contraire. ` oldSlice ` est détruit si le remplacement a réussi.

bool replace(int index, PieSlice slice)

Remplace la sous-tranche spécifiée par slice dans la tranche située à l'adresse index. Renvoie true si le remplacement a réussi, false dans le cas contraire.

bool replaceAll(list<PieSlice> slices)

Remplace intégralement toutes les sous-tranches actuelles par slices. La taille n'a pas besoin de correspondre. Renvoie « false » si l'une des PieSlice de slices n'est pas valide.

bool take(PieSlice slice)

Extrait une seule sous-tranche, spécifiée par ` slice`, de la tranche. Ne supprime pas l'objet de sous-tranche. Renvoie ` true ` en cas de réussite.