QPieSeries Class
La classe QPieSeries présente des données sous forme de graphiques circulaires. Plus d'informations...
| En-tête : | #include <QPieSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | PieSeries |
| Héritages : | QAbstractSeries |
- Liste de tous les membres, y compris les membres hérités
- QPieSeries fait partie de Qt Graphs Classes C++ pour 2D.
Types publics
(since 6.10) enum class | LabelVisibility { None, First, Even, Odd } |
Propriétés
|
|
Fonctions publiques
| QPieSeries(QObject *parent = nullptr) | |
| QPieSeries::LabelVisibility | angleSpanLabelVisibility() const |
| qreal | angleSpanVisibleLimit() const |
| bool | append(QPieSlice *slice) |
| bool | append(const QList<QPieSlice *> &slices) |
| QPieSlice * | append(const QString &label, qreal value) |
| QPieSlice * | at(qsizetype index) |
| void | clear() |
| qsizetype | count() const |
| qreal | endAngle() const |
| QPieSlice * | find(const QString &label) |
| qreal | holeSize() const |
| qreal | horizontalPosition() const |
| bool | insert(qsizetype index, QPieSlice *slice) |
| bool | isEmpty() const |
| qreal | pieSize() const |
| bool | remove(QPieSlice *slice) |
| bool | remove(qsizetype index) |
| void | removeMultiple(qsizetype index, int count) |
| bool | replace(const QList<QPieSlice *> &slices) |
| bool | replace(QPieSlice *oldSlice, QPieSlice *newSlice) |
| bool | replace(qsizetype index, QPieSlice *slice) |
| void | setAngleSpanLabelVisibility(QPieSeries::LabelVisibility newAngleSpanVisibleMode) |
| void | setAngleSpanVisibleLimit(qreal newAngleSpanVisibleLimit) |
| void | setEndAngle(qreal angle) |
| void | setHoleSize(qreal holeSize) |
| void | setHorizontalPosition(qreal relativePosition) |
| void | setLabelsPosition(QPieSlice::LabelPosition position) |
| void | setLabelsVisible(bool visible) |
| void | setPieSize(qreal relativeSize) |
| void | setStartAngle(qreal angle) |
| void | setVerticalPosition(qreal relativePosition) |
| QList<QPieSlice *> | slices() const |
| qreal | startAngle() 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 | angleSpanLabelVisibilityChanged(QPieSeries::LabelVisibility visibility) |
| void | angleSpanVisibleLimitChanged(qreal limit) |
| void | countChanged() |
| void | endAngleChanged() |
| void | holeSizeChanged() |
| void | horizontalPositionChanged() |
| void | pieSizeChanged() |
| void | removed(const QList<QPieSlice *> &slices) |
| void | startAngleChanged() |
| void | sumChanged() |
| void | verticalPositionChanged() |
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 sur le graphique sont contrôlées à l'aide de valeurs relatives comprises entre 0,0 et 1,0. Ces valeurs se rapportent au rectangle du graphique.
Par défaut, la tarte est définie comme une tarte complète. Un camembert partiel peut être créé en définissant un angle de départ et une plage d'angles pour la série. Un graphique complet représente 360 degrés, où 0 est à 12 heures.
Voir également QPieSlice.
Documentation sur les types de membres
[since 6.10] enum class QPieSeries::LabelVisibility
Le mode de visibilité des étiquettes.
| Constante | Valeur | Description |
|---|---|---|
QPieSeries::LabelVisibility::None | 0 | Toutes les étiquettes des tranches dont l'angle d'ouverture est inférieur à angleSpanVisibleLimit sont masquées. |
QPieSeries::LabelVisibility::First | 1 | Toutes les étiquettes des tranches consécutives dont l'angle d'inclinaison est inférieur à angleSpanVisibleLimit sont masquées, à l'exception de la première. Il s'agit de la valeur par défaut. |
QPieSeries::LabelVisibility::Even | 2 | Toutes les autres étiquettes des tranches consécutives dont l'angle d'inclinaison est inférieur à angleSpanVisibleLimit seront masquées, en commençant par la deuxième. |
QPieSeries::LabelVisibility::Odd | 3 | Toutes les autres étiquettes des tranches consécutives dont l'angle est inférieur à celui de angleSpanVisibleLimit seront masquées à partir de la première. |
Cette énumération a été introduite dans Qt 6.10.
Voir aussi QPieSeries::angleSpanVisibleLimit.
Documentation sur les propriétés
[since 6.10] angleSpanLabelVisibility : LabelVisibility
Cette propriété définit le mode de visibilité des étiquettes.
Le mode qui détermine quelles étiquettes seront cachées si elles sont en dessous de la limite de l'étendue de l'angle définie avec angleSpanVisibleLimit. N'a pas d'effet si angleSpanVisibleLimit n'a pas été défini.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| QPieSeries::LabelVisibility | angleSpanLabelVisibility() const |
| void | setAngleSpanLabelVisibility(QPieSeries::LabelVisibility newAngleSpanVisibleMode) |
Signal Notifier :
| void | angleSpanLabelVisibilityChanged(QPieSeries::LabelVisibility visibility) |
Voir aussi QPieSeries::angleSpanVisibleLimit.
[since 6.10] angleSpanVisibleLimit : qreal
Cette propriété définit la limite de l'angle de visibilité de l'étiquette.
Il s'agit de l'étendue d'angle qui sera utilisée comme limite de visibilité pour l'étiquette d'une tranche. Une tranche dont l'angle est inférieur à cette valeur verra sa visibilité modifiée en fonction de l'adresse angleSpanLabelVisibility définie pour la série. La valeur par défaut est 0, ce qui signifie qu'aucune tranche ne sera masquée, quelle que soit la valeur de angleSpanLabelVisibility.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| qreal | angleSpanVisibleLimit() const |
| void | setAngleSpanVisibleLimit(qreal newAngleSpanVisibleLimit) |
Signal Notifier :
| void | angleSpanVisibleLimitChanged(qreal limit) |
Voir aussi QPieSeries::angleSpanLabelVisibility.
[read-only] count : qsizetype
Cette propriété contient le nombre de tranches de la série.
Fonctions d'accès :
| qsizetype | count() const |
Signal de notification :
| void | countChanged() |
endAngle : qreal
Cette propriété indique l'angle final de la tarte.
Une tarte complète fait 360 degrés, 0 degré étant à 12 heures.
La valeur par défaut est 360.
Fonctions d'accès :
| qreal | endAngle() const |
| void | setEndAngle(qreal angle) |
Signal de notification :
| void | endAngleChanged() |
holeSize : qreal
Cette propriété indique la taille du trou du beignet.
Lors de la définition de la propriété pieSize, cette propriété 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) |
Signal de notification :
| void | holeSizeChanged() |
horizontalPosition : qreal
Cette propriété définit la position horizontale de la tarte.
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) |
Signal de notification :
| void | horizontalPositionChanged() |
Voir aussi verticalPosition.
pieSize : qreal
Cette propriété définit la taille de la tarte.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 est la taille minimale du camembert (le camembert n'est pas dessiné).
- 1.0 est la taille maximale de la tarte 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) |
Signal de notification :
| void | pieSizeChanged() |
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 | startAngle() const |
| void | setStartAngle(qreal angle) |
Signal de notification :
| void | startAngleChanged() |
[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 de la tarte.
La valeur est relative au rectangle du graphique, de sorte que :
- 0.0 est le sommet 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) |
Signal de notification :
| void | verticalPositionChanged() |
Voir aussi horizontalPosition.
Documentation des fonctions membres
[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)
Construit un objet série qui est un enfant de parent.
[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().
[invokable] 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.
Renvoie true si l'ajout est réussi.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] 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.
Renvoie true si l'ajout est réussi.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QPieSlice *QPieSeries::at(qsizetype index)
Renvoie l'adresse PieSlice à la position index. Retourne null si aucun PieSlice n'a été trouvé.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QPieSeries::clear()
Efface toutes les tranches de la série.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
qsizetype QPieSeries::count() const
Renvoie le nombre de tranches de cette série.
Remarque : fonction Getter pour la propriété count.
qreal QPieSeries::endAngle() const
Renvoie l'angle final de la tarte.
Une tarte complète fait 360 degrés, 0 degré étant à 12 heures.
Remarque : fonction Getter pour la propriété endAngle.
Voir aussi setEndAngle(), startAngle(), et setStartAngle().
[invokable] QPieSlice *QPieSeries::find(const QString &label)
Recherche un PieSlice qui contient l'étiquette label. Elle renvoie l'adresse PieSlice si elle est trouvée, null sinon.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QPieSeries::insert(qsizetype 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
bool QPieSeries::isEmpty() const
Renvoie true si la série est vide.
[invokable] 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.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QPieSeries::remove(qsizetype index)
Supprime le site PieSlice à l'emplacement index. Le site PieSlice sera définitivement supprimé. Renvoie true si la suppression est réussie.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QPieSeries::removeMultiple(qsizetype index, int count)
Supprime plusieurs PieSlices de la série commençant par index jusqu'à un nombre de count. Les PieSlices seront définitivement supprimés.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[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().
[invokable] bool QPieSeries::replace(const QList<QPieSlice *> &slices)
Remplace la liste complète des PieSlices de la série par la liste spécifiée par slices. Toutes les tranches de tarte d'origine seront définitivement supprimées. Retourne true si tous les PieSlices ont été remplacés avec succès.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QPieSeries::replace(QPieSlice *oldSlice, QPieSlice *newSlice)
Remplace le site PieSlice oldSlice par newSlice s'il est présent dans la série.oldSlice sera définitivement supprimé. Renvoie true si le remplacement est réussi.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QPieSeries::replace(qsizetype index, QPieSlice *slice)
Remplace le site PieSlice à la position index par celui spécifié par slice. L'original PieSlice sera définitivement supprimé. Renvoie false si le remplacement d'un des PieSlices échoue.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
void QPieSeries::setEndAngle(qreal angle)
Définit l'angle final de la tarte.
Une tarte complète est de 360 degrés, où 0 degré est à 12 heures.
angle doit être supérieur à l'angle de départ.
Remarque : fonction de définition de la propriété endAngle.
Voir également endAngle(), startAngle() et setStartAngle().
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)
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::setStartAngle(qreal angle)
Définit l'angle de départ de la tarte.
Une tarte complète est de 360 degrés, où 0 degré est à 12 heures.
angle doit être plus petit que l'angle final.
Remarque : fonction de définition de la propriété startAngle.
Voir également startAngle(), endAngle() et setEndAngle().
QList<QPieSlice *> QPieSeries::slices() const
Renvoie une liste de tranches appartenant à cette série.
qreal QPieSeries::startAngle() const
Renvoie l'angle de départ de la tarte.
Une tarte complète fait 360 degrés, 0 degré étant à 12 heures.
Remarque : fonction Getter pour la propriété startAngle.
Voir aussi setStartAngle(), endAngle() et setEndAngle().
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().
[invokable] 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 prise a réussi.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[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.
