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 |
- Liste de tous les membres, y compris les membres hérités
- QPieSlice fait partie de Qt Graphs Classes C++ pour 2D.
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
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | colorChanged() |
| void | explodeDistanceFactorChanged() |
| void | explodedChanged() |
| void | labelArmLengthFactorChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelPositionChanged() |
| void | labelVisibleChanged() |
| void | percentageChanged() |
| void | startAngleChanged() |
| void | valueChanged() |
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.
| Constante | Valeur | Description de la position de l'étiquette |
|---|---|---|
QPieSlice::LabelPosition::Outside | 0 | 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. |
QPieSlice::LabelPosition::InsideHorizontal | 1 | L'étiquette est centrée dans la tranche et disposée horizontalement. |
QPieSlice::LabelPosition::InsideTangential | 2 | L'étiquette est centrée dans la tranche et tournée pour être parallèle à la tangente de l'arc de la tranche. |
QPieSlice::LabelPosition::InsideNormal | 3 | L'é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.