PieSeries QML Type

Affiche les données sous forme de graphiques circulaires. En savoir plus...

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• size : real
• startAngle : real
• sum : real
• verticalPosition : real

Signaux

• added(list<PieSlice> slices)
• clicked(PieSlice slice)
• doubleClicked(PieSlice slice)
• hovered(PieSlice slice, bool state)
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceAdded(PieSlice slice)
• sliceRemoved(PieSlice slice)

Méthodes

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void clear()
• PieSlice find(string label)
• bool remove(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 camembert 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 circulaire partiel en définissant un angle de départ et une plage d’angles pour la série. Un graphique circulaire complet correspond à 360 degrés, 0 correspondant à 12 heures.

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

ChartView {
    id: chart
    title: "Top-5 car brand shares in Finland"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    property variant othersSlice: 0

    PieSeries {
        id: pieSeries
        PieSlice { label: "Volkswagen"; value: 13.5 }
        PieSlice { label: "Toyota"; value: 10.9 }
        PieSlice { label: "Ford"; value: 8.6 }
        PieSlice { label: "Skoda"; value: 8.2 }
        PieSlice { label: "Volvo"; value: 6.8 }
    }

    Component.onCompleted: {
        // You can also manipulate slices dynamically, like append a slice or set a slice exploded
        othersSlice = pieSeries.append("Others", 52.0);
        pieSeries.find("Volkswagen").exploded = true;
    }
}

Voir également PieSlice et ChartView.

Documentation sur les propriétés

count : int [read-only]

Le nombre de tranches de la série.

endAngle : real

L'angle final de la tarte.

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.

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

• 0,0 correspond à la taille minimale (tarte entière dessinée sans trou).
• 1,0 correspond à la taille maximale pouvant tenir dans le graphique (le beignet n'a pas de largeur).

Lors de la définition de cette propriété, la propriété « size » 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.

size : real

La taille du diagramme circulaire.

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

• 0,0 correspond à la taille minimale (le graphique circulaire n'est pas affiché).
• 1,0 correspond à la taille maximale pouvant tenir dans le graphique.

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.

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.

Cette 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.

Le gestionnaire de signal correspondant est onAdded.

clicked(PieSlice slice)

Ce signal est émis lorsqu'on clique sur la tranche spécifiée par slice.

Le gestionnaire de signal correspondant est onClicked.

doubleClicked(PieSlice slice)

Ce signal est émis lorsqu'on double-clique sur la tranche spécifiée par slice.

Le gestionnaire de signal correspondant est onDoubleClicked.

hovered(PieSlice slice, bool state)

Ce signal est émis lorsqu'un curseur de souris survole la tranche spécifiée par slice. Lorsque la souris survole la tranche, state devient true, et lorsque la souris s'en éloigne, il redevient false.

Le gestionnaire de signal correspondant est onHovered.

pressed(PieSlice slice)

Ce signal est émis lorsque l'utilisateur clique sur la tranche spécifiée par slice et maintient le bouton de la souris enfoncé.

Le gestionnaire de signal correspondant est onPressed.

released(PieSlice slice)

Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur la tranche spécifiée par slice.

Le gestionnaire de signal correspondant est onReleased.

removed(list<PieSlice> slices)

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

Le gestionnaire de signal correspondant est onRemoved.

sliceAdded(PieSlice slice)

Ce signal est émis lorsque la tranche spécifiée par slice est ajoutée à la série.

Le gestionnaire de signal correspondant est onSliceAdded.

sliceRemoved(PieSlice slice)

Ce signal est émis lorsque la tranche spécifiée par slice est supprimée de la série.

Le gestionnaire de signal correspondant est onSliceRemoved.

Documentation de la méthode

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 le libellé « label ». Renvoie null si le libellé n'est pas trouvé.

bool remove(PieSlice slice)

Supprime de la part de tarte la tranche spécifiée par slice. Renvoie true si la suppression a réussi, false dans le cas contraire.