PieSlice QML Type
Représente une seule part d'une série de camemberts. Plus d'informations...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QPieSlice |
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 tranche de tarte a une valeur et une étiquette. Lorsque la part est ajoutée à une série de camemberts, le type PieSeries 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 cachée. Si elle est visible, elle peut être soit située à l'extérieur de la tranche et reliée à celle-ci par un bras, soit centrée à l'intérieur de la tranche, soit horizontalement, soit parallèlement à la tangentielle ou à la normale de l'arc de la tranche.
Par défaut, l'apparence visuelle de la tranche est définie par un thème, mais ce thème peut être remplacé en spécifiant les propriétés de la tranche. Toutefois, si le thème est modifié après que les tranches ont été personnalisées, toutes les personnalisations seront perdues.
Le type PieSlice doit être utilisé comme enfant d'un type PieSeries. Par exemple, le type PieSlice peut être utilisé comme enfant d'un type :
Il est également possible d'ajouter des parts à une série de camemberts en utilisant la méthode PieSeries.append().
Dans ce cas, PieSeries.at() ou PieSeries.find peut être utilisé pour accéder aux propriétés d'une instance individuelle de PieSlice.
Voir également PieSeries.
Documentation sur les propriétés
angleSpan : real [read-only]
L'étendue de la tranche en degrés. Une tarte complète fait 360 degrés, où 0 degré est à 12 heures. Mise à jour automatique dès que la tranche est ajoutée à la série.
borderColor : color
La couleur utilisée pour dessiner le bord de la tranche (couleur du stylo).
Voir aussi borderWidth.
borderWidth : int
La largeur de la bordure de la tranche. Il s'agit d'une propriété de commodité permettant de modifier l'enclos de la tranche.
Voir aussi borderColor.
brushFilename : string
Le 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 tranche est éclatée.
- 1,0 signifie que la distance est égale au rayon.
- 0,5 signifie que la distance est égale à la moitié du rayon.
Par défaut, la distance est de 0,15
Voir aussi exploded.
exploded : bool
Si la tranche est séparée de la tarte.
Voir aussi explodeDistanceFactor.
label : string
L'étiquette de la tranche.
Note : La chaîne peut être formatée en HTML.
labelArmLengthFactor : real
La longueur du bras de l'étiquette. Le facteur est relatif au rayon de la tarte. 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 aussi labelVisible.
labelColor : color
La couleur utilisée pour dessiner l'étiquette de la tranche.
labelFont : font
Police utilisée pour l'étiquette de la tranche.
Pour plus d'informations, voir font.
Voir également labelVisible et labelPosition.
labelPosition : enumeration
Décrit la position de l'étiquette de la tranche.
| Constante | Description de la position de l'étiquette de la tranche |
|---|---|
PieSlice.LabelOutside | L'étiquette est située à l'extérieur de la tranche à laquelle elle est reliée par un bras. Il s'agit de la valeur par défaut. |
PieSlice.LabelInsideHorizontal | L'étiquette est centrée dans la tranche et disposée horizontalement. |
PieSlice.LabelInsideTangential | L'étiquette est centrée dans la tranche et tournée pour être parallèle à la tangente de l'arc de la tranche. |
PieSlice.LabelInsideNormal | L'étiquette est centrée dans la tranche et tournée pour être parallèle à la normale de l'arc de la tranche. |
Voir aussi labelVisible.
labelVisible : bool
La visibilité de l'étiquette de la tranche. Par défaut, l'étiquette n'est pas visible.
percentage : real [read-only]
Le 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. Mise à jour automatique dès que la tranche est ajoutée à la série.
startAngle : real [read-only]
L'angle de départ de cette tranche dans la série à laquelle elle appartient. Une tarte complète fait 360 degrés, où 0 degré est à 12 heures. Mis à jour automatiquement lorsque la tranche 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 lorsque la tranche est cliquée.
Le gestionnaire de signal correspondant est onClicked().
Note : 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().
Note : Le gestionnaire correspondant est onDoubleClicked.
hovered(bool state)
Ce signal est émis lorsque la souris passe au-dessus de la tranche. 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()
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().
Note : Le gestionnaire correspondant est onPressed.
released()
Ce signal est émis lorsque l'utilisateur relâche la pression de la souris sur la tranche.
Le gestionnaire de signal correspondant est onReleased().
Note : 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.
