QPieSeries Class
La classe QPieSeries présente des données sous forme de diagrammes circulaires. Plus d'informations...
| Header: | #include <QPieSeries> |
| In QML: | PieSeries |
| Inherits: | QAbstractSeries |
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 camemberts se compose de tranches définies en tant qu'objets QPieSlice. Les tranches peuvent avoir n'importe quelle valeur car l'objet QPieSeries calcule le pourcentage d'une tranche par rapport à la somme de toutes les tranches de la série pour déterminer la taille réelle de la tranche dans le graphique.
La taille et la position des parts dans le graphique sont contrôlées par des valeurs relatives comprises entre 0,0 et 1,0. Ces valeurs se rapportent au rectangle du graphique.
Par défaut, le camembert est défini comme un camembert complet. Il est possible de créer un camembert partiel en définissant un angle de départ et une plage d'angles pour la série. Une tarte complète représente 360 degrés, où 0 est à 12 heures.
Voir la galerie Charts with Widgets pour apprendre à utiliser QPieSeries.
Voir également QPieSlice et QChart.
Documentation sur les propriétés
[read-only] count : int
Cette propriété contient 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é indique l'angle final de la tarte.
Une tarte complète a un angle de 360 degrés, 0 degré étant à 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é indique la taille du trou du beignet.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 est la taille minimale (tarte complète dessinée sans trou).
- 1.0 est la taille maximale que peut avoir le graphique (le beignet n'a pas de largeur).
Lors du réglage de cette propriété, la propriété size est ajustée si nécessaire, afin de s'assurer que la taille du trou n'est pas supérieure à la taille de la tarte.
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 camembert.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 correspond à la gauche absolue.
- 1.0 correspond à la droite absolue.
La valeur par défaut est 0,5 (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 camembert.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 est la taille minimale (la tarte n'est pas dessinée).
- 1.0 est la taille maximale qui peut s'adapter au graphique.
Lors du réglage de cette propriété, la propriété holeSize est ajustée si nécessaire, afin de s'assurer que la taille du trou n'est pas supérieure à la taille de la tarte.
La valeur par défaut est 0,7.
Fonctions d'accès :
| qreal | pieSize() const |
| void | setPieSize(qreal relativeSize) |
startAngle : qreal
Cette propriété indique l'angle de départ de la tarte.
Une tarte complète a un angle de 360 degrés, 0 degré étant à 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 camembert.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 est le haut absolu.
- 1.0 est le 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)
Construit un objet série qui est un enfant de parent.
[virtual noexcept] QPieSeries::~QPieSeries()
Supprime la série de camemberts et ses tranches.
[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 aussi 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 transmise à la série.
Retourne true si l'ajout est réussi.
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 transmise à la série.
Retourne true si l'ajout est réussi.
QPieSlice *QPieSeries::append(const QString &label, qreal value)
Ajoute à la série une tranche unique avec les adresses value et label spécifiées. La propriété de la tranche est transmise à la série. Renvoie null si value est NaN, Inf, ou -Inf et n'ajoute rien à la série.
void QPieSeries::clear()
Efface toutes les tranches de la série.
[signal] void QPieSeries::clicked(QPieSlice *slice)
Ce signal est émis lorsque la tranche spécifiée par slice est cliquée.
Voir aussi QPieSlice::clicked().
int QPieSeries::count() const
Renvoie le nombre de tranches de cette série.
Remarque : fonction Getter pour la propriété count.
[signal] void QPieSeries::countChanged()
Ce signal est émis lorsque le nombre de tranches change.
Note : Signal de notification pour la propriété count.
Voir également count.
[signal] void QPieSeries::doubleClicked(QPieSlice *slice)
Ce signal est émis lorsque la tranche spécifiée par slice est double-cliquée.
Voir aussi QPieSlice::doubleClicked().
[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)
Ce signal est émis lorsque la souris survole la tranche spécifiée par slice. Lorsque la souris passe au-dessus de la tranche, state devient true, et lorsque la souris s'éloigne à nouveau, il devient false.
Voir aussi 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 à la position spécifiée par index. La propriété de la tranche est transmise à la série.
Retourne 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 de la tarte.
Une tarte complète représente 360 degrés, 0 degré étant à 12 heures.
Remarque : fonction Getter 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 aussi QPieSlice::pressed().
[signal] void QPieSeries::released(QPieSlice *slice)
Ce signal est émis lorsque l'utilisateur relâche la pression 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 l'efface définitivement.
Le pointeur ne peut plus être référencé après cet appel.
Retourne true si la suppression est réussie.
[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)
Ce signal est émis lorsque les tranches spécifiées par slices sont retirées de la série.
Voir aussi remove().
void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)
Définit la position de toutes les étiquettes des tranches à 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 final de la tarte.
Une tarte complète est de 360 degrés, 0 degré étant à 12 heures.
angle doit être supérieur à l'angle de départ.
Remarque : fonction de définition de la propriété endAngle.
Voir également pieEndAngle(), pieStartAngle() et setPieStartAngle().
QList<QPieSlice *> QPieSeries::slices() const
Renvoie une liste de tranches appartenant à cette série.
qreal QPieSeries::sum() const
Renvoie la somme de toutes les valeurs des tranches de cette série.
Remarque : fonction Getter pour la propriété sum.
Voir aussi QPieSlice::value(), QPieSlice::setValue() et QPieSlice::percentage().
[signal] void QPieSeries::sumChanged()
Ce signal est émis lorsque la somme de toutes les tranches change.
Note : Signal de notification pour la propriété sum.
Voir également sum.
bool QPieSeries::take(QPieSlice *slice)
Prend une seule tranche, spécifiée par slice, 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 qu'il devienne propriétaire.
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 à 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 à la série. La propriété de la tranche est transmise à 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.
