QXYSeries Class
La classe `QXYSeries` est la classe parente de toutes les classes des séries x et y. En savoir plus...
| 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 de : | QAbstractSeries |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QXYSeries fait partie des classes C++ d'Qt Graphs pour le 2D.
Types publics
(since 6.12) enum class | ValueMapping { X, Y } |
Propriétés
|
|
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) |
| void | setStepSize(qreal stepSize) |
| void | setValueMapping(QXYSeries::ValueMapping newHint) |
| void | setValueMin(qreal newMin) |
| void | setValues(QVariantList values) |
| qreal | stepSize() const |
| bool | take(QPointF point) |
| void | toggleSelection(const QList<qsizetype> &indexes) |
| QXYSeries::ValueMapping | valueMapping() const |
| qreal | valueMin() const |
| QVariantList | values() const |
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() |
| void | stepSizeChanged(qreal newStepSize) |
| void | valueMappingChanged(QXYSeries::ValueMapping newHint) |
| void | valueMinChanged(qreal newMin) |
| void | valuesChanged(const QVariantList &values) |
Description détaillée
Dans QXYSeries, les points de données sont définis comme une liste d'QPointF, qui définissent les positions X et Y.
Voir également QLineSeries et QScatterSeries.
Documentation sur les types de membres
[since 6.12] enum class QXYSeries::ValueMapping
Cette énumération décrit la manière dont les nombres bruts sont interprétés dans ` values `.
| Constante | Valeur | Description |
|---|---|---|
QXYSeries::ValueMapping::X | 0 | Chaque nombre correspond à la valeur X ; la valeur Y est générée à partir de l’index et de stepSize. |
QXYSeries::ValueMapping::Y | 1 | Chaque nombre correspond à la valeur Y ; X est généré à partir de ` valueMin ` et de ` stepSize`. |
Cette énumération a été introduite dans Qt 6.12.
Documentation de la propriété
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 d'une série.
Fonctions d'accès :
| qsizetype | count() const |
Signal de notification :
| void | countChanged() |
draggable : bool
Détermine si la série peut être déplacée par glissement.
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 ».
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 | Description |
|---|---|---|
| bool | pointSelected | Cette valeur est vraie lorsque le point est sélectionné, ce qui signifie que l'index du point se trouve dans QXYSeries::selectedPoints. |
| QColor | pointColor | La couleur de la série. Cette valeur provient soit de l'QGraphsTheme, soit de QXYSeries::color si l'QXYSeries remplace la couleur. |
| QColor | pointBorderColor | La couleur de la bordure de la série. Cette valeur provient de QGraphsTheme. |
| QColor | pointSelectedColor | Couleur des points sélectionnés de la série. Cette valeur provient soit de QGraphsTheme, soit de QXYSeries::selectedColor si QXYSeries remplace la couleur. |
| qreal | pointBorderWidth | Largeur de la bordure de la série. Cette valeur provient de QGraphsTheme. |
| qreal | pointValueX | La valeur de l'QXYPoint::x à cette position. |
| qreal | pointValueY | La valeur de l'QXYPoint::y e à cette position. |
| int | pointIndex | L'index du point, compris entre 0 et le nombre total de points moins 1. [depuis la version 6.9] |
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" ».
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 indices des points actuellement sélectionnés.
Fonctions d'accès :
| QList<qsizetype> | selectedPoints() const |
Signal de notification :
| void | selectedPointsChanged() |
[since 6.12] stepSize : qreal
Cette propriété définit l'incrément entre les valeurs X (ou Y) générées automatiquement lors du remplissage de la série à partir de nombres bruts via values.
La valeur par défaut est 1.
Cette énumération a été introduite dans Qt 6.12.
Fonctions d'accès :
| qreal | stepSize() const |
| void | setStepSize(qreal stepSize) |
Signal de notification :
| void | stepSizeChanged(qreal newStepSize) |
Voir également values, valueMapping et valueMin.
[since 6.12] valueMapping : ValueMapping
Détermine la manière dont les nombres contenus dans ` values ` sont interprétés.
Lorsque ` values ` contient des nombres bruts plutôt que des valeurs de type ` QPointF `, cette propriété détermine si chaque nombre correspond à la composante X ou Y d'un point.
Cette énumération a été introduite dans Qt 6.12.
Fonctions d'accès :
| QXYSeries::ValueMapping | valueMapping() const |
| void | setValueMapping(QXYSeries::ValueMapping newHint) |
Signal de notification :
| void | valueMappingChanged(QXYSeries::ValueMapping newHint) |
Voir également values, valueMin et stepSize.
[since 6.12] valueMin : qreal
Cette propriété contient la valeur minimale de X (ou Y) utilisée lors de la génération de points à partir de nombres bruts dans values.
Elle est utilisée conjointement avec la méthode ` stepSize ` lorsque ` valueMapping ` est défini sur ` ValueMapping::Y ` pour générer les valeurs X de chaque point.
La valeur par défaut est 0.
Cette énumération a été introduite dans Qt 6.12.
Fonctions d'accès :
| qreal | valueMin() const |
| void | setValueMin(qreal newMin) |
Signal de notification :
| void | valueMinChanged(qreal newMin) |
Voir aussi values, valueMapping et stepSize.
[since 6.12] values : QVariantList
Cette propriété contient les points de la série, définis de manière déclarative.
La liste des variantes peut contenir soit des valeurs de type « QPointF », soit des nombres. Si des nombres sont fournis, l’option « valueMapping » détermine si chaque nombre est interprété comme une composante X ou Y.
Cette énumération a été introduite dans Qt 6.12.
Fonctions d'accès :
| QVariantList | values() const |
| void | setValues(QVariantList values) |
Signal de notification :
| void | valuesChanged(const QVariantList &values) |
Voir aussi valueMapping, valueMin et stepSize.
Documentation des fonctions membres
[invokable] void QXYSeries::append(QPointF point)
Ajoute à la série un point dont les coordonnées sont point.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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 opération est bien plus rapide que d’ajouter les points de données un par un. Émet pointsAdded une fois les points ajoutés.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QPointF QXYSeries::at(qsizetype index) const
Renvoie le point situé à la position spécifiée par ` index`. Renvoie (0, 0) si l'index n'est pas valide.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::clear()
Supprime tous les points de la série.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::deselectAllPoints()
Désélectionne tous les points de la série.
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également setPointSelected().
[invokable] void QXYSeries::deselectPoint(qsizetype index)
Désélectionne le point situé à l'index e indiquée.
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également setPointSelected().
[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)
Marque comme désélectionnés plusieurs éléments d'une liste « indexes ».
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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. Renvoie -1 si le point n'est pas trouvé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::insert(qsizetype index, QPointF point)
Insère un point aux coordonnées point à la position spécifiée par index dans la série. Si l’indice est égal à 0 ou inférieur à 0, le point est ajouté au début de la liste des points. Si l’indice est égal ou supérieur au nombre de points de la série, le point est ajouté à la fin de la liste des points.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QXYSeries::isPointSelected(qsizetype index) const
Renvoie « true » si le point situé à l'index e indiquée figure parmi les points sélectionnés, et « false » dans le cas contraire.
Remarque : les pointssélectionnés sont dessinés avec la couleur sélectionnée si celle-ci a été spécifiée.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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 également 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 à la fin. Les indices des points nouvellement ajoutés se situent 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 ont été 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 appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::remove(qsizetype index)
Supprime de la série le point situé à la position indiquée par index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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 appelée via le système de méta-objets et depuis 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 à partir de la position indiquée par index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::replace(const QList<QPointF> &points)
Remplace les points actuels par ceux spécifiés par points
Remarque : cette opération est bien plus rapide que de remplacer les points de données un par un, ou de commencer par effacer toutes les données avant d’y ajouter les nouvelles. Émet l’événement « pointsReplaced » lorsque les points ont été remplacés.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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 appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::replace(qsizetype index, QPointF newPoint)
Remplace le point situé à la position indiquée par index par le point dont les coordonnées sont newPoint.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)
Remplace le point situé à la position spécifiée par index par le point dont les coordonnées sont newX et newY.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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 appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::selectAllPoints()
Marque tous les points de la série comme sélectionnés,
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également setPointSelected().
[invokable] void QXYSeries::selectPoint(qsizetype index)
Les marqueurs indiquent que index a été sélectionné.
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également setPointSelected().
[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)
Marque comme sélectionnés plusieurs éléments d'une liste « indexes ».
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également setPointSelected().
QList<qsizetype> QXYSeries::selectedPoints() const
Renvoie une liste des index des points marqués comme sélectionnés. Les points sélectionnés sont visibles, quel que soit leur état de visibilité.
Remarque : fonctiongetter pour la propriété selectedPoints.
Voir également setPointSelected().
[invokable] void QXYSeries::setPointSelected(qsizetype index, bool selected)
Les repères indiquent si l'index s spécifiées sont sélectionnées ou désélectionnées, conformément à selected.
Remarque : les pointssélectionnés sont dessinés à l’aide de la couleur sélectionnée si celle-ci a été spécifiée. Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également isPointSelected(), selectAllPoints() et setSelectedColor().
[invokable] bool QXYSeries::take(QPointF point)
Retire de la série un point, spécifié par point, s'il est trouvé. Renvoie true si l'opération aboutit.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)
Inverse l'état de sélection des points situés à l'indexes indiquée.
Remarque : Émet QXYSeries::selectedPointsChanged
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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.
