PieSeries QML Type

Présente les données sous forme de graphiques circulaires. En savoir plus…

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

Propriétés

• angleSpanLabelVisibility : enumeration (since 6.10)
• angleSpanVisibleLimit : real (since 6.10)
• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• pieSize : real
• sliceData : list<real> (since 6.12)
• sliceLabels : list<string> (since 6.12)
• startAngle : real
• sum : real
• verticalPosition : real

Signaux

• added(list<PieSlice> slices)
• angleSpanLabelVisibilityChanged(LabelVisibility visibility) (since 6.10)
• angleSpanVisibleLimitChanged(real limit) (since 6.10)
• clicked(PieSlice slice)
• countChanged()
• doubleClicked(PieSlice slice)
• endAngleChanged()
• holeSizeChanged()
• horizontalPositionChanged()
• pieSizeChanged()
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceDataChanged(list<real> sliceData) (since 6.12)
• sliceLabelsChanged(list<string> sliceLabels) (since 6.12)
• startAngleChanged()
• sumChanged()
• verticalPositionChanged()

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(list<PieSlice> slices)
• bool replace(PieSlice oldSlice, PieSlice newSlice)
• bool replace(int index, PieSlice slice)
• bool take(PieSlice slice)

Description détaillée

Une série de diagrammes circulaires est composée de parts définies à l'aide du type ` PieSlice `. Les parts peuvent prendre n'importe quelle valeur, car le type `PieSeries` calcule le pourcentage d'une 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.

La taille et la position du graphique circulaire sur le graphique sont contrôlées à l’aide de valeurs relatives comprises entre 0,0 et 1,0. Celles-ci se rapportent au rectangle réel du graphique.

Par défaut, le graphique circulaire est défini comme un graphique complet. Il est possible de créer un graphique partiel en définissant un angle de départ et une plage d’angles pour la série. Un graphique complet correspond à 360 degrés, 0 correspondant à 12 heures.

L'exemple QML suivant montre comment créer un graphique circulaire simple.

import QtQuick
import QtGraphs

Item {
    id: mainView
    width: 1280
    height: 720

    GraphsView {
        anchors.fill: parent
        theme: GraphsTheme {
             colorScheme: GraphsTheme.ColorScheme.Dark
             theme: GraphsTheme.Theme.QtGreen
        }
        PieSeries {
            id: pieSeries
            PieSlice {
                value: 1
            }
            PieSlice {
                value: 2
            }
        }
    }
}

Voir également PieSlice et GraphsView.

Documentation sur les propriétés

angleSpanLabelVisibility : enumeration [since 6.10]

Mode de visibilité des étiquettes.

Mode qui détermine quelles étiquettes seront masquées si elles se trouvent en dessous de la limite d'angle définie avec « angleSpanVisibleLimit ». N'a aucun effet si « angleSpanVisibleLimit » n'a pas été défini.

Cette propriété a été introduite dans Qt 6.10.

Voir également « angleSpanVisibleLimit ».

angleSpanVisibleLimit : real [since 6.10]

Limite de l'intervalle angulaire pour la visibilité d'une étiquette.

L'intervalle angulaire qui servira de limite de visibilité pour une étiquette de tranche. Une tranche dont l'intervalle angulaire est inférieur à cette valeur verra sa visibilité varier en fonction de l'angleSpanLabelVisibility, définie pour la série. La valeur par défaut est « 0 », ce qui signifie qu'aucune tranche ne sera masquée, quelle que soit l'angleSpanLabelVisibility.

Cette propriété a été introduite dans Qt 6.10.

Voir également angleSpanLabelVisibility.

count : int [read-only]

Le nombre de tranches de la série.

endAngle : real

L'angle final du cercle.

Un cercle complet mesure 360 degrés, 0 degré correspondant à 12 heures.

La valeur par défaut est 360.

holeSize : real

La taille du trou du beignet.

Lors de la définition de la propriété « pieSize », celle-ci est ajustée si nécessaire afin de garantir que la taille du trou ne dépasse pas celle du camembert.

La valeur par défaut est 0,0.

horizontalPosition : real

La position horizontale du secteur.

La valeur est relative au rectangle du graphique, de sorte que :

• 0,0 correspond à l'extrême gauche.
• 1,0 correspond à l'extrême droite.

La valeur par défaut est 0,5 (au centre).

Voir également verticalPosition.

pieSize : real

La taille du diagramme circulaire.

Cette valeur est relative au rectangle du graphique, de sorte que :

• 0,0 correspond à la taille minimale du camembert (camembert non dessiné).
• 1,0 correspond à la taille maximale du graphique pouvant s'afficher.

Lors de la définition de cette propriété, la propriété ` holeSize ` est ajustée si nécessaire, afin de garantir que la taille du trou ne soit pas supérieure à celle du graphique circulaire.

La valeur par défaut est 0,7.

sliceData : list<real> [since 6.12]

Valeurs déclaratives des parts de camembert.

Cette propriété permet d'attribuer des valeurs de manière déclarative aux parts du graphique circulaire. Lorsque cette propriété est définie, la série de graphiques circulaires (pieseries) crée automatiquement une part pour chaque valeur. Les libellés des parts peuvent être spécifiés dans sliceLabels.

Cette propriété a été introduite dans Qt 6.12.

Voir également sliceLabels.

sliceLabels : list<string> [since 6.12]

Étiquettes déclaratives des parts de camembert.

Cette propriété permet d'attribuer des étiquettes de manière déclarative aux segments du graphique circulaire. Lorsque cette propriété est définie, la série de graphiques circulaires attribue des étiquettes aux segments créés de manière déclarative. Les étiquettes doivent suivre le même ordre que les valeurs de la propriété ` sliceData`. S'il n'y a pas suffisamment de segments créés de manière déclarative, les étiquettes restantes sont ignorées.

Cette propriété a été introduite dans Qt 6.12.

Voir également sliceData.

startAngle : real

L'angle de départ du cercle.

Un cercle complet correspond à 360 degrés, 0 degré correspondant à 12 heures.

La valeur par défaut est 0.

sum : real [read-only]

La somme de toutes les tranches.

La série garde la trace de la somme de toutes les tranches qu'elle contient.

verticalPosition : real

La position verticale du secteur.

La valeur est relative au rectangle du graphique, de sorte que :

• 0,0 correspond au sommet absolu.
• 1,0 correspond au bas absolu.

La valeur par défaut est 0,5 (au centre).

Voir également horizontalPosition.

Documentation sur les signaux

added(list<PieSlice> slices)

Ce signal est émis lorsque les tranches spécifiées par slices sont ajoutées à la série.

[since 6.10] angleSpanLabelVisibilityChanged(LabelVisibility visibility)

Ce signal est émis lorsque le mode de visibilité de la plage angulaire a été modifié. Le paramètre visibility contient le nouveau mode de visibilité.

Ce signal a été introduit dans Qt 6.10.

[since 6.10] angleSpanVisibleLimitChanged(real limit)

Ce signal est émis lorsque la limite d'angle a été modifiée. Le paramètre limit contient la nouvelle limite.

Ce signal a été introduit dans Qt 6.10.

clicked(PieSlice slice)

Ce signal est émis lorsqu'on clique ou qu'on appuie sur l'slice.

countChanged()

Ce signal est émis lorsque le nombre de tranches change.

Voir également count.

doubleClicked(PieSlice slice)

Ce signal est émis lorsqu'on double-clique ou qu'on effectue un double tap sur l'slice. Ce signal se produit toujours après clicked.

endAngleChanged()

Ce signal est émis lorsque l'angle de fermeture du moule change.

Voir également endAngle.

holeSizeChanged()

Ce signal est émis lorsque la taille du « trou du beignet » change.

Voir également holeSize.

horizontalPositionChanged()

Ce signal est émis lorsque la position horizontale change.

Voir également horizontalPosition.

pieSizeChanged()

Ce signal est émis lorsque la taille de la part change.

Voir également pieSize.

pressed(PieSlice slice)

Ce signal est émis lorsque l'utilisateur clique ou appuie sur l'élément « slice » et maintient le bouton de la souris enfoncé ou continue le geste.

released(PieSlice slice)

Ce signal est émis lorsque l'utilisateur relâche un bouton de souris ou un geste précédemment activé sur l'slice.

removed(list<PieSlice> slices)

Ce signal est émis lorsque les tranches spécifiées par slices sont supprimées de la série.

[since 6.12] sliceDataChanged(list<real> sliceData)

Ce signal est émis lorsque les données de la tranche ont été modifiées. Le paramètre sliceData contient les données de la tranche.

Ce signal a été introduit dans Qt 6.12.

[since 6.12] sliceLabelsChanged(list<string> sliceLabels)

Ce signal est émis lorsque les données de la tranche ont été modifiées. Le paramètre sliceLabels contient les données de la tranche.

Ce signal a été introduit dans Qt 6.12.

startAngleChanged()

Ce signal est émis lorsque l'angle de départ du secteur change.

Voir également startAngle.

sumChanged()

Ce signal est émis lorsque la somme de toutes les tranches change.

Voir également sum.

verticalPositionChanged()

Ce signal est émis lorsque la position verticale change.

Voir également verticalPosition.

Documentation des méthodes

PieSlice append(string label, real value)

Ajoute au graphique circulaire une nouvelle part portant le libellé « label » et la valeur « value ».

PieSlice at(int index)

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

void clear()

Supprime toutes les parts du camembert.

PieSlice find(string label)

Renvoie la première tranche portant l'étiquette « label ». Renvoie null si l'étiquette n'est pas trouvée.

bool remove(PieSlice slice)

Supprime la part spécifiée par ` slice ` du graphique circulaire. Renvoie ` true ` si la suppression a réussi, ` false ` dans le cas contraire.

bool remove(int index)

Supprime de la tarte la part 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 tranches, telles que spécifiées par les paramètres index et count. L'appel parcourt toutes les tranches, même si la suppression de l'une d'entre elles échoue.

bool replace(list<PieSlice> slices)

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

bool replace(PieSlice oldSlice, PieSlice newSlice)

Remplace la tranche spécifiée par ` oldSlice ` par `newSlice`. Renvoie ` true ` si la suppression a abouti, ` false ` dans le cas contraire. ` oldSlice ` est détruit si l'opération réussit.

bool replace(int index, PieSlice slice)

Remplace la part spécifiée par slice dans le graphique circulaire disponible à l'adresse index. Renvoie true si le remplacement a réussi, false dans le cas contraire.

bool take(PieSlice slice)

Récupère une seule tranche, spécifiée par ` slice`, à partir de la série. Ne supprime pas l'objet « tranche ». Renvoie ` true ` en cas de réussite.