QXYSeries Class

La classe QXYSeries est la classe mère de toutes les classes de séries x et y. Plus d'informations...

En-tête :	`#include <QXYSeries>`
CMake :	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake :	`QT += graphs`
En QML :	XYSeries
Hérite :	QAbstractSeries
Héritée par :	QLineSeries, QScatterSeries, et QSplineSeries

Liste de tous les membres, y compris les membres hérités
QXYSeries fait partie de Qt Graphs C++ Classes for 2D.

Propriétés

color : QColor
count : qsizetype
draggable : bool

pointDelegate : QQmlComponent*
selectedColor : QColor
selectedPoints : QList<qsizetype>

Fonctions publiques

void	append(QPointF point)
void	append(const QList<QPointF> &points)
void	append(qreal x, qreal y)
QPointF	at(qsizetype index) const
void	clear()
QColor	color() const
qsizetype	count() const
void	deselectAllPoints()
void	deselectPoint(qsizetype index)
void	deselectPoints(const QList<qsizetype> &indexes)
qsizetype	find(QPointF point) const
void	insert(qsizetype index, QPointF point)
bool	isDraggable() const
bool	isPointSelected(qsizetype index) const
QQmlComponent *	pointDelegate() const
QList<QPointF>	points() const
void	remove(QPointF point)
void	remove(qsizetype index)
void	remove(qreal x, qreal y)
void	removeMultiple(qsizetype index, qsizetype count)
void	replace(const QList<QPointF> &points)
void	replace(QPointF oldPoint, QPointF newPoint)
void	replace(qsizetype index, QPointF newPoint)
void	replace(qsizetype index, qreal newX, qreal newY)
void	replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
void	selectAllPoints()
void	selectPoint(qsizetype index)
void	selectPoints(const QList<qsizetype> &indexes)
QColor	selectedColor() const
QList<qsizetype>	selectedPoints() const
void	setColor(QColor newColor)
void	setDraggable(bool newDraggable)
void	setPointDelegate(QQmlComponent *newPointDelegate)
void	setPointSelected(qsizetype index, bool selected)
void	setSelectedColor(QColor color)
bool	take(QPointF point)
void	toggleSelection(const QList<qsizetype> &indexes)

Signaux

void	colorChanged(QColor color)
void	countChanged()
void	draggableChanged()
void	pointDelegateChanged()
void	pointReplaced(qsizetype index)
`(since 6.9)` void	pointsAdded(qsizetype start, qsizetype end)
void	pointsReplaced()
void	selectedColorChanged(QColor color)
void	selectedPointsChanged()

Description détaillée

Dans QXYSeries, les points de données sont définis comme une liste de QPointF, définissant les positions X et Y.

Voir également QLineSeries et QScatterSeries.

Documentation sur les propriétés

color : QColor

Cette propriété définit la couleur principale de la série. Pour QLineSeries, il s'agit de la couleur de la ligne et pour QScatterSeries de la couleur du point.

Fonctions d'accès :

QColor	color() const
void	setColor(QColor newColor)

Signal de notification :

void	colorChanged(QColor color)

`[read-only]` count : qsizetype

Renvoie le nombre de points de données dans une série.

Fonctions d'accès :

qsizetype count() const

Signal de notification :

void	countChanged()

draggable : bool

Contrôle si la série est déplaçable.

Indique si la série peut être déplacée à l'aide de la souris ou du toucher. Par défaut, draggable est défini sur false.

Fonctions d'accès :

bool	isDraggable() const
void	setDraggable(bool newDraggable)

Signal de notification :

void	draggableChanged()

pointDelegate : QQmlComponent*

Cette propriété contient un composant QML personnalisé utilisé comme marqueur pour les points de données.

Les propriétés dynamiques disponibles pour ce composant sont les suivantes

Type	Nom du composant	Description
bool	pointSelected	Cette valeur est vraie lorsque le point est sélectionné, ce qui signifie que l'indice du point se trouve dans QXYSeries::selectedPoints.
QColor	pointColor	La couleur de la série. Cette valeur provient soit de QGraphsTheme, soit de QXYSeries::color si la couleur est définie par QXYSeries.
QColor	pointBorderColor	La couleur de la bordure de la série. Cette valeur provient de QGraphsTheme.
QColor	pointSelectedColor	La couleur sélectionnée de la série. Cette valeur provient soit de QGraphsTheme, soit de QXYSeries::selectedColor si QXYSeries remplace la couleur.
qreal	pointBorderWidth	La largeur de la bordure de la série. Cette valeur provient de QGraphsTheme.
qreal	pointValueX	La valeur de QXYPoint::x à cette position.
qreal	pointValueY	La valeur de QXYPoint::y à cette position.
int	pointIndex	L'indice du point, de 0 à la quantité de points - 1 [depuis 6.9].

Pour utiliser l'un de ces éléments, ajoutez une propriété avec le nom défini dans votre composant personnalisé. Par exemple "property color pointColor" et "property real pointValueX".

Fonctions d'accès :

QQmlComponent *	pointDelegate() const
void	setPointDelegate(QQmlComponent *newPointDelegate)

Signal de notification :

void	pointDelegateChanged()

selectedColor : QColor

Cette propriété contient la couleur des points sélectionnés.

Fonctions d'accès :

QColor	selectedColor() const
void	setSelectedColor(QColor color)

Signal de notification :

void	selectedColorChanged(QColor color)

`[read-only]` selectedPoints : QList<qsizetype>

Cette propriété contient les index des points actuellement sélectionnés.

Fonctions d'accès :

QList<qsizetype> selectedPoints() const

Signal de notification :

void	selectedPointsChanged()

Member Function Documentation

`[invokable]` void QXYSeries::append(QPointF point)

Ajoute à la série un point dont les coordonnées sont point.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::append(const QList<QPointF> &points)

Ajoute à la série les points dont les coordonnées sont points.

Remarque : cette méthode est beaucoup plus rapide que l'ajout de points de données un par un. Emet pointsAdded lorsque les points ont été ajoutés.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::append(qreal x, qreal y)

Ajoute à la série un point dont les coordonnées sont x et y.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` QPointF QXYSeries::at(qsizetype index) const

Renvoie le point à la position spécifiée par index. Renvoie (0, 0) si l'index n'est pas valide.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::clear()

Supprime tous les points 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.

`[invokable]` void QXYSeries::deselectAllPoints()

Désélectionne tous les points de la série.

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

`[invokable]` void QXYSeries::deselectPoint(qsizetype index)

Désélectionne le point à l'adresse index.

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

`[invokable]` void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

Marque plusieurs points passés dans une liste indexes comme étant désélectionnés.

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

`[invokable]` qsizetype QXYSeries::find(QPointF point) const

Recherche et renvoie l'index du premier point correspondant trouvé tel que défini par point. Elle renvoie -1 si le point n'est pas 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 QXYSeries::insert(qsizetype index, QPointF point)

Insère un point avec les coordonnées point à la position spécifiée par index dans la série. Si l'indice est égal ou inférieur à 0, le point est ajouté à la liste des points. Si l'indice est égal ou supérieur au nombre de points dans la série, le point est ajouté à la liste des points.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` bool QXYSeries::isPointSelected(qsizetype index) const

Renvoie un message vrai si le point situé à l'adresse index fait partie des points sélectionnés et un message faux dans le cas contraire.

Note : Les points sélectionnés sont dessinés en utilisant la couleur sélectionnée si elle a été spécifiée.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également selectedPoints, setPointSelected() et setSelectedColor().

`[signal]` void QXYSeries::pointReplaced(qsizetype index)

Ce signal est émis lorsqu'un point est remplacé à la position spécifiée par index.

Voir aussi replace().

QList<QPointF> QXYSeries::points() const

Renvoie les points de la série.

`[signal, since 6.9]` void QXYSeries::pointsAdded(qsizetype start, qsizetype end)

Ce signal est émis lorsqu'une liste de points est ajoutée. Les indices des nouveaux points ajoutés sont compris entre start et end.

Cette fonction a été introduite dans Qt 6.9.

`[signal]` void QXYSeries::pointsReplaced()

Ce signal est émis lorsque tous les points sont remplacés.

`[invokable]` void QXYSeries::remove(QPointF point)

Supprime de la série le point dont les coordonnées sont point. Ne fait rien si le point n'existe pas.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::remove(qsizetype index)

Supprime de la série le point situé à la position spécifiée par index.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::remove(qreal x, qreal y)

Supprime de la série le point dont les coordonnées sont x et y. Ne fait rien si le point n'existe pas.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

Supprime le nombre de points spécifié par count de la série commençant à la position spécifiée par index.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::replace(const QList<QPointF> &points)

Remplace les points actuels par les points spécifiés par points

Remarque : cette méthode est beaucoup plus rapide que le remplacement des points de données un par un, ou que l'effacement de toutes les données, suivi de l'ajout des nouvelles données. Emet pointsReplaced lorsque les points ont été remplacés.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

Remplace le point dont les coordonnées sont oldPoint par le point dont les coordonnées sont newPoint. Ne fait rien si l'ancien point n'existe pas.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::replace(qsizetype index, QPointF newPoint)

Remplace le point à la position spécifiée par index par le point dont les coordonnées sont newPoint.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

Remplace le point à la position spécifiée par index par le point dont les coordonnées sont newX et newY.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

Remplace le point dont les coordonnées sont oldX et oldY par le point dont les coordonnées sont newX et newY. Ne fait rien si l'ancien point n'existe pas.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

`[invokable]` void QXYSeries::selectAllPoints()

Marque tous les points de la série comme étant sélectionnés,

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

`[invokable]` void QXYSeries::selectPoint(qsizetype index)

Marque le point sélectionné à l'adresse index.

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

`[invokable]` void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

Marque plusieurs points passés dans une liste indexes comme étant sélectionnés.

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

QList<qsizetype> QXYSeries::selectedPoints() const

Renvoie une liste d'indices de points marqués comme sélectionnés. Les points sélectionnés sont visibles indépendamment de la visibilité des points.

Remarque : fonction Getter pour la propriété selectedPoints.

Voir également setPointSelected().

`[invokable]` void QXYSeries::setPointSelected(qsizetype index, bool selected)

Marque le point situé à l'adresse index comme étant sélectionné ou désélectionné, conformément à l'adresse selected.

Remarque : les points sélectionnés sont dessinés en utilisant la couleur sélectionnée si elle a été spécifiée. Emet QXYSeries::selectedPointsChanged

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également isPointSelected(), selectAllPoints() et setSelectedColor().

`[invokable]` bool QXYSeries::take(QPointF point)

Extrait un point, spécifié par point, de la série s'il est trouvé. Retourne true si l'opération 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 QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

Modifie l'état de sélection des points situés à l'adresse indexes en le remplaçant par l'état opposé.

Note : Emet QXYSeries::selectedPointsChanged

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Voir également setPointSelected().

© 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.

QXYSeries Class

Propriétés

Fonctions publiques

Signaux

Description détaillée

Documentation sur les propriétés

color : QColor

[read-only] count : qsizetype

draggable : bool

pointDelegate : QQmlComponent*

selectedColor : QColor

[read-only] selectedPoints : QList<qsizetype>

Member Function Documentation

[invokable] void QXYSeries::append(QPointF point)

[invokable] void QXYSeries::append(const QList<QPointF> &points)

[invokable] void QXYSeries::append(qreal x, qreal y)

[invokable] QPointF QXYSeries::at(qsizetype index) const

[invokable] void QXYSeries::clear()

[invokable] void QXYSeries::deselectAllPoints()

[invokable] void QXYSeries::deselectPoint(qsizetype index)

[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

[invokable] qsizetype QXYSeries::find(QPointF point) const

[invokable] void QXYSeries::insert(qsizetype index, QPointF point)

[invokable] bool QXYSeries::isPointSelected(qsizetype index) const

[signal] void QXYSeries::pointReplaced(qsizetype index)

QList<QPointF> QXYSeries::points() const

[signal, since 6.9] void QXYSeries::pointsAdded(qsizetype start, qsizetype end)

[signal] void QXYSeries::pointsReplaced()

[invokable] void QXYSeries::remove(QPointF point)

[invokable] void QXYSeries::remove(qsizetype index)

[invokable] void QXYSeries::remove(qreal x, qreal y)

[invokable] void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

[invokable] void QXYSeries::replace(const QList<QPointF> &points)

[invokable] void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

[invokable] void QXYSeries::replace(qsizetype index, QPointF newPoint)

[invokable] void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

[invokable] void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

[invokable] void QXYSeries::selectAllPoints()

[invokable] void QXYSeries::selectPoint(qsizetype index)

[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

QList<qsizetype> QXYSeries::selectedPoints() const

[invokable] void QXYSeries::setPointSelected(qsizetype index, bool selected)

[invokable] bool QXYSeries::take(QPointF point)

[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

`[read-only]` count : qsizetype

`[read-only]` selectedPoints : QList<qsizetype>

`[invokable]` void QXYSeries::append(QPointF point)

`[invokable]` void QXYSeries::append(const QList<QPointF> &points)

`[invokable]` void QXYSeries::append(qreal x, qreal y)

`[invokable]` QPointF QXYSeries::at(qsizetype index) const

`[invokable]` void QXYSeries::clear()

`[invokable]` void QXYSeries::deselectAllPoints()

`[invokable]` void QXYSeries::deselectPoint(qsizetype index)

`[invokable]` void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

`[invokable]` qsizetype QXYSeries::find(QPointF point) const

`[invokable]` void QXYSeries::insert(qsizetype index, QPointF point)

`[invokable]` bool QXYSeries::isPointSelected(qsizetype index) const

`[signal]` void QXYSeries::pointReplaced(qsizetype index)

`[signal, since 6.9]` void QXYSeries::pointsAdded(qsizetype start, qsizetype end)

`[signal]` void QXYSeries::pointsReplaced()

`[invokable]` void QXYSeries::remove(QPointF point)

`[invokable]` void QXYSeries::remove(qsizetype index)

`[invokable]` void QXYSeries::remove(qreal x, qreal y)

`[invokable]` void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

`[invokable]` void QXYSeries::replace(const QList<QPointF> &points)

`[invokable]` void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

`[invokable]` void QXYSeries::replace(qsizetype index, QPointF newPoint)

`[invokable]` void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

`[invokable]` void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

`[invokable]` void QXYSeries::selectAllPoints()

`[invokable]` void QXYSeries::selectPoint(qsizetype index)

`[invokable]` void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

`[invokable]` void QXYSeries::setPointSelected(qsizetype index, bool selected)

`[invokable]` bool QXYSeries::take(QPointF point)

`[invokable]` void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)