QAbstractSeries Class
La classe `QAbstractSeries` est une classe de base pour toutes les séries de Qt Charts. En savoir plus…
| Header: | #include <QAbstractSeries> |
| In QML: | AbstractSeries |
| Inherits: | QObject |
| Inherited By: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries |
| Status: | Deprecated |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick } |
Propriétés
Fonctions publiques
| virtual | ~QAbstractSeries() |
| bool | attachAxis(QAbstractAxis *axis) |
| QList<QAbstractAxis *> | attachedAxes() |
| QChart * | chart() const |
| bool | detachAxis(QAbstractAxis *axis) |
| void | hide() |
| bool | isVisible() const |
| QString | name() const |
| qreal | opacity() const |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setUseOpenGL(bool enable = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| bool | useOpenGL() const |
Signaux
| void | nameChanged() |
| void | opacityChanged() |
| void | useOpenGLChanged() |
| void | visibleChanged() |
Description détaillée
En général, on utilise les classes héritées spécifiques au type de série plutôt que la classe de base.
Voir également QXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, QHorizontalPercentBarSeries et QPieSeries.
Documentation sur les types de membres
enum QAbstractSeries::SeriesType
Cette énumération décrit le type de la série.
| Constante | Valeur | Description |
|---|---|---|
QAbstractSeries::SeriesTypeLine | 0 | Un graphique linéaire. |
QAbstractSeries::SeriesTypeArea | 1 | Un graphique en aires. |
QAbstractSeries::SeriesTypeBar | 2 | Un graphique à barres verticales. |
QAbstractSeries::SeriesTypeStackedBar | 3 | Un graphique à barres empilées verticales. |
QAbstractSeries::SeriesTypePercentBar | 4 | Un graphique à barres verticales avec pourcentages. |
QAbstractSeries::SeriesTypePie | 5 | Un diagramme circulaire. |
QAbstractSeries::SeriesTypeScatter | 6 | Un nuage de points. |
QAbstractSeries::SeriesTypeSpline | 7 | Un graphique spline. |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | Un diagramme à barres horizontales. |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | Un graphique à barres empilées horizontal. |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | Un diagramme à barres horizontales avec pourcentages. |
QAbstractSeries::SeriesTypeBoxPlot | 11 | Un diagramme en boîte. |
QAbstractSeries::SeriesTypeCandlestick | 12 | Un graphique en chandeliers. |
Documentation sur les propriétés
name : QString
Cette propriété contient le nom de la série.
Ce nom s'affiche dans la légende de la série et prend en charge le formatage HTML.
Fonctions d'accès :
| QString | name() const |
| void | setName(const QString &name) |
Signal de notification :
| void | nameChanged() |
opacity : qreal
Cette propriété définit l'opacité de la série.
Par défaut, l'opacité est de 1,0. Les valeurs valides vont de 0,0 (transparent) à 1,0 (opaque).
Fonctions d'accès :
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Signal de notification :
| void | opacityChanged() |
[read-only] type : SeriesType
Cette propriété indique le type de la série.
Fonctions d'accès :
| virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
Indique si le tracé de la série est accéléré ou non à l'aide d'OpenGL.
L'accélération via OpenGL n'est prise en charge que pour les séries QLineSeries et QScatterSeries. Une série de lignes utilisée comme série de bord pour QAreaSeries ne peut pas bénéficier de l’accélération OpenGL. Lorsqu’un graphique contient une ou plusieurs séries dessinées avec OpenGL, un QOpenGLWidget transparent est créé par-dessus la zone de tracé du graphique. Les séries accélérées ne sont pas dessinées sur l’ QGraphicsView sous-jacente, mais sur le QOpenGLWidget ainsi créé.
Le gain de performances obtenu grâce à l’utilisation d’OpenGL pour accélérer le tracé des séries dépend du matériel sous-jacent, mais il est significatif dans la plupart des cas. Par exemple, sur un ordinateur de bureau standard, l’activation de l’accélération OpenGL pour une série permet généralement de tracer au moins cent fois plus de points sans réduction de la fréquence d’images. La taille du graphique a également moins d’impact sur la fréquence d’images.
L’accélération OpenGL du tracé des séries est destinée aux cas d’utilisation nécessitant un tracé rapide d’un grand nombre de points. Elle est optimisée pour l’efficacité ; par conséquent, les séries qui l’utilisent ne prennent pas en charge de nombreuses fonctionnalités disponibles pour les séries non accélérées :
- Les animations de séries ne sont pas prises en charge pour les séries accélérées.
- Les étiquettes de points ne sont pas prises en charge pour les séries accélérées.
- Les styles de stylo, les formes de marqueurs et les marqueurs clairs sont ignorés pour les séries accélérées. Seules les lignes pleines et les points de nuage simples sont pris en charge. Les points de nuage peuvent être circulaires ou rectangulaires, selon le matériel graphique et les pilotes sous-jacents.
- Les graphiques polaires ne prennent pas en charge les séries accélérées.
- Il n’est pas recommandé d’activer l’ombre portée du graphique ou d’utiliser une couleur de fond transparente lorsque vous utilisez des séries accélérées, car cela peut ralentir considérablement la fréquence d’images.
Ces restrictions supplémentaires découlent du fait que la série accélérée est dessinée sur un widget distinct superposé au graphique :
- Si vous dessinez des éléments graphiques par-dessus un graphique contenant une série accélérée, celle-ci est dessinée par-dessus ces éléments.
- Pour permettre à QOpenGLWidget d’être partiellement transparent, il doit être superposé à tous les autres widgets. Cela signifie que vous ne pouvez pas avoir d’autres widgets recouvrant partiellement le graphique lorsque vous utilisez des séries accélérées.
- Les séries accélérées ne sont pas prises en charge dans les cas où la scène graphique comporte plusieurs vues graphiques associées.
- Les séries accélérées ne sont pas prises en charge dans les cas où le graphique présente une géométrie non par défaut. Par exemple, l’ajout de transformations à la vue graphique entraîne l’affichage des séries accélérées à une position incorrecte par rapport au graphique.
La valeur par défaut est « false ».
Fonctions d’accès :
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
Signal de notification :
| void | useOpenGLChanged() |
visible : bool
Cette propriété indique si la série est visible ou non.
Par défaut, true.
Fonctions d'accès :
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Signal de notification :
| void | visibleChanged() |
Documentation des fonctions membres
[virtual noexcept] QAbstractSeries::~QAbstractSeries()
Destructeur virtuel pour la série du graphique.
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
Associe l'axe spécifié par axis à la série.
Renvoie true si l'axe a été associé avec succès, false dans le cas contraire.
Remarque : si plusieurs axes de même orientation sont associés à une même série, ils auront les mêmes valeurs minimales et maximales.
Voir également QChart::addAxis() et QChart::createDefaultAxes().
QList<QAbstractAxis *> QAbstractSeries::attachedAxes()
Renvoie la liste des axes associés à la série. En général, un axe des x et un axe des y sont associés à une série, à l'exception de QPieSeries, qui ne comporte aucun axe associé.
Voir également attachAxis() et detachAxis().
QChart *QAbstractSeries::chart() const
Renvoie le graphique auquel appartient la série.
Cette propriété est définie automatiquement lorsque la série est ajoutée au graphique, et supprimée lorsque la série est retirée du graphique.
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
Détache l'axe spécifié par axis de la série.
Renvoie true si l'axe a été détaché avec succès, false dans le cas contraire.
Voir également QChart::removeAxis().
void QAbstractSeries::hide()
Définit la visibilité de la série sur « false ».
Voir également setVisible() et isVisible().
[signal] void QAbstractSeries::nameChanged()
Ce signal est émis lorsque le nom de la série change.
Remarque : signalde notification pour la propriété name.
[signal] void QAbstractSeries::opacityChanged()
Ce signal est émis lorsque l'opacité de la série change.
Remarque : signalde notification pour la propriété opacity.
void QAbstractSeries::show()
Définit la visibilité de la série sur « true ».
Voir également setVisible() et isVisible().
[signal] void QAbstractSeries::useOpenGLChanged()
Ce signal est émis lorsque l'accélération du rendu de la série à l'aide d'OpenGL est activée ou désactivée.
Remarque : signalde notification pour la propriété « useOpenGL ».
[signal] void QAbstractSeries::visibleChanged()
Ce signal est émis lorsque la visibilité de la série change.
Remarque : signalde notification pour la propriété visible.
© 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.
