QPieSlice Class

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

En-tête : #include <QPieSlice>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : PieSlice
Héritages : QObject

Types publics

enum class LabelPosition { Outside, InsideHorizontal, InsideTangential, InsideNormal }

Propriétés

Fonctions publiques

QPieSlice(QObject *parent = nullptr)
QPieSlice(const QString &label, qreal value, QObject *parent = nullptr)
virtual ~QPieSlice() override
qreal angleSpan() const
QColor borderColor() const
qreal borderWidth() const
QColor color() const
qreal explodeDistanceFactor() const
bool isExploded() const
bool isLabelVisible() const
QString label() const
qreal labelArmLengthFactor() const
QColor labelColor() const
QFont labelFont() const
QPieSlice::LabelPosition labelPosition()
qreal percentage() const
QPieSeries *series() const
void setBorderColor(QColor color)
void setBorderWidth(qreal borderWidth)
void setColor(QColor color)
void setExplodeDistanceFactor(qreal factor)
void setExploded(bool exploded)
void setLabel(const QString &label)
void setLabelArmLengthFactor(qreal factor)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setLabelPosition(QPieSlice::LabelPosition position)
void setLabelVisible(bool visible = true)
void setValue(qreal value)
qreal startAngle() const
qreal value() const

Signaux

Description détaillée

Une part 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 graphique à secteurs, certains signaux de base sont émis lorsque l'utilisateur clique sur les tranches ou passe la souris au-dessus d'elles.

Voir aussi QPieSeries.

Documentation sur les types de membres

enum class QPieSlice::LabelPosition

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

ConstanteValeurDescription de la position de l'étiquette
QPieSlice::LabelPosition::Outside0L'é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::LabelPosition::InsideHorizontal1L'étiquette est centrée dans la tranche et disposée horizontalement.
QPieSlice::LabelPosition::InsideTangential2L'étiquette est centrée dans la tranche et tournée pour être parallèle à la tangente de l'arc de la tranche.
QPieSlice::LabelPosition::InsideNormal3L'é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 : const 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 la tranche.

Fonctions d'accès :

QColor borderColor() const
void setBorderColor(QColor color)

Signal Notificateur :

void borderColorChanged()

Voir aussi borderWidth.

borderWidth : qreal

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 la largeur de la bordure de la tranche.

Fonctions d'accès :

qreal borderWidth() const
void setBorderWidth(qreal borderWidth)

Signal du notificateur :

void borderWidthChanged()

Voir aussi borderColor.

color : QColor

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

Fonctions d'accès :

QColor color() const
void setColor(QColor color)

Signal du notificateur :

void colorChanged()

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)

Signal de notification :

void explodeDistanceFactorChanged()

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)

Signal de notification :

void explodedChanged()

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(const QString &label)

Signal du notificateur :

void labelChanged()

Voir aussi labelVisible, 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)

Signal de notification :

void labelArmLengthFactorChanged()

Voir aussi label, labelVisible, et labelFont.

labelColor : QColor

Cette propriété définit la couleur utilisée pour dessiner l'étiquette de la tranche.

Fonctions d'accès :

QColor labelColor() const
void setLabelColor(QColor color)

Signal du notificateur :

void labelColorChanged()

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)

Signal du notificateur :

void labelPositionChanged()

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, labelFont, et labelArmLengthFactor.

[read-only] percentage : const 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 : const 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(const 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().

[override virtual noexcept] QPieSlice::~QPieSlice()

Supprime la tranche. La tranche ne doit pas être supprimée si elle a été ajoutée à une série.

QPieSeries *QPieSlice::series() const

Renvoie la série à laquelle appartient cette tranche.

Voir également QPieSeries::append().

© 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.