PieSlice QML Type

Représente une seule tranche d'une série de camemberts. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• PieSlice fait partie de Qt Graphs QML Types for 2D.

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 tranche de tarte a une valeur et une étiquette. Lorsque la part est ajoutée à une série de camemberts, le type PieSeries 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 cachée. Si elle est visible, elle peut être soit située à l'extérieur de la tranche et reliée à celle-ci par un bras, soit centrée à l'intérieur de la tranche, soit horizontalement, soit parallèlement à la tangentielle ou à la normale de l'arc de la tranche.

Par défaut, l'apparence visuelle de la tranche est définie par un thème, mais le thème peut être remplacé en spécifiant les propriétés de la tranche. Toutefois, si le thème est modifié après que les tranches ont été personnalisées, toutes les personnalisations seront perdues.

Le type PieSlice doit être utilisé comme enfant d'un type PieSeries. Par exemple, le type PieSlice peut être utilisé comme enfant d'un type :

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

Il est également possible d'ajouter des parts à une série de camemberts en utilisant la méthode PieSeries.append().

Dans ce cas, PieSeries.at() ou PieSeries.find() peut être utilisé pour accéder aux propriétés d'une instance individuelle de PieSlice.

Une tranche de tarte peut contenir des sous-tranches.

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'étendue de la tranche en degrés. Une tarte complète fait 360 degrés, où 0 degré est à 12 heures. Mise à jour automatique dès que la tranche est ajoutée à la série.

borderColor : color

La couleur utilisée pour dessiner la bordure de la tranche.

Voir aussi borderWidth.

borderWidth : real

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

Voir aussi borderColor.

color : color

La couleur de remplissage de la tranche.

explodeDistanceFactor : real

Détermine à quelle distance de la tarte la tranche est éclatée.

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

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

Voir aussi exploded.

exploded : bool

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

Voir aussi explodeDistanceFactor.

label : string

L'étiquette de la tranche.

labelArmLengthFactor : real

La longueur du bras de l'étiquette. Le facteur est relatif au rayon de la tarte. Par exemple :

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

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

Voir aussi labelVisible.

labelColor : color

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

labelFont : font

Police utilisée pour l'étiquette de la tranche.

Pour plus d'informations, voir font.

Voir également labelVisible et labelPosition.

labelPosition : enumeration

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

Voir aussi labelVisible.

labelVisible : bool

La visibilité de l'étiquette de la tranche. Par défaut, l'étiquette n'est pas visible.

percentage : real [read-only]

Le 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. Mise à jour automatique dès que la tranche est ajoutée à la série.

startAngle : real [read-only]

L'angle de départ de cette tranche dans la série à laquelle elle appartient. Une tarte complète fait 360 degrés, où 0 degré est à 12 heures. Mis à jour automatiquement lorsque la tranche 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 tient compte de la somme de toutes les sous-tranches qu'elle détient.

value : real

La valeur de la tranche.

Documentation sur les signaux

angleSpanChanged()

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

Voir également angleSpan.

borderColorChanged()

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

Voir aussi 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 aussi explodeDistanceFactor.

explodedChanged()

Ce signal est émis lorsque la propriété éclatée change.

Voir également exploded.

labelArmLengthFactorChanged()

Ce signal est émis lorsque le facteur de longueur du bras de l'étiquette change.

Voir également labelArmLengthFactor.

labelChanged()

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

Voir aussi label.

labelColorChanged()

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

Voir aussi 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 aussi 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 la 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 tranche 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 est modifiée.

Voir aussi 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 le site 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 de la méthode

PieSlice append(string label, real value)

Ajoute à la tranche une nouvelle sous-tranche portant l'étiquette label et la valeur value.

PieSlice at(int index)

Renvoie la sous-tranche à la position spécifiée par index. Retourne 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 qui porte l'étiquette label. Retourne null si l'étiquette n'est pas trouvée.

bool remove(PieSlice slice)

Supprime de la tranche la sous-tranche spécifiée par slice. Renvoie true si la suppression a été effectuée avec succès, 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 été effectuée avec succès, false dans le cas contraire.

void removeMultiple(int index, int count)

Supprime une série de sous-tranches comme spécifié par index et count. L'appel passe par 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. Retourne true si le remplacement a réussi, false sinon. oldSlice est détruit s'il a été remplacé avec succès.

bool replace(int index, PieSlice slice)

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

bool replaceAll(list<PieSlice> slices)

Remplace complètement toutes les sous-tranches actuelles par slices. La taille n'a pas besoin de correspondre. Renvoie un message faux si l'un des PieSlice de slices n'est pas valide.

bool take(PieSlice slice)

Prend une seule sous-tranche, spécifiée par slice, de la tranche. Ne supprime pas l'objet sous-tranche. Renvoie true en cas de succès.