QPieSeries Class
La classe QPieSeries permet de représenter des données sous forme de graphiques circulaires. En savoir plus...
| Header: | #include <QPieSeries> |
| In QML: | PieSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
|
|
Fonctions publiques
| QPieSeries(QObject *parent = nullptr) | |
| virtual | ~QPieSeries() |
| bool | append(QPieSlice *slice) |
| bool | append(const QList<QPieSlice *> &slices) |
| QPieSlice * | append(const QString &label, qreal value) |
| void | clear() |
| int | count() const |
| qreal | holeSize() const |
| qreal | horizontalPosition() const |
| bool | insert(int index, QPieSlice *slice) |
| bool | isEmpty() const |
| qreal | pieEndAngle() const |
| qreal | pieSize() const |
| qreal | pieStartAngle() const |
| bool | remove(QPieSlice *slice) |
| void | setHoleSize(qreal holeSize) |
| void | setHorizontalPosition(qreal relativePosition) |
| void | setLabelsPosition(QPieSlice::LabelPosition position) |
| void | setLabelsVisible(bool visible = true) |
| void | setPieEndAngle(qreal angle) |
| void | setPieSize(qreal relativeSize) |
| void | setPieStartAngle(qreal startAngle) |
| void | setVerticalPosition(qreal relativePosition) |
| QList<QPieSlice *> | slices() const |
| qreal | sum() const |
| bool | take(QPieSlice *slice) |
| qreal | verticalPosition() const |
| QPieSeries & | operator<<(QPieSlice *slice) |
Fonctions publiques réimplémentées
| virtual QAbstractSeries::SeriesType | type() const override |
Signaux
| void | added(const QList<QPieSlice *> &slices) |
| void | clicked(QPieSlice *slice) |
| void | countChanged() |
| void | doubleClicked(QPieSlice *slice) |
| void | hovered(QPieSlice *slice, bool state) |
| void | pressed(QPieSlice *slice) |
| void | released(QPieSlice *slice) |
| void | removed(const QList<QPieSlice *> &slices) |
| void | sumChanged() |
Description détaillée
Une série de diagrammes circulaires est composée de segments définis comme des objets ` QPieSlice `. Les segments peuvent prendre n'importe quelle valeur, car l'objet `QPieSeries` calcule le pourcentage d'un segment par rapport à la somme de tous les segments de la série afin de déterminer la taille réelle du segment dans le graphique.
La taille et la position du graphique circulaire sur le graphique sont contrôlées à l’aide de valeurs relatives comprises entre 0,0 et 1,0. Celles-ci se rapportent au rectangle réel du graphique.
Par défaut, le graphique circulaire est défini comme un graphique complet. Il est possible de créer un graphique partiel en définissant un angle de départ et une plage d’angles pour la série. Un graphique complet correspond à 360 degrés, 0 correspondant à 12 heures.
Consultez la galerie « Graphiques avec widgets » pour découvrir comment utiliser QPieSeries.
Voir également QPieSlice et QChart.
Documentation sur les propriétés
[read-only] count : int
Cette propriété indique le nombre de tranches de la série.
Fonctions d'accès :
| int | count() const |
Signal de notification :
| void | countChanged() |
endAngle : qreal
Cette propriété contient l'angle de fin du secteur.
Un cercle complet correspond à 360 degrés, 0 degré correspondant à 12 heures.
La valeur par défaut est 360.
Fonctions d'accès :
| qreal | pieEndAngle() const |
| void | setPieEndAngle(qreal angle) |
holeSize : qreal
Cette propriété définit la taille du trou du beignet.
La valeur est relative au rectangle du graphique, de sorte que :
- 0,0 correspond à la taille minimale (tarte complète dessinée sans trou).
- 1,0 correspond à la taille maximale pouvant tenir dans le graphique (le beignet n'a pas de largeur).
Lors de la définition de cette propriété, la propriété ` size ` est ajustée si nécessaire, afin de garantir que la taille du trou ne dépasse pas celle du camembert.
La valeur par défaut est 0,0.
Fonctions d'accès :
| qreal | holeSize() const |
| void | setHoleSize(qreal holeSize) |
horizontalPosition : qreal
Cette propriété définit la position horizontale du graphique circulaire.
La valeur est relative au rectangle du graphique, de sorte que :
- 0,0 correspond à l'extrême gauche.
- 1,0 correspond à l'extrême droite.
La valeur par défaut est 0,5 (au centre).
Fonctions d'accès :
| qreal | horizontalPosition() const |
| void | setHorizontalPosition(qreal relativePosition) |
Voir également verticalPosition.
size : qreal
Cette propriété définit la taille du diagramme circulaire.
La valeur est relative au rectangle du graphique, de sorte que :
- 0,0 correspond à la taille minimale (le graphique n’est pas affiché).
- 1,0 correspond à la taille maximale pouvant tenir dans le graphique.
Lors de la définition de cette propriété, la propriété « holeSize » est ajustée si nécessaire, afin de garantir que la taille du trou ne soit pas supérieure à celle du graphique circulaire.
La valeur par défaut est 0,7.
Fonctions d’accès :
| qreal | pieSize() const |
| void | setPieSize(qreal relativeSize) |
startAngle : qreal
Cette propriété contient l'angle de départ du secteur circulaire.
Un cercle complet correspond à 360 degrés, 0 degré correspondant à 12 heures.
La valeur par défaut est 0.
Fonctions d'accès :
| qreal | pieStartAngle() const |
| void | setPieStartAngle(qreal startAngle) |
[read-only] sum : qreal
Cette propriété contient la somme de toutes les tranches.
La série garde la trace de la somme de toutes les tranches qu'elle contient.
Fonctions d'accès :
| qreal | sum() const |
Signal de notification :
| void | sumChanged() |
verticalPosition : qreal
Cette propriété définit la position verticale du graphique circulaire.
La valeur est relative au rectangle du graphique, de sorte que :
- 0,0 correspond au sommet absolu.
- 1,0 correspond au bas absolu.
La valeur par défaut est 0,5 (centre).
Fonctions d’accès :
| qreal | verticalPosition() const |
| void | setVerticalPosition(qreal relativePosition) |
Voir également horizontalPosition.
Documentation sur les fonctions membres
[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)
Crée un objet de série qui est un enfant de parent.
[virtual noexcept] QPieSeries::~QPieSeries()
Supprime la série « tarte » et ses parts.
[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)
Ce signal est émis lorsque les tranches spécifiées par slices sont ajoutées à la série.
Voir également append() et insert().
bool QPieSeries::append(QPieSlice *slice)
Ajoute la tranche spécifiée par slice à la série. La propriété de la tranche est transférée à la série.
Renvoie true si l'ajout aboutit.
bool QPieSeries::append(const QList<QPieSlice *> &slices)
Ajoute à la série le tableau de tranches spécifié par ` slices `. La propriété des tranches est transférée à la série.
Renvoie true si l'ajout aboutit.
QPieSlice *QPieSeries::append(const QString &label, qreal value)
Ajoute à la série une seule tranche dont les paramètres « value » et « label » sont spécifiés. La propriété de la tranche est transférée à la série. Renvoie null si « value » est « NaN », « Inf » ou « -Inf » et n’ajoute rien à la série.
void QPieSeries::clear()
Supprime toutes les tranches de la série.
[signal] void QPieSeries::clicked(QPieSlice *slice)
Ce signal est émis lorsqu'on clique sur la tranche spécifiée par slice.
Voir également QPieSlice::clicked().
int QPieSeries::count() const
Renvoie le nombre de tranches de cette série.
Remarque : fonctiongetter pour la propriété count.
[signal] void QPieSeries::countChanged()
Ce signal est émis lorsque le nombre de tranches change.
Remarque : signalde notification pour la propriété count.
Voir également count.
[signal] void QPieSeries::doubleClicked(QPieSlice *slice)
Ce signal est émis lorsqu'on double-clique sur la tranche spécifiée par slice.
Voir également QPieSlice::doubleClicked().
[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)
Ce signal est émis lorsqu'un curseur de souris survole la tranche spécifiée par slice. Lorsque la souris survole la tranche, state devient true, et lorsque la souris s'en éloigne, il redevient false.
Voir également QPieSlice::hovered().
bool QPieSeries::insert(int index, QPieSlice *slice)
Insère la tranche spécifiée par slice dans la série, avant la tranche située à la position indiquée par index. La propriété de la tranche est transférée à la série.
Renvoie true si l'insertion réussit.
bool QPieSeries::isEmpty() const
Renvoie « true » si la série est vide.
qreal QPieSeries::pieEndAngle() const
Renvoie l'angle final du secteur.
Un cercle complet mesure 360 degrés, 0 degré correspondant à 12 heures.
Remarque : fonctionde lecture pour la propriété endAngle.
Voir également setPieEndAngle(), pieStartAngle() et setPieStartAngle().
[signal] void QPieSeries::pressed(QPieSlice *slice)
Ce signal est émis lorsque l'utilisateur clique sur la tranche spécifiée par slice et maintient le bouton de la souris enfoncé.
Voir également QPieSlice::pressed().
[signal] void QPieSeries::released(QPieSlice *slice)
Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur la tranche spécifiée par slice.
Voir également QPieSlice::released().
bool QPieSeries::remove(QPieSlice *slice)
Supprime une seule tranche, spécifiée par ` slice`, de la série et la supprime définitivement.
Le pointeur ne peut plus être référencé après cet appel.
Renvoie ` true ` si la suppression a réussi.
[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)
Ce signal est émis lorsque les tranches spécifiées par slices sont supprimées de la série.
Voir également remove().
void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)
Définit la position de toutes les étiquettes de tranches sur position.
Remarque : cette fonction n'affecte que les tranches actuelles de la série. Si une nouvelle tranche est ajoutée, la position par défaut de l'étiquette est QPieSlice::LabelOutside.
Voir également QPieSlice::labelPosition() et QPieSlice::setLabelPosition().
void QPieSeries::setLabelsVisible(bool visible = true)
Définit la visibilité de toutes les étiquettes de tranches sur « visible ».
Remarque : cette fonction n'affecte que les tranches actuelles de la série. Si une nouvelle tranche est ajoutée, la visibilité par défaut des étiquettes est « false ».
Voir également QPieSlice::isLabelVisible() et QPieSlice::setLabelVisible().
void QPieSeries::setPieEndAngle(qreal angle)
Définit l'angle de fin du secteur circulaire.
Un cercle complet correspond à 360 degrés, 0 degré correspondant à 12 heures.
angle Doit être supérieur à l'angle de départ.
Remarque : fonctionde définition de la propriété endAngle.
Voir également pieEndAngle(), pieStartAngle() et setPieStartAngle().
QList<QPieSlice *> QPieSeries::slices() const
Renvoie une liste des tranches appartenant à cette série.
qreal QPieSeries::sum() const
Renvoie la somme de toutes les valeurs des tranches de cette série.
Remarque : fonctiongetter pour la propriété sum.
Voir également QPieSlice::value(), QPieSlice::setValue() et QPieSlice::percentage().
[signal] void QPieSeries::sumChanged()
Ce signal est émis lorsque la somme de toutes les tranches change.
Remarque : signalde notification pour la propriété sum.
Voir également sum.
bool QPieSeries::take(QPieSlice *slice)
Récupère une seule tranche, spécifiée par slice, à partir de la série. Ne supprime pas l'objet « tranche ».
Remarque : la série reste l'objet parent de la tranche. Vous devez définir l'objet parent pour en prendre pleinement possession.
Renvoie true si l'opération de prélèvement a réussi.
[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const
Réimplémente une fonction d'accès pour la propriété : QAbstractSeries::type.
Renvoie le type de la série.
QPieSeries &QPieSeries::operator<<(QPieSlice *slice)
Ajoute la tranche spécifiée par ` slice ` à la série et renvoie une référence à celle-ci. La propriété de la tranche est transférée à la série.
© 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.
