PieSlice QML Type
Représente une part unique dans une série de diagrammes circulaires. En savoir plus…
| Import Statement: | import QtCharts 2.12 |
| In C++: | QPieSlice |
| Status: | Deprecated |
Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- angleSpan : real
- borderColor : color
- borderWidth : int
- brushFilename : string
- color : color
- explodeDistanceFactor : real
- exploded : bool
- label : string
- labelArmLengthFactor : real
- labelColor : color
- labelFont : font
- labelPosition : enumeration
- labelVisible : bool
- percentage : real
- startAngle : real
- value : real
Signaux
- clicked()
- doubleClicked()
- hovered(bool state)
- pressed()
- released()
Description détaillée
Une part de camembert possède une valeur et une étiquette. Lorsque la part est ajoutée à une série de camemberts, le type d'PieSeries e 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 masquée. Si elle est visible, elle peut soit être située à l'extérieur de la part et reliée à celle-ci par un bras, soit être centrée à l'intérieur de la part, soit horizontalement, soit parallèlement à la tangente ou à la normale de l'arc de la part.
Par défaut, l'apparence visuelle de la part est définie par un thème, mais celui-ci peut être remplacé en spécifiant les propriétés de la part. Toutefois, si le thème est modifié après la personnalisation des parts, toutes les personnalisations seront perdues.
Le type `PieSlice` doit être utilisé en tant qu’enfant d’un type ` PieSeries `. Par exemple :
Il est également possible d’ajouter des parts à une série de diagrammes circulaires à l’aide de la méthode ` PieSeries.append()`.
Dans ce cas, les méthodes ` PieSeries.at()` ou ` PieSeries.find ` peuvent être utilisées pour accéder aux propriétés d’une instance `PieSlice` individuelle.
Voir également PieSeries.
Documentation sur les propriétés
angleSpan : real [read-only]
L'angle de la part, exprimé en degrés. Un cercle complet correspond à 360 degrés, 0 degré correspondant à la position 12 heures. Cette valeur est mise à jour automatiquement dès que la part est ajoutée à la série.
borderColor : color
Couleur utilisée pour tracer le contour de la tranche (couleur du stylo).
Voir également borderWidth.
borderWidth : int
La largeur du contour de la tranche. Il s'agit d'une propriété pratique permettant de modifier le tracé de la tranche.
Voir également borderColor.
brushFilename : string
Nom du fichier utilisé comme pinceau pour la tranche.
color : color
La couleur de remplissage (pinceau) de la tranche.
explodeDistanceFactor : real
Détermine à quelle distance de la tarte la part est projetée.
- 1,0 signifie que la distance est égale au rayon.
- 0,5 signifie que la distance correspond à la moitié du rayon.
Par défaut, la distance est de 0,15
Voir également exploded.
exploded : bool
Si la part est séparée de la tarte.
Voir également explodeDistanceFactor.
label : string
Le libellé de la tranche.
Remarque : la chaîne peut être au format HTML.
labelArmLengthFactor : real
La longueur du bras de l'étiquette. Ce facteur est proportionnel au rayon du secteur. 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 également labelVisible.
labelColor : color
La couleur utilisée pour afficher l'étiquette de la tranche.
labelFont : font
La police utilisée pour l'étiquette de la tranche.
Pour plus d'informations, consultez font.
Voir également labelVisible et labelPosition.
labelPosition : enumeration
Décrit la position de l'étiquette de la coupe.
| Constante | Description |
|---|---|
PieSlice.LabelOutside | L'étiquette est située à l'extérieur de la coupe à laquelle elle est reliée par un bras. Il s'agit de la valeur par défaut. |
PieSlice.LabelInsideHorizontal | L'étiquette est centrée à l'intérieur de la tranche et disposée horizontalement. |
PieSlice.LabelInsideTangential | L'étiquette est centrée à l'intérieur de la coupe et pivotée de manière à être parallèle à la tangente de l'arc de la coupe. |
PieSlice.LabelInsideNormal | L'étiquette est centrée à l'intérieur de la coupe et pivotée de manière à être parallèle à la normale de l'arc de la coupe. |
Voir aussi labelVisible.
labelVisible : bool
Visibilité de l'étiquette de la tranche. Par défaut, l'étiquette n'est pas visible.
percentage : real [read-only]
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. Elle est mise à jour automatiquement dès que la tranche est ajoutée à la série.
startAngle : real [read-only]
Angle de départ de cette part dans la série à laquelle elle appartient. Un cercle complet mesure 360 degrés, 0 degré correspondant à la position 12 heures. Cette valeur est mise à jour automatiquement dès que la part est ajoutée à la série.
value : real
La valeur de la tranche.
Remarque : une valeur négative est convertie en valeur positive.
Documentation sur les signaux
clicked()
Ce signal est émis lorsqu'on clique sur la tranche.
Le gestionnaire de signal correspondant est onClicked().
Remarque : le gestionnaire correspondant est onClicked.
doubleClicked()
Ce signal est émis lorsque l'utilisateur double-clique sur la tranche.
Le gestionnaire de signal correspondant est onDoubleClicked().
Remarque : le gestionnaire correspondant est onDoubleClicked.
hovered(bool state)
Ce signal est émis lorsqu'une souris survole la tranche. Lorsque la souris passe sur la tranche, state devient true, et lorsque la souris s'en éloigne à nouveau, il devient false.
Le gestionnaire de signal correspondant est onHovered().
Remarque : le gestionnaire correspondant est onHovered.
pressed()
Ce signal est émis lorsque l'utilisateur clique sur la tranche et maintient le bouton de la souris enfoncé.
Le gestionnaire de signal correspondant est onPressed().
Remarque : le gestionnaire correspondant est onPressed.
released()
Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur la tranche.
Le gestionnaire de signal correspondant est onReleased().
Remarque : le gestionnaire correspondant est onReleased.
© 2026 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.