Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QPieSlice Class

La classe QPieSlice représente une seule tranche d'une série de tartes. Plus d'informations...

Header: #include <QPieSlice>
In QML: PieSlice
Inherits: QObject

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 tranche de tarte a 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 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 le 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.

Pour permettre à l'utilisateur d'interagir avec le diagramme circulaire, certains signaux de base sont émis lorsque les utilisateurs cliquent sur les tranches ou passent la souris au-dessus d'elles.

Voir également QPieSeries.

Documentation sur les types de membres

enum QPieSlice::LabelPosition

Cette énumération décrit la position de l'étiquette de la tranche.

ConstanteValeurDescription de la position de l'étiquette
QPieSlice::LabelOutside0L'é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.
QPieSlice::LabelInsideHorizontal1L'étiquette est centrée dans la tranche et disposée horizontalement.
QPieSlice::LabelInsideTangential2L'étiquette est centrée dans la tranche et tournée pour être parallèle à la tangente de l'arc de la tranche.
QPieSlice::LabelInsideNormal3L'étiquette est centrée dans la tranche et tournée pour être parallèle à la normale de l'arc de la tranche.

Documentation sur les propriétés

[read-only] angleSpan : qreal

Cette propriété indique l'étendue de la tranche en degrés. Une tarte complète représente 360 degrés, où 0 degré correspond à 12 heures. Cette propriété est mise à jour automatiquement lorsque la tranche est ajoutée à la série.

Fonctions d'accès :

qreal angleSpan() const

Signal Notifier :

void angleSpanChanged()

borderColor : QColor

Cette propriété définit la couleur utilisée pour dessiner la bordure de la tranche. Il s'agit d'une propriété de commodité permettant de modifier le stylo de la tranche.

Fonctions d'accès :

QColor borderColor()
void setBorderColor(QColor color)

Signal du notificateur :

void borderColorChanged()

Voir aussi 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é de commodité permettant de modifier l'enclos de la tranche.

Fonctions d'accès :

int borderWidth()
void setBorderWidth(int width)

Signal du notificateur :

void borderWidthChanged()

Voir aussi pen et borderColor.

brush : QBrush

Cette propriété contient la brosse utilisée pour remplir la tranche.

Fonctions d'accès :

QBrush brush() const
void setBrush(const QBrush &brush)

Signal du notificateur :

void brushChanged()

color : QColor

Cette propriété définit la couleur de remplissage (pinceau) de la tranche. Il s'agit d'une propriété de commodité permettant de modifier le pinceau de la tranche.

Fonctions d'accès :

QColor color()
void setColor(QColor color)

Signal du notificateur :

void colorChanged()

Voir aussi brush.

explodeDistanceFactor : qreal

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

Fonctions d'accès :

qreal explodeDistanceFactor() const
void setExplodeDistanceFactor(qreal factor)

Voir aussi exploded.

exploded : bool

Cette propriété indique si la tranche 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 l'étiquette de la tranche.

Remarque : la chaîne peut être formatée au format HTML.

Fonctions d'accès :

QString label() const
void setLabel(QString label)

Signal Notificateur :

void labelChanged()

Voir aussi labelVisible, labelBrush, labelFont, et labelArmLengthFactor.

labelArmLengthFactor : qreal

Cette propriété définit 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.

Fonctions d'accès :

qreal labelArmLengthFactor() const
void setLabelArmLengthFactor(qreal factor)

Voir aussi label, labelVisible, labelBrush, et labelFont.

labelBrush : QBrush

Cette propriété contient la brosse utilisée pour dessiner l'étiquette et le bras de l'étiquette de la tranche.

Fonctions d'accès :

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Signal Notifier :

void labelBrushChanged()

Voir aussi label, labelVisible, labelFont, et labelArmLengthFactor.

labelColor : QColor

Cette propriété définit la couleur utilisée pour dessiner l'étiquette de la tranche. Il s'agit d'une propriété de commodité permettant de modifier la brosse de l'étiquette de la tranche.

Fonctions d'accès :

QColor labelColor()
void setLabelColor(QColor color)

Signal Notifier :

void labelColorChanged()

Voir aussi labelBrush.

labelFont : QFont

Cette propriété définit la police utilisée pour dessiner le texte de l'étiquette.

Fonctions d'accès :

QFont labelFont() const
void setLabelFont(const QFont &font)

Signal Notificateur :

void labelFontChanged()

Voir aussi label, labelVisible, et labelArmLengthFactor.

labelPosition : LabelPosition

Cette propriété indique la position de l'étiquette de la tranche.

Fonctions d'accès :

QPieSlice::LabelPosition labelPosition()
void setLabelPosition(QPieSlice::LabelPosition position)

Voir aussi label et labelVisible.

labelVisible : bool

Cette propriété définit 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 du notificateur :

void labelVisibleChanged()

Voir aussi label, labelBrush, labelFont, et labelArmLengthFactor.

pen : QPen

Cette propriété contient le stylo utilisé pour dessiner la bordure de la tranche.

Fonctions d'accès :

QPen pen() const
void setPen(const QPen &pen)

Signal du notificateur :

void penChanged()

[read-only] percentage : qreal

Cette propriété indique 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. Elle est mise à jour automatiquement lorsque la tranche est ajoutée à la série.

Fonctions d'accès :

qreal percentage() const

Signal de notification :

void percentageChanged()

Voir aussi value et QPieSeries::sum.

[read-only] startAngle : qreal

Cette propriété contient 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. Cette propriété est mise à jour automatiquement lorsque la tranche est ajoutée à la série.

Fonctions d'accès :

qreal startAngle() const

Signal Notifier :

void startAngleChanged()

value : qreal

Cette propriété contient la valeur de la tranche.

Note : Une valeur négative est convertie en valeur positive.

Fonctions d'accès :

qreal value() const
void setValue(qreal value)

Signal Notifier :

void valueChanged()

Voir aussi percentage() et QPieSeries::sum().

Documentation des fonctions membres

[explicit] QPieSlice::QPieSlice(QObject *parent = nullptr)

Construit une tranche vide avec le parent parent.

Voir aussi QPieSeries::append() et QPieSeries::insert().

QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)

Construit une tranche vide avec les éléments spécifiés value, label, et parent.

Voir aussi 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'angle de la tranche change.

Note : Signal de notification pour la propriété angleSpan.

Voir également angleSpan.

[signal] void QPieSlice::borderColorChanged()

Ce signal est émis lorsque la couleur de la bordure de la tranche change.

Note : Signal de 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.

Note : Signal de notification pour la propriété borderWidth.

Voir également pen et borderWidth.

[signal] void QPieSlice::brushChanged()

Ce signal est émis lorsque la brosse utilisée pour remplir la tranche change.

Note : Signal de notification pour la propriété brush.

Voir également brush.

[signal] void QPieSlice::clicked()

Ce signal est émis lorsque la tranche est cliquée.

Voir également QPieSeries::clicked().

[signal] void QPieSlice::colorChanged()

Ce signal est émis lorsque la couleur de la tranche change.

Note : Signal de notification pour la propriété color.

Voir aussi 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 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.

Voir aussi QPieSeries::hovered().

[signal] void QPieSlice::labelBrushChanged()

Ce signal est émis lorsque le pinceau de l'étiquette de la tranche change.

Note : Signal de notification pour la propriété labelBrush.

Voir également labelBrush.

[signal] void QPieSlice::labelChanged()

Ce signal est émis lorsque l'étiquette de la tranche change.

Note : Signal de notification pour la propriété label.

Voir également label.

[signal] void QPieSlice::labelColorChanged()

Ce signal est émis lorsque la couleur de l'étiquette de la tranche change.

Note : Signal de notification pour la propriété labelColor.

Voir aussi labelColor.

[signal] void QPieSlice::labelFontChanged()

Ce signal est émis lorsque la police de l'étiquette de la tranche change.

Note : Signal de notification pour la propriété labelFont.

Voir également labelFont.

[signal] void QPieSlice::labelVisibleChanged()

Ce signal est émis lorsque la visibilité de l'étiquette de la tranche change.

Note : Signal de notification pour la propriété labelVisible.

Voir également labelVisible.

[signal] void QPieSlice::penChanged()

Ce signal est émis lorsque le stylo utilisé pour dessiner la bordure de la tranche change.

Remarque : signal de notification pour la propriété pen.

Voir également pen.

[signal] void QPieSlice::percentageChanged()

Ce signal est émis lorsque le pourcentage de la tranche change.

Note : Signal de 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 la pression de la souris sur la tranche.

Voir également QPieSeries::released().

QPieSeries *QPieSlice::series() const

Renvoie la série à laquelle appartient cette tranche.

Voir également QPieSeries::append().

[signal] void QPieSlice::startAngleChanged()

Ce signal est émis lorsque l'angle de départ de la tranche change.

Note : Signal de notification pour la propriété startAngle.

Voir également startAngle.

[signal] void QPieSlice::valueChanged()

Ce signal est émis lorsque la valeur de la tranche change.

Note : Signal de 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.