QPieSlice Class
La classe QPieSlice représente une part individuelle d'une série de diagrammes circulaires. En savoir plus...
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal } |
Propriétés
|
|
Fonctions publiques
| QPieSlice(QObject *parent = nullptr) | |
| QPieSlice(QString label, qreal value, QObject *parent = nullptr) | |
| virtual | ~QPieSlice() |
| qreal | angleSpan() const |
| QColor | borderColor() |
| int | borderWidth() |
| QBrush | brush() const |
| QColor | color() |
| qreal | explodeDistanceFactor() const |
| bool | isExploded() const |
| bool | isLabelVisible() const |
| QString | label() const |
| qreal | labelArmLengthFactor() const |
| QBrush | labelBrush() const |
| QColor | labelColor() |
| QFont | labelFont() const |
| QPieSlice::LabelPosition | labelPosition() |
| QPen | pen() const |
| qreal | percentage() const |
| QPieSeries * | series() const |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(int width) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setExplodeDistanceFactor(qreal factor) |
| void | setExploded(bool exploded = true) |
| void | setLabel(QString label) |
| void | setLabelArmLengthFactor(qreal factor) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setLabelFont(const QFont &font) |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
| void | setLabelVisible(bool visible = true) |
| void | setPen(const QPen &pen) |
| void | setValue(qreal value) |
| qreal | startAngle() const |
| qreal | value() const |
Signaux
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | brushChanged() |
| void | clicked() |
| void | colorChanged() |
| void | doubleClicked() |
| void | hovered(bool state) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelVisibleChanged() |
| void | penChanged() |
| void | percentageChanged() |
| void | pressed() |
| void | released() |
| void | startAngleChanged() |
| void | valueChanged() |
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, l’objet QPieSeries 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.
Pour permettre l’interaction de l’utilisateur avec le diagramme circulaire, certains signaux de base sont émis lorsque les utilisateurs cliquent sur les parts du diagramme ou passent la souris dessus.
Voir également QPieSeries.
Documentation sur les types de membres
enum QPieSlice::LabelPosition
Cette énumération décrit la position de l'étiquette de tranche.
| Constante | Valeur | Description |
|---|---|---|
QPieSlice::LabelOutside | 0 | L'étiquette est située à l'extérieur de la coupe, reliée à celle-ci par un bras. Il s'agit de la valeur par défaut. |
QPieSlice::LabelInsideHorizontal | 1 | L'étiquette est centrée à l'intérieur de la coupe et disposée horizontalement. |
QPieSlice::LabelInsideTangential | 2 | L'étiquette est centrée à l'intérieur de la tranche et pivotée de manière à être parallèle à la tangente de l'arc de la tranche. |
QPieSlice::LabelInsideNormal | 3 | 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. |
Documentation sur les propriétés
[read-only] angleSpan : qreal
Cette propriété indique l'angle de la part en degrés. Un cercle complet correspond à 360 degrés, 0 degré correspondant à la position 12 heures. Elle est mise à jour automatiquement dès que la part est ajoutée à la série.
Fonctions d'accès :
| qreal | angleSpan() const |
Signal de notification :
| void | angleSpanChanged() |
borderColor : QColor
Cette propriété contient la couleur utilisée pour dessiner la bordure de la tranche. Il s'agit d'une propriété pratique permettant de modifier la couleur du trait de la tranche.
Fonctions d'accès :
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Signal de notification :
| void | borderColorChanged() |
Voir également pen et borderWidth.
borderWidth : int
Cette propriété définit la largeur de la bordure de la tranche. Il s'agit d'une propriété pratique permettant de modifier le trait de la tranche.
Fonctions d’accès :
| int | borderWidth() |
| void | setBorderWidth(int width) |
Signal de notification :
| void | borderWidthChanged() |
Voir également pen et borderColor.
brush : QBrush
Cette propriété contient le pinceau utilisé pour remplir la tranche.
Fonctions d'accès :
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
Signal de notification :
| void | brushChanged() |
color : QColor
Cette propriété définit la couleur de remplissage (pinceau) de la tranche. Il s'agit d'une propriété pratique permettant de modifier le pinceau de la tranche.
Fonctions d'accès :
| QColor | color() |
| void | setColor(QColor color) |
Signal de notification :
| void | colorChanged() |
Voir également brush.
explodeDistanceFactor : qreal
Détermine à quelle distance du camembert 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
Fonctions d'accès :
| qreal | explodeDistanceFactor() const |
| void | setExplodeDistanceFactor(qreal factor) |
Voir aussi exploded.
exploded : bool
Cette propriété indique si la part est séparée de la tarte.
Fonctions d'accès :
| bool | isExploded() const |
| void | setExploded(bool exploded = true) |
Voir aussi explodeDistanceFactor.
label : QString
Cette propriété contient le libellé de la tranche.
Remarque : la chaîne peut être au format HTML.
Fonctions d'accès :
| QString | label() const |
| void | setLabel(QString label) |
Signal de notification :
| void | labelChanged() |
Voir également labelVisible, labelBrush, labelFont et labelArmLengthFactor.
labelArmLengthFactor : qreal
Cette propriété indique la longueur du bras de l'étiquette. Cette valeur est exprimée par rapport au rayon du graphique circulaire. 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 segment est de 0,15
Fonctions d'accès :
| qreal | labelArmLengthFactor() const |
| void | setLabelArmLengthFactor(qreal factor) |
Voir également label, labelVisible, labelBrush et labelFont.
labelBrush : QBrush
Cette propriété contient le pinceau utilisé pour dessiner le libellé et le bras du libellé de la tranche.
Fonctions d'accès :
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
Signal de notification :
| void | labelBrushChanged() |
Voir également label, labelVisible, labelFont et labelArmLengthFactor.
labelColor : QColor
Cette propriété contient la couleur utilisée pour dessiner l'étiquette de la tranche. Il s'agit d'une propriété pratique permettant de modifier le pinceau de l'étiquette de la tranche.
Fonctions d'accès :
| QColor | labelColor() |
| void | setLabelColor(QColor color) |
Signal de notification :
| void | labelColorChanged() |
Voir également labelBrush.
labelFont : QFont
Cette propriété contient la police utilisée pour afficher le texte de l'étiquette.
Fonctions d'accès :
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
Signal de notification :
| void | labelFontChanged() |
Voir également label, labelVisible et labelArmLengthFactor.
labelPosition : LabelPosition
Cette propriété définit la position de l'étiquette de tranche.
Fonctions d'accès :
| QPieSlice::LabelPosition | labelPosition() |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
Voir également label et labelVisible.
labelVisible : bool
Cette propriété détermine la visibilité de l'étiquette de la tranche. Par défaut, l'étiquette n'est pas visible.
Fonctions d'accès :
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
Signal de notification :
| void | labelVisibleChanged() |
Voir également label, labelBrush, labelFont et labelArmLengthFactor.
pen : QPen
Cette propriété contient le stylo utilisé pour dessiner le contour de la tranche.
Fonctions d'accès :
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Signal de notification :
| void | penChanged() |
[read-only] percentage : qreal
Cette propriété indique le pourcentage représenté par 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.
Fonctions d'accès :
| qreal | percentage() const |
Signal de notification :
| void | percentageChanged() |
Voir également value et QPieSeries::sum.
[read-only] startAngle : qreal
Cette propriété contient l'angle de départ de cette part dans la série à laquelle elle appartient. Un cercle complet correspond à 360 degrés, 0 degré correspondant à la position 12 heures. Elle est mise à jour automatiquement dès que la part est ajoutée à la série.
Fonctions d'accès :
| qreal | startAngle() const |
Signal de notification :
| void | startAngleChanged() |
value : qreal
Cette propriété contient la valeur de la tranche.
Remarque : une valeur négative est convertie en valeur positive.
Fonctions d'accès :
| qreal | value() const |
| void | setValue(qreal value) |
Signal de notification :
| void | valueChanged() |
Voir également percentage() et QPieSeries::sum().
Documentation des fonctions membres
[explicit] QPieSlice::QPieSlice(QObject *parent = nullptr)
Crée une tranche vide à partir de l'parent parent.
Voir également QPieSeries::append() et QPieSeries::insert().
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)
Crée une tranche vide avec les paramètres spécifiés : value, label et parent.
Voir également QPieSeries::append() et QPieSeries::insert().
[virtual noexcept] QPieSlice::~QPieSlice()
Supprime la tranche. La tranche ne doit pas être supprimée si elle a été ajoutée à une série.
[signal] void QPieSlice::angleSpanChanged()
Ce signal est émis lorsque l'amplitude angulaire de la coupe change.
Remarque : signalde notification pour la propriété angleSpan.
Voir aussi angleSpan.
[signal] void QPieSlice::borderColorChanged()
Ce signal est émis lorsque la couleur de la bordure de la tranche change.
Remarque : signalde notification pour la propriété borderColor.
Voir également « pen » et « borderColor ».
[signal] void QPieSlice::borderWidthChanged()
Ce signal est émis lorsque la largeur de la bordure de la tranche change.
Remarque : signalde notification pour la propriété borderWidth.
Voir également pen et borderWidth.
[signal] void QPieSlice::brushChanged()
Ce signal est émis lorsque le pinceau utilisé pour remplir la tranche change.
Remarque : signalde notification pour la propriété brush.
Voir également brush.
[signal] void QPieSlice::clicked()
Ce signal est émis lorsqu'on clique sur la tranche.
Voir également QPieSeries::clicked().
[signal] void QPieSlice::colorChanged()
Ce signal est émis lorsque la couleur de la tranche change.
Remarque : signalde notification pour la propriété color.
Voir également brush.
[signal] void QPieSlice::doubleClicked()
Ce signal est émis lorsque l'utilisateur double-clique sur la tranche.
Voir également QPieSeries::doubleClicked().
[signal] void QPieSlice::hovered(bool state)
Ce signal est émis lorsque le curseur de la souris survole la tranche. Lorsque la souris survole la tranche, state devient true, et lorsque la souris s'en éloigne, il devient false.
Voir également QPieSeries::hovered().
[signal] void QPieSlice::labelBrushChanged()
Ce signal est émis lorsque le pinceau d'étiquetage de la tranche change.
Remarque : signalde notification pour la propriété labelBrush.
Voir également labelBrush.
[signal] void QPieSlice::labelChanged()
Ce signal est émis lorsque l'étiquette de la tranche change.
Remarque : signalde notification pour la propriété label.
Voir également label.
[signal] void QPieSlice::labelColorChanged()
Ce signal est émis lorsque la couleur de l'étiquette d'une tranche change.
Remarque : signalde notification pour la propriété labelColor.
Voir également labelColor.
[signal] void QPieSlice::labelFontChanged()
Ce signal est émis lorsque la police de caractères de l'étiquette de la tranche change.
Remarque : signalde notification pour la propriété labelFont.
Voir également labelFont.
[signal] void QPieSlice::labelVisibleChanged()
Ce signal est émis lorsque la visibilité de l'étiquette de tranche change.
Remarque : signalde notification pour la propriété labelVisible.
Voir également labelVisible.
[signal] void QPieSlice::penChanged()
Ce signal est émis lorsque le stylet utilisé pour tracer le contour de la tranche change.
Remarque : signalde notification pour la propriété pen.
Voir également pen.
[signal] void QPieSlice::percentageChanged()
Ce signal est émis lorsque le pourcentage de la tranche change.
Remarque : signalde notification pour la propriété percentage.
Voir également percentage.
[signal] void QPieSlice::pressed()
Ce signal est émis lorsque l'utilisateur clique sur la tranche et maintient le bouton de la souris enfoncé.
Voir également QPieSeries::pressed().
[signal] void QPieSlice::released()
Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur la tranche.
Voir également QPieSeries::released().
QPieSeries *QPieSlice::series() const
Renvoie la série à laquelle appartient cette tranche.
Voir aussi QPieSeries::append().
[signal] void QPieSlice::startAngleChanged()
Ce signal est émis lorsque l'angle de départ de la coupe change.
Remarque : signalde notification pour la propriété startAngle.
Voir également startAngle.
[signal] void QPieSlice::valueChanged()
Ce signal est émis lorsque la valeur de la tranche change.
Remarque : signalde notification pour la propriété value.
Voir également value.
© 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.
