QAbstractSeries Class
La classe QAbstractSeries est une classe de base pour toutes les Qt Graphs pour les séries 2D. Plus d'informations...
| 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 : | QObject et QQmlParserStatus |
| Héritée par : | QAreaSeries, QBarSeries, QCustomSeries, QPieSeries, et QXYSeries |
- Liste de tous les membres, y compris les membres hérités
- QAbstractSeries fait partie de Qt Graphs Classes C++ pour 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, les classes héritées spécifiques au type de série sont utilisées à la place de la classe de base.
Voir aussi 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 de la série |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | Un graphique linéaire. |
QAbstractSeries::SeriesType::Bar | 2 | Un graphique à barres. |
QAbstractSeries::SeriesType::Scatter | 4 | Un graphique en nuage de points. |
QAbstractSeries::SeriesType::Pie | 3 | Un graphique circulaire. |
QAbstractSeries::SeriesType::Spline | 5 | Un graphique spline. |
QAbstractSeries::SeriesType::Area | 1 | Un graphique de surface. |
QAbstractSeries::SeriesType::Custom | 6 | Un graphique personnalisé. |
Documentation sur les propriétés
[since 6.10] axisX : QAbstractAxis*
Axe des X de cette série.
L'axe des x utilisé pour cette série. Crée un axe distinct de celui défini à l'adresse GraphsView, ce qui permet à l'utilisateur de disposer de plusieurs axes par graphique.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| QAbstractAxis * | axisX() const |
| void | setAxisX(QAbstractAxis *newAxisX) |
Signal Notifier :
| void | axisXChanged(QAbstractAxis *newAxis) |
[since 6.10] axisY : QAbstractAxis*
Axe des Y de cette série.
L'axe des ordonnées utilisé pour cette série. Crée un axe distinct de celui défini à l'adresse GraphsView, ce qui permet à l'utilisateur de disposer de plusieurs axes par graphique.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Signal Notifier :
| void | axisYChanged(QAbstractAxis *newAxis) |
hoverable : bool
Contrôle si la série peut être survolée.
Indique si la série peut être survolée à l'aide de la souris ou du toucher. Par défaut, hoverable est défini sur false.
Fonctions d'accès :
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
Signal de notification :
| void | hoverableChanged() |
[read-only] hovered : bool
Vérifie si une série est survolée.
Permet de vérifier si une série est survolée par la souris ou le toucher.
Fonctions d'accès :
| bool | isHovered() const |
Signal Notifier :
| 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.
Le nom est affiché 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 sont comprises entre 0,0 (transparent) et 1,0 (opaque).
Fonctions d'accès :
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Signal de notification :
| void | opacityChanged() |
selectable : bool
Contrôle si la série est sélectionnable.
Indique si la série peut être sélectionnée à l'aide de la souris ou du toucher. Par défaut, selectable est défini sur false.
Fonctions d'accès :
| bool | isSelectable() const |
| void | setSelectable(bool selectable) |
Signal de notification :
| void | selectableChanged() |
[read-only] seriesChildren : const QQmlListProperty<QObject>
La 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 utiliser explicitement le nom de la propriété children.
Fonctions d'accès :
| QQmlListProperty<QObject> | seriesChildren() |
[read-only] type : const SeriesType
Cette propriété contient 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 de manière à ce qu'elles s'échelonnent de 0 à la taille réelle de la valeur. Par défaut, le multiplicateur de valeurs est de 1,0. Les valeurs valides vont de 0,0 (hauteur 0) à 1,0 (valeur totale).
Fonctions d'accès :
| qreal | valuesMultiplier() const |
| void | setValuesMultiplier(qreal valuesMultiplier) |
Signal de notification :
| void | valuesMultiplierChanged() |
visible : bool
Visibilité de la série.
La visibilité utilisée pour 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
Contrôle l'ordre dans lequel la série est dessinée
La liste des séries de GraphsView est triée par la propriété zValue. Étant donné que chaque type de série est rendu en une seule fois, l'ordre fonctionne principalement comme un ordre interne de chaque type de série. La valeur z la plus élevée de chaque type de série détermine l'ordre de rendu entre les types de séries. La valeur par défaut est 0.
Cette propriété a été introduite dans Qt 6.10.
Fonctions d'accès :
| int | zValue() const |
| void | setZValue(int newDrawOrder) |
Signal Notifier :
| void | zValueChanged(int z) |
Member Function Documentation
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
Destructeur virtuel pour la série de graphes.
void QAbstractSeries::hide()
Définit la visibilité de la série à false.
Voir aussi setVisible() et isVisible().
[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)
Ce signal est émis lorsque le survol de la série change. Le nom de la série se trouve à l'adresse seriesName, la position de la souris/du toucher à l'adresse position, et la valeur de la série à l'adresse value.
Remarque : ce signal n'est émis que lorsque hoverable est défini sur true.
Remarque : pour les graphiques à secteurs, la valeur représente (l'angle de la position, l'angle de départ de la tranche de survol).
[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)
Ce signal est émis lorsque le survol de la série commence. Le nom de la série se trouve à l'adresse seriesName, la position de la souris/du toucher à l'adresse position, et la valeur de la série à l'adresse value.
Remarque : ce signal n'est émis que lorsque hoverable est réglé sur true (vrai).
Remarque : pour les graphiques à secteurs, la valeur représente (l'angle de la position, l'angle de départ de la tranche de survol).
[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)
Ce signal est émis lorsque le survol de la série se termine. Le nom de la série se trouve à l'adresse seriesName, et la position de la souris/du toucher à l'adresse position.
Remarque : ce signal n'est émis que lorsque hoverable est défini comme vrai.
void QAbstractSeries::show()
Définit la visibilité de la série à true.
Voir aussi 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.
