PieSeries QML Type

Présente les données sous forme de diagrammes circulaires. Plus d'informations...

• 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 camemberts se compose de tranches définies à l'aide du type PieSlice. Les tranches peuvent avoir n'importe quelle valeur, car le type PieSeries calcule le pourcentage d'une tranche par rapport à la somme de toutes les tranches de la série pour déterminer la taille réelle de la tranche dans le graphique.

La taille et la position des parts dans le graphique sont contrôlées par des valeurs relatives comprises entre 0,0 et 1,0. Ces valeurs se rapportent au rectangle du graphique.

Par défaut, le camembert est défini comme un camembert complet. Il est possible de créer un camembert partiel en définissant un angle de départ et une plage d'angles pour la série. Une tarte complète représente 360 degrés, où 0 est à 12 heures.

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

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 dans la série.

endAngle : real

L'angle final de la tarte.

Une tarte complète a un angle de 360 degrés, 0 degré étant à 12 heures.

La valeur par défaut est 360.

holeSize : real

La taille du trou du beignet.

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

• 0,0 est la taille minimale (tarte complète dessinée sans trou).
• 1.0 est la taille maximale qui peut convenir au graphique (le beignet n'a pas de largeur).

Lors du réglage de cette propriété, la propriété size est ajustée si nécessaire, afin de s'assurer que la taille du trou n'est pas supérieure à la taille de la tarte.

La valeur par défaut est 0.0.

horizontalPosition : real

La position horizontale du camembert.

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

• 0,0 correspond à la gauche absolue.
• 1.0 correspond à la droite absolue.

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

Voir aussi verticalPosition.

size : real

La taille du camembert.

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

• 0.0 est la taille minimale (la tarte n'est pas dessinée).
• 1.0 est la taille maximale qui peut s'adapter au graphique.

Lors du réglage de cette propriété, la propriété holeSize est ajustée si nécessaire, afin de s'assurer que la taille du trou n'est pas supérieure à la taille de la tarte.

La valeur par défaut est 0,7.

startAngle : real

L'angle de départ de la tarte.

Une tarte complète fait 360 degrés, 0 degré étant à 12 heures.

La valeur par défaut est 0.

sum : real [read-only]

La somme de toutes les tranches.

La série tient compte de la somme de toutes les tranches qu'elle détient.

verticalPosition : real

La position verticale du camembert.

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

• 0,0 est le haut absolu.
• 1.0 est le bas absolu.

La valeur par défaut est 0,5 (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 lorsque la tranche spécifiée par slice est cliquée.

Le gestionnaire de signal correspondant est onClicked.

doubleClicked(PieSlice slice)

Ce signal est émis lorsque la tranche spécifiée par slice est double-cliquée.

Le gestionnaire de signal correspondant est onDoubleClicked.

hovered(PieSlice slice, bool state)

Ce signal est émis lorsque la souris passe au-dessus de la tranche spécifiée par slice. Lorsque la souris passe au-dessus de la tranche, state devient true, et lorsque la souris s'éloigne à nouveau, il devient 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 la pression 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 retiré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 retirée de la série.

Le gestionnaire de signal correspondant est onSliceRemoved.

Documentation de la méthode

PieSlice append(string label, real value)

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

PieSlice at(int index)

Renvoie la tranche à la position spécifiée par index. Retourne null si l'index n'est pas valide.

void clear()

Supprime toutes les parts de la tarte.

PieSlice find(string label)

Renvoie la première tranche qui porte l'étiquette label. Retourne null si l'étiquette n'est pas trouvée.

bool remove(PieSlice slice)

Retire de la tarte la part spécifiée par slice. Retourne true si le retrait a été effectué avec succès, false dans le cas contraire.