Sur cette page

XYSeries QML Type

Un type parent pour tous les types de séries x et y. Plus d'informations...

Import Statement: import QtGraphs
In C++: QXYSeries
Inherits:

AbstractSeries

Inherited By:

LineSeries, ScatterSeries, and SplineSeries

Propriétés

Signaux

Méthodes

Description détaillée

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

Documentation sur les propriétés

color : color

La couleur principale de la série. Pour LineSeries, il s'agit de la couleur de la ligne et pour ScatterSeries de la couleur du point.

count : int [read-only]

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

draggable : bool

Contrôle 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.

pointDelegate : Component

Composant QML personnalisé utilisé comme marqueur pour les points de données.

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

TypeNom du composantDescription
boolpointSelectedCette valeur est vraie lorsque le point est sélectionné.
CouleurpointColorLa couleur de la série. Cette valeur provient soit de GraphsTheme, soit de XYSeries::color si la couleur est définie par XYSeries.
CouleurpointBorderColorLa couleur de la bordure de la série. Cette valeur provient de GraphsTheme.
CouleurpointSelectedColorLa couleur sélectionnée de la série. Cette valeur provient soit de GraphsTheme, soit de XYSeries::selectedColor si la couleur est remplacée par XYSeries.
réelpointBorderWidthLa largeur de la bordure de la série. Cette valeur provient de GraphsTheme.
realpointValueXLa valeur de XYPoint::x à cette position.
realpointValueYLa valeur de XYPoint::y à cette position.
intpointIndexL'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".

selectedColor : color

La couleur des points sélectionnés.

selectedPoints : list<int> [read-only]

Les index des points actuellement sélectionnés.

Documentation sur les signaux

clicked(point point)

Ce signal est émis lorsque l'utilisateur clique ou tape sur le site point dans le graphique.

Remarque : le gestionnaire correspondant est onClicked.

colorChanged(color color)

Ce signal est émis lorsque la couleur de la ligne passe à color.

Note : Le gestionnaire correspondant est onColorChanged.

doubleClicked(point point)

Ce signal est émis lorsque l'utilisateur double-clique ou double-touche sur les données point dans le graphique. Le point est le point où la première pression a été déclenchée. Ce signal est toujours émis après clicked.

Remarque : le gestionnaire correspondant est onDoubleClicked.

draggableChanged()

Ce signal est émis lorsqu'une série devient déplaçable par la souris/le toucher ou devient fixe.

Remarque : le gestionnaire correspondant est onDraggableChanged.

pointMarkerChanged()

Ce signal est émis lorsqu'un point est modifié.

Remarque : le gestionnaire correspondant est onPointMarkerChanged.

pointReplaced(int index)

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

Note : Le gestionnaire correspondant est onPointReplaced.

[since 6.9] pointsAdded(int start, int 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.

Remarque : le gestionnaire correspondant est onPointsAdded.

Ce signal a été introduit dans Qt 6.9.

pointsReplaced()

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

Remarque : le gestionnaire correspondant est onPointsReplaced.

pressed(point point)

Ce signal est émis lorsque l'utilisateur appuie sur la donnée point dans le graphique et maintient le bouton ou le geste de la souris enfoncé.

Remarque : le gestionnaire correspondant est onPressed.

released(point point)

Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris ou le geste précédemment appuyé sur les données point.

Remarque : le gestionnaire correspondant est onReleased.

selectedColorChanged(color color)

Ce signal est émis lorsque la couleur de la série sélectionnée passe à color.

Remarque : le gestionnaire correspondant est onSelectedColorChanged.

selectedPointsChanged()

Ce signal est émis lorsque l'ensemble des points sélectionnés change.

Remarque : le gestionnaire correspondant est onSelectedPointsChanged.

Documentation de la méthode

void append(list<point> 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.

void append(point point)

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

void append(real x, real y)

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

point at(int index)

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

void clear()

Supprime tous les points de la série.

void deselectAllPoints()

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

Voir également setPointSelected().

void deselectPoint(int index)

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

Voir également setPointSelected().

void deselectPoints(list<int> indexes)

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

Voir également setPointSelected().

int find(point point)

Recherche et renvoie l'index du premier point correspondant trouvé tel que défini par point. Retourne -1 si le point n'est pas trouvé.

void insert(int index, point 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'index est égal ou supérieur au nombre de points dans la série, le point est ajouté à la liste des points.

bool isPointSelected(int index)

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.

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

Voir également selectedPoints, setPointSelected() et selectedColor.

void remove(int index)

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

void remove(point point)

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

void remove(real x, real 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.

void removeMultiple(int index, int count)

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

void replace(list<point> 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.

void replace(int index, point newPoint)

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

void replace(point oldPoint, point 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.

void replace(int index, real newX, real newY)

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

void replace(real oldX, real oldY, real newX, real 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.

void selectAllPoints()

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

Voir aussi setPointSelected().

void selectPoint(int index)

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

Voir aussi setPointSelected().

void selectPoints(list<int> indexes)

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

Voir également setPointSelected().

void setPointSelected(int 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

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

bool take(point 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.

void toggleSelection(list<int> indexes)

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

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.