XYSeries QML Type (Uncreatable)

Type parent de tous les types des séries x et y. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié dans QML.

• Liste de tous les membres, y compris les membres hérités
• XYSeries fait partie des types QML 2D d'Qt Graphs .

Propriétés

• color : color
• count : int
• draggable : bool
• pointDelegate : Component
• selectedColor : color
• selectedPoints : list<int>
• values : list<variant> (since 6.12)

Signaux

• clicked(point point)
• colorChanged(color color)
• doubleClicked(point point)
• draggableChanged()
• pointMarkerChanged()
• pointReplaced(int index)
• pointsAdded(int start, int end) (since 6.9)
• pointsReplaced()
• pressed(point point)
• released(point point)
• selectedColorChanged(color color)
• selectedPointsChanged()

Méthodes

• void append(list<point> points)
• void append(point point)
• void append(real x, real y)
• point at(int index)
• void clear()
• void deselectAllPoints()
• void deselectPoint(int index)
• void deselectPoints(list<int> indexes)
• int find(point point)
• void insert(int index, point point)
• bool isPointSelected(int index)
• void remove(int index)
• void remove(point point)
• void remove(real x, real y)
• void removeMultiple(int index, int count)
• void replace(list<point> points)
• void replace(int index, point newPoint)
• void replace(point oldPoint, point newPoint)
• void replace(int index, real newX, real newY)
• void replace(real oldX, real oldY, real newX, real newY)
• void selectAllPoints()
• void selectPoint(int index)
• void selectPoints(list<int> indexes)
• void setPointSelected(int index, bool selected)
• bool take(point point)
• void toggleSelection(list<int> indexes)

Description détaillée

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

Documentation des propriétés

color : color

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

count : int [read-only]

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

draggable : bool

Détermine si la série peut être déplacée à l'aide de la souris ou d'un écran tactile. Par défaut, la propriété « draggable » est définie 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 :

Pour utiliser l'une de ces propriétés, ajoutez une propriété portant 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 indices des points actuellement sélectionnés.

values : list<variant> [since 6.12]

Cette propriété permet de définir des points de manière déclarative pour une ` XYSeries`. La liste des variantes peut contenir soit des points, soit des nombres. Si des nombres sont fournis, la propriété `valueMapping` permet d’indiquer si le nombre doit être interprété comme la composante X ou Y d’un point.

Cette propriété a été introduite dans Qt 6.12.

Documentation sur les signaux

clicked(point point)

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

colorChanged(color color)

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

doubleClicked(point point)

Ce signal est émis lorsque l'utilisateur double-clique ou effectue un double tap sur l'point de données dans le graphique. L'point correspond au point où la première pression a été déclenchée. Ce signal se produit toujours après clicked.

draggableChanged()

Ce signal est émis lorsqu'une série devient déplaçable à l'aide de la souris ou d'un geste tactile, ou lorsqu'elle devient fixe.

pointMarkerChanged()

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

pointReplaced(int index)

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

[since 6.9] pointsAdded(int start, int end)

Ce signal est émis lorsqu'une liste de points est ajoutée à la fin. Les indices des nouveaux points ajoutés se situent entre start et end.

Ce signal a été introduit dans Qt 6.9.

pointsReplaced()

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

pressed(point point)

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

released(point point)

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

selectedColorChanged(color color)

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

selectedPointsChanged()

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

Documentation des méthodes

void append(list<point> points)

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

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 situé à 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 aussi setPointSelected().

void deselectPoint(int index)

Désélectionne le point situé à l'index e indiquée.

Voir aussi ` setPointSelected()`

void deselectPoints(list<int> indexes)

Marque comme désélectionnés plusieurs éléments d'une liste « indexes ».

Voir aussi ` setPointSelected()`.

int find(point point)

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

void insert(int index, point point)

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

bool isPointSelected(int index)

Renvoie « true » si le point situé à l'index e indiquée figure parmi les points sélectionnés, et « false » dans le cas contraire.

Voir également selectedPoints, setPointSelected() et selectedColor.

void remove(int index)

Supprime de la série le point situé à la position indiqué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 à partir de la position spécifiée par ` index`.

void replace(list<point> points)

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

void replace(int index, point newPoint)

Remplace le point situé à la position indiquée par ` index ` par le point dont les coordonnées sont ` 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 situé à la position indiquée par index par le point dont les coordonnées sont 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)

Les marqueurs indiquent que « index » a été sélectionné.

Voir également setPointSelected().

void selectPoints(list<int> indexes)

Marque comme sélectionnés plusieurs éléments d’une liste « indexes ».

Voir aussi ` setPointSelected()`.

void setPointSelected(int index, bool selected)

Les repères indiquent si l'index s spécifiées sont sélectionnées ou non, conformément aux paramètres définis dans selected.

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

bool take(point point)

Retire de la série un point, spécifié par ` point`, s'il est trouvé. Renvoie ` true ` si l'opération aboutit.

void toggleSelection(list<int> indexes)

Inverse l'état de sélection des points situés à l'indexes indiquée.

Voir aussi ` setPointSelected()`.