PieSeries QML Type
Présente les données sous forme de diagrammes circulaires. Plus d'informations...
| Import Statement: | import QtCharts 2.10 |
| In C++: | QPieSeries |
| Inherits: |
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)
- 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 |
Le nombre de parts dans la série.
endAngle : real |
L'angle final de la tarte.
Une tarte complète fait 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 que peut avoir le 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 |
Position horizontale de la tarte.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 correspond à la gauche absolue.
- 1.0 est la droite absolue.
La valeur par défaut est 0,5 (centre).
Voir également verticalPosition.
size : real |
La taille du camembert.
La valeur est relative au rectangle du graphique, de sorte que :
- 0,0 est la taille minimale (le camembert n'est pas dessiné).
- 1.0 correspond à la taille maximale du 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 du camembert.
Une tarte complète a un angle de 360 degrés, 0 degré étant à 12 heures.
La valeur par défaut est 0.
sum : real |
La somme de toutes les tranches.
La série tient compte de la somme de toutes les tranches qu'elle contient.
verticalPosition : real |
La position verticale de la tarte.
La valeur est relative au rectangle du graphique, de sorte que :
- 0,0 est le sommet absolu.
- 1.0 est le bas absolu.
La valeur par défaut est 0,5 (centre).
Voir également horizontalPosition.
Signal Documentation
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.
Remarque : le gestionnaire 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.
Remarque : Le gestionnaire 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.
Remarque : Le gestionnaire correspondant est onDoubleClicked.
Ce signal est émis lorsque la souris survole 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.
Note : Le gestionnaire 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.
Note : Le gestionnaire 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.
Remarque : Le gestionnaire correspondant est onReleased.
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.
Remarque : Le gestionnaire 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.
Note : Le gestionnaire 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.
Remarque : Le gestionnaire correspondant est onSliceRemoved.
Documentation de la méthode
Ajoute à la tarte une nouvelle tranche portant l'étiquette label et la valeur value.
Renvoie la tranche à la position spécifiée par index. Retourne null si l'index n'est pas valide.
clear() |
Supprime toutes les tranches du gâteau.
Renvoie la première tranche dont l'étiquette est label. Retourne null si l'étiquette n'est pas trouvée.
Retire du gâteau la tranche spécifiée par slice. Retourne true si le retrait a été effectué avec succès, false dans le cas contraire.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.