QAbstractSeries Class
La classe `QAbstractSeries` est une classe de base pour toutes les classes dérivées de ` Qt Graphs ` destinées aux séries 2D. En savoir plus...
| En-tête : | #include <QAbstractSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake : | QT += graphs |
| En QML : | AbstractSeries |
| Hérite de : | QObject et QQmlParserStatus |
| Hérité par : | QAreaSeries, QBarSeries, QCustomSeries, QPieSeries, et QXYSeries |
- Liste de tous les membres, y compris les membres hérités
- QAbstractSeries fait partie des classes C++ d'Qt Graphs pour le 2D.
Types publics
| enum class | SeriesType { Line, Bar, Scatter, Pie, Spline, …, Custom } |
Propriétés
|
Fonctions publiques
| virtual | ~QAbstractSeries() override |
| QAbstractAxis * | axisX() const |
| QAbstractAxis * | axisY() const |
| void | hide() |
| bool | isHoverable() const |
| bool | isHovered() const |
| bool | isSelectable() const |
| bool | isVisible() const |
| const QList<QLegendData> | legendData() const |
| QString | name() const |
| qreal | opacity() const |
| QQmlListProperty<QObject> | seriesChildren() |
| void | setAxisX(QAbstractAxis *newAxisX) |
| void | setAxisY(QAbstractAxis *newAxisY) |
| void | setHoverable(bool newHoverable) |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setSelectable(bool selectable) |
| void | setValuesMultiplier(qreal valuesMultiplier) |
| void | setVisible(bool visible = true) |
| void | setZValue(int newDrawOrder) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| qreal | valuesMultiplier() const |
| int | zValue() const |
Signaux
| void | axisXChanged(QAbstractAxis *newAxis) |
| void | axisYChanged(QAbstractAxis *newAxis) |
| void | hover(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverEnter(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverExit(const QString &seriesName, QPointF position) |
| void | hoverableChanged() |
| void | hoveredChanged(bool hovered) |
| void | legendDataChanged() |
| void | nameChanged() |
| void | opacityChanged() |
| void | selectableChanged() |
| void | valuesMultiplierChanged() |
| void | visibleChanged() |
| void | zValueChanged(int z) |
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 QLineSeries, QSplineSeries, QScatterSeries, QBarSeries et QXYSeries.
Documentation sur les types de membres
enum class QAbstractSeries::SeriesType
Cette énumération décrit le type de la série.
| Constante | Valeur | Description |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | Un graphique linéaire. |
QAbstractSeries::SeriesType::Bar | 2 | Un graphique à barres. |
QAbstractSeries::SeriesType::Scatter | 4 | Un nuage de points. |
QAbstractSeries::SeriesType::Pie | 3 | Un diagramme circulaire. |
QAbstractSeries::SeriesType::Spline | 5 | Un graphique spline. |
QAbstractSeries::SeriesType::Area | 1 | Un graphique en aires. |
QAbstractSeries::SeriesType::Custom | 6 | Un graphique personnalisé. |
Documentation sur les propriétés
[since 6.10] axisX : QAbstractAxis*
Axe X de cette série.
L'axe des x utilisé pour cette série. Crée un axe distinct de celui défini dans ` GraphsView `, permettant à l'utilisateur de visualiser plusieurs axes par graphique.
Cette énumération a été introduite dans Qt 6.10.
Fonctions d'accès :
| QAbstractAxis * | axisX() const |
| void | setAxisX(QAbstractAxis *newAxisX) |
Signal de notification :
| void | axisXChanged(QAbstractAxis *newAxis) |
[since 6.10] axisY : QAbstractAxis*
Axe des y de cette série.
L'axe des y utilisé pour cette série. Crée un axe distinct de celui défini dans ` GraphsView `, permettant ainsi à l'utilisateur de disposer de plusieurs axes par graphique.
Cette énumération a été introduite dans Qt 6.10.
Fonctions d'accès :
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Signal de notification :
| void | axisYChanged(QAbstractAxis *newAxis) |
hoverable : bool
Détermine si la série est accessible au survol.
Détermine si le survol de la série est autorisé à l'aide de la souris ou d'un écran tactile. Par défaut, la propriété « hoverable » est définie sur « false ».
Fonctions d'accès :
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
Signal de notification :
| void | hoverableChanged() |
[read-only] hovered : bool
Vérifier si le curseur se trouve au-dessus d'une série.
Permet de vérifier si la souris ou le doigt se trouve actuellement au-dessus d'une série.
Fonctions d'accès :
| bool | isHovered() const |
Signal de notification :
| void | hoveredChanged(bool hovered) |
Voir aussi QAbstractSeries ::hovered.
[read-only] legendData : QList<QLegendData>
Contient les informations nécessaires à la création d'un marqueur de légende pour un ensemble de données dans un graphique.
Fonctions d'accès :
| const QList<QLegendData> | legendData() const |
Signal de notification :
| void | legendDataChanged() |
Voir aussi QLegendData.
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() |
selectable : bool
Détermine si la série peut être sélectionnée.
Détermine si la série peut être sélectionnée à l'aide de la souris ou d'un écran tactile. Par défaut, la valeur « selectable » est définie sur « false ».
Fonctions d'accès :
| bool | isSelectable() const |
| void | setSelectable(bool selectable) |
Signal de notification :
| void | selectableChanged() |
[read-only] seriesChildren : const QQmlListProperty<QObject>
Liste des objets enfants de la série. Il s'agit d'une propriété par défaut qui permet de spécifier des objets enfants au sein d'un élément de série en QML sans avoir à utiliser explicitement le nom de la propriété « children ».
Fonctions d'accès :
| QQmlListProperty<QObject> | seriesChildren() |
[read-only] type : const SeriesType
Cette propriété indique le type de la série.
Fonctions d'accès :
| virtual QAbstractSeries::SeriesType | type() const = 0 |
valuesMultiplier : qreal
Contrôle la valeur visible effective des valeurs de la série.
Cette variable peut être utilisée pour animer les valeurs de la série afin qu’elles s’étendent de 0 à la taille réelle de la valeur. Par défaut, la valeur de valuesMultiplier est 1,0. Les valeurs valides vont de 0,0 (hauteur 0) à 1,0 (valeur maximale).
Fonctions d'accès :
| qreal | valuesMultiplier() const |
| void | setValuesMultiplier(qreal valuesMultiplier) |
Signal de notification :
| void | valuesMultiplierChanged() |
visible : bool
Visibilité de la série.
Visibilité appliquée à cette série. Par défaut, « visible » est défini sur « true ».
Fonctions d'accès :
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Signal de notification :
| void | visibleChanged() |
[since 6.10] zValue : int
Détermine l'ordre dans lequel la série est affichée
La liste des séries de ` GraphsView ` est triée selon la propriété `zValue`. Étant donné que chaque type de série est affiché en une seule fois, cet ordre correspond généralement à l'ordre interne de chaque type de série. La valeur `zValue` la plus élevée de chaque type de série détermine l'ordre d'affichage entre les différents types de séries. La valeur par défaut est 0.
Cette énumération a été introduite dans Qt 6.10.
Fonctions d'accès :
| int | zValue() const |
| void | setZValue(int newDrawOrder) |
Signal de notificateur :
| void | zValueChanged(int z) |
Documentation des fonctions membres
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
Destructeur virtuel pour la série de graphes.
void QAbstractSeries::hide()
Définit la visibilité de la série sur « false ».
Voir également setVisible() et isVisible().
[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)
Ce signal est émis lorsque la série sur laquelle le curseur est positionné change. Le nom de la série se trouve dans seriesName, la position de la souris/du doigt dans position, et la valeur de la série dans value.
Remarque : ce signal n'est émis que lorsque hoverable est défini sur true.
Remarque : pour les graphiques circulaires, la valeur représente (l'angle de la position, l'angle de départ de la part survolée)
[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)
Ce signal est émis lorsque le survol d'une série commence. Le nom de la série se trouve dans seriesName, la position de la souris ou du doigt dans position, et la valeur de la série dans value.
Remarque : ce signal n'est émis que lorsque hoverable est défini sur true.
Remarque : pour les graphiques circulaires, la valeur représente (l'angle de la position, l'angle de départ du segment survolé)
[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)
Ce signal est émis lorsque le survol d'une série prend fin. Le nom de la série se trouve dans ` seriesName`, et la position de la souris ou du doigt dans ` position`.
Remarque : ce signal n'est émis que lorsque hoverable est défini sur true.
void QAbstractSeries::show()
Définit la visibilité de la série sur « true ».
Voir également setVisible() et isVisible().
© 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.
