QXYSeries Class

Documentation des fonctions membres

[virtual noexcept] QXYSeries::~QXYSeries()

Supprime la série. Les séries ajoutées aux instances de QChart leur appartiennent et sont supprimées lorsque ces instances sont supprimées.

void QXYSeries::append(qreal x, qreal y)

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

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

Ajoute à la série la liste des points de données spécifiée par points.

void QXYSeries::append(const QPointF &point)

Ajoute le point de données point à la série.

const QPointF &QXYSeries::at(int index) const

Renvoie le point de données situé à la position spécifiée par ` index ` dans la séquence interne de points.

[signal] void QXYSeries::bestFitLineColorChanged(const QColor &color)

Ce signal est émis lorsque la couleur utilisée pour la droite d'ajustement change pour devenir « color ».

[since 6.2] QPair<qreal, qreal> QXYSeries::bestFitLineEquation(bool &ok) const

Renvoie une paire de nombres, le premier correspondant au coefficient de pente et le second à l'ordonnée à l'origine d'une fonction linéaire représentant la droite d'ajustement optimal.

Ces facteurs sont calculés à l’aide de la méthode des moindres carrés, sur la base des points transmis à la série.

Le paramètre ` ok ` permet de signaler un échec en lui attribuant la valeur ` false ` et de signaler une réussite en lui attribuant la valeur ` true`.

Cette fonction a été introduite dans Qt 6.2.

Voir également QXYSeries::bestFitLineVisible().

[signal] void QXYSeries::bestFitLineVisibilityChanged(bool visible)

Ce signal est émis lorsque la visibilité de la droite d'ajustement optimal passe à « visible ».

QBrush QXYSeries::brush() const

Renvoie le pinceau utilisé pour remplir les points de données de la série.

Voir également setBrush().

void QXYSeries::clear()

Supprime tous les points de la série.

Voir aussi pointsRemoved().

[since 6.2] void QXYSeries::clearPointConfiguration(const int index)

Supprime la configuration d'un point situé à l'adresse index et rétablit l'apparence par défaut dérivée des paramètres de la série.

Cette fonction a été introduite dans Qt 6.2.

Voir également clearPointsConfiguration() et setPointConfiguration().

[since 6.2] void QXYSeries::clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key)

Supprime la propriété de configuration identifiée par key du point situé à l'adresse index et rétablit l'apparence par défaut dérivée des paramètres de la série.

Supprime le type de configuration, tel que la couleur ou la taille, spécifié par key du point situé à l'adresse index comportant des personnalisations de configuration, ce qui permet à cette propriété de configuration d'être affichée selon la valeur par défaut spécifiée dans les propriétés de la série.

Cette fonction a été introduite dans Qt 6.2.

Voir également clearPointsConfiguration() et setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration()

Supprime la configuration de tous les points de la série et rétablit l'apparence par défaut dérivée des paramètres de la série.

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration(const QXYSeries::PointConfiguration key)

Supprime la propriété de configuration identifiée par key de tous les points et rétablit l'apparence par défaut dérivée des paramètres de la série.

Supprime le type de configuration, tel que la couleur ou la taille, spécifié par key de tous les points comportant des personnalisations de configuration, ce qui permet à cette propriété de configuration d'être affichée selon la valeur par défaut spécifiée dans les propriétés de la série.

Cette fonction a été introduite dans Qt 6.2.

Voir également ` clearPointsConfiguration()` et ` setPointConfiguration()`.

[signal] void QXYSeries::clicked(const QPointF &point)

Ce signal est émis lorsque l'utilisateur déclenche un événement de souris en cliquant sur le point point dans le graphique.

Voir également pressed(), released() et doubleClicked().

[since 6.2] void QXYSeries::colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient())

Définit la couleur des points en fonction d'une liste de valeurs fournie. Les valeurs provenant de sourceData sont triées et mappées vers gradient.

Si la série est associée à un QColorAxis, un dégradé provenant de cet axe sera utilisé.

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointConfiguration(), pointConfiguration() et QColorAxis.

[signal] void QXYSeries::colorChanged(QColor color)

Ce signal est émis lorsque la couleur du trait (stylo) passe à color.

int QXYSeries::count() const

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

[since 6.2] void QXYSeries::deselectAllPoints()

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointSelected().

[since 6.2] void QXYSeries::deselectPoint(int index)

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointSelected().

[since 6.2] void QXYSeries::deselectPoints(const QList<int> &indexes)

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi ` setPointSelected()`.

[signal] void QXYSeries::doubleClicked(const QPointF &point)

Ce signal est émis lorsque l'utilisateur double-clique sur le point de données point dans le graphique. L'point correspond au point où le premier clic a été déclenché.

Voir également pressed(), released() et clicked().

[signal] void QXYSeries::hovered(const QPointF &point, bool state)

Ce signal est émis lorsqu'on passe la souris sur le point point dans le graphique. Lorsque la souris passe sur le point, state devient true, et lorsque la souris s'en éloigne, il redevient false.

void QXYSeries::insert(int index, const QPointF &point)

Insère le point de données point dans la série à la position indiquée par index.

Voir également pointAdded().

[since 6.2] bool QXYSeries::isPointSelected(int index)

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

Cette fonction a été introduite dans Qt 6.2.

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

[since 6.2] const QImage &QXYSeries::lightMarker() const

Récupère l'image utilisée pour dessiner les marqueurs sur chaque point de la série.

La valeur par défaut est QImage(), ce qui signifie qu'aucun marqueur clair ne sera affiché.

Les marqueurs lumineux permettent de visualiser les points de données de cette série et constituent donc une alternative à setPointsVisible(true). Ces deux fonctionnalités peuvent être activées indépendamment l’une de l’autre.

Contrairement aux éléments de QScatterSeries, les marqueurs lumineux ne sont pas représentés par QGraphicsItem, mais sont simplement dessinés (aucun objet n'est créé). Cependant, les signaux d'événement de souris de QXYSeries se comportent de la même manière, ce qui signifie que vous obtiendrez la valeur exacte du domaine du point si vous cliquez, appuyez ou passez la souris sur le marqueur lumineux. Vous obtiendrez toujours la valeur intermédiaire du domaine si vous cliquez sur la ligne. Les marqueurs lumineux se situent au-dessus de la ligne, tant au niveau du rendu que des événements.

Cette fonction a été introduite dans Qt 6.2.

Voir également QXYSeries::setLightMarker().

[signal, since 6.2] void QXYSeries::lightMarkerChanged(const QImage &lightMarker)

Ce signal est émis lorsque l'image du marqueur lumineux passe à « lightMarker ».

Cette fonction a été introduite dans Qt 6.2.

Voir également QXYSeries::setLightMarker().

[since 6.2] qreal QXYSeries::markerSize() const

Récupère la taille du marqueur utilisé pour afficher les points de la série.

La taille par défaut dépend du type d'QXYSeries. Pour QScatterSeries, la valeur par défaut est 15,0 ; pour QLineSeries, elle est égale à la taille du stylo de la série multipliée par 1,5.

Cette fonction a été introduite dans Qt 6.2.

Voir également ` setMarkerSize()` et ` QScatterSeries::markerSize`.

[signal] void QXYSeries::markerSizeChanged(qreal size)

Ce signal est émis lorsque la taille du marqueur passe à « size ».

QPen QXYSeries::pen() const

Renvoie le stylo utilisé pour tracer le contour des points de données de la série.

Voir également setPen().

[signal] void QXYSeries::penChanged(const QPen &pen)

Ce signal est émis lorsque le stylo passe en mode « pen ».

[signal] void QXYSeries::pointAdded(int index)

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

Voir également append() et insert().

[since 6.2] QHash<QXYSeries::PointConfiguration, QVariant> QXYSeries::pointConfiguration(const int index) const

Renvoie une carte représentant la configuration d'un point sur index.

La configuration des points vous permet de modifier divers aspects de l'apparence de chaque point.

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointConfiguration().

[signal] void QXYSeries::pointLabelsClippingChanged(bool clipping)

Ce signal est émis lorsque le rognage des libellés des points de données passe à « clipping ».

[signal] void QXYSeries::pointLabelsColorChanged(const QColor &color)

Ce signal est émis lorsque la couleur utilisée pour les étiquettes des points de données passe à color.

[signal] void QXYSeries::pointLabelsFontChanged(const QFont &font)

Ce signal est émis lorsque la police utilisée pour les étiquettes des points de données passe à « font ».

[signal] void QXYSeries::pointLabelsFormatChanged(const QString &format)

Ce signal est émis lorsque le format des étiquettes des points de données passe à format.

[signal] void QXYSeries::pointLabelsVisibilityChanged(bool visible)

Ce signal est émis lorsque la visibilité des libellés des points de données passe à « visible ».

[signal] void QXYSeries::pointRemoved(int index)

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

Voir également remove().

[signal] void QXYSeries::pointReplaced(int 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.

[since 6.2] QXYSeries::PointsConfigurationHash QXYSeries::pointsConfiguration() const

Renvoie une carte dont les clés correspondent aux index des points et les valeurs à la configuration de ces points.

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointsConfiguration(), setPointConfiguration() et pointConfiguration().

[signal] void QXYSeries::pointsRemoved(int index, int count)

Ce signal est émis lorsque le nombre de points spécifié par count est supprimé à partir de la position indiquée par index.

Voir également removePoints() et clear().

[signal] void QXYSeries::pointsReplaced()

Ce signal est émis lorsque tous les points sont remplacés par d'autres points.

Voir également replace().

[signal] void QXYSeries::pressed(const QPointF &point)

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

Voir également clicked(), released() et doubleClicked().

[signal] void QXYSeries::released(const QPointF &point)

Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur le point de données spécifié par point.

Voir également pressed(), clicked() et doubleClicked().

void QXYSeries::remove(const QPointF &point)

Supprime le point de données point de la série.

Voir aussi pointRemoved().

void QXYSeries::remove(int index)

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

Voir également pointRemoved().

void QXYSeries::remove(qreal x, qreal y)

Supprime de la série le point dont les coordonnées sont x et y.

Voir également pointRemoved().

void QXYSeries::removePoints(int index, int count)

Supprime le nombre de points spécifié par count de la série à partir de la position indiquée par index.

Voir également pointsRemoved().

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

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

Voir également pointsReplaced().

void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint)

Remplace le point indiqué par oldPoint par celui indiqué par newPoint.

Voir également pointReplaced().

void QXYSeries::replace(int index, const QPointF &newPoint)

Remplace le point situé à la position indiquée par index par le point indiqué par newPoint.

Voir également pointReplaced().

void QXYSeries::replace(int index, qreal newX, qreal newY)

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

Voir également pointReplaced().

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.

Voir aussi pointReplaced().

[since 6.2] void QXYSeries::selectAllPoints()

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointSelected().

[since 6.2] void QXYSeries::selectPoint(int index)

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointSelected().

[since 6.2] void QXYSeries::selectPoints(const QList<int> &indexes)

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi ` setPointSelected()`.

[signal] void QXYSeries::selectedColorChanged(const QColor &color)

Ce signal est émis lorsque la couleur des points sélectionnés passe à color.

[since 6.2] const QImage &QXYSeries::selectedLightMarker() const

Renvoie l'image utilisée pour tracer les marqueurs sur les points de la série sélectionnée.

La valeur par défaut est QImage(), ce qui signifie que le tracé habituel lightMarker() sera dessiné.

Cela équivaut à ` selectedColor ` si vous préférez des marqueurs clairs aux points normaux, mais que vous souhaitez tout de même distinguer les points sélectionnés.

Cette fonction a été introduite dans Qt 6.2.

Voir également setSelectedLightMarker(), lightMarker(), selectedColor et setPointSelected().

[since 6.2] QList<int> 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é.

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointSelected() et pointsVisible().

[signal] void QXYSeries::selectedPointsChanged()

Ce signal est émis lorsque la sélection des points change.

[virtual] void QXYSeries::setBrush(const QBrush &brush)

Définit le pinceau utilisé pour tracer les points sur le graphique sur « brush ». Si le pinceau n'est pas défini, c'est celui défini dans les paramètres du thème du graphique qui est utilisé.

Voir également brush() et QChart::setTheme().

[since 6.2] void QXYSeries::setLightMarker(const QImage &lightMarker)

Définit l'image utilisée pour dessiner les marqueurs sur chaque point de la série comme valeur de ` lightMarker`.

La valeur par défaut est un `QImage()` par défaut (QImage::isNull() == true), ce qui signifie qu'aucun marqueur lumineux ne sera tracé. Vous pouvez rétablir la valeur par défaut (désactivée) en appelant cette fonction avec un ` QImage ` nul (QImage()).

Les marqueurs lumineux visualisent les points de données de cette série et constituent donc une alternative à ` setPointsVisible(true)`. Si un marqueur lumineux est défini à l’aide de cette méthode, les points visibles définis avec ` setPointsVisible(true) ` ne sont pas affichés.

Contrairement aux éléments de QScatterSeries, les marqueurs lumineux ne sont pas représentés par QGraphicsItem, mais sont simplement dessinés (aucun objet n’est créé). Cependant, les signaux d’événements de souris de QXYSeries se comportent de la même manière, ce qui signifie que vous obtiendrez la valeur exacte du point dans le domaine si vous cliquez, appuyez ou passez la souris sur le marqueur lumineux. Vous obtiendrez toujours la valeur intermédiaire du domaine si vous cliquez sur la ligne. Les marqueurs lumineux se situent au-dessus de la ligne, tant au niveau du rendu que des événements.

Cette fonction a été introduite dans Qt 6.2.

Voir également QXYSeries::lightMarker().

[since 6.2] void QXYSeries::setMarkerSize(qreal size)

Définit l'size e du marqueur utilisé pour afficher les points de la série.

La taille par défaut est 15,0.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi QScatterSeries::markerSize.

[virtual] void QXYSeries::setPen(const QPen &pen)

Définit le stylo utilisé pour tracer des points sur le graphique sur « pen ». Si aucun stylo n'est défini, c'est celui du thème du graphique qui est utilisé.

Voir également pen() et QChart::setTheme().

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration)

Permet de personnaliser l'apparence d'un point situé à l'adresse index avec l'configuration s souhaitées.

La configuration des points vous permet de modifier divers aspects de l'apparence de chaque point.

La configuration d’un point est représentée sous la forme d’un hachage comportant des clés « QXYSeries::pointConfiguration » et des valeurs « QVariant ». Par exemple :

QLineSeries *series = new QLineSeries();
series->setName("Customized series");
series->setPointsVisible(true);

*series << QPointF(0, 6) << QPointF(2, 4) << QPointF(3, 6) << QPointF(7, 4) << QPointF(10, 5)
        << QPointF(11, 1) << QPointF(13, 3) << QPointF(17, 6) << QPointF(18, 3)
        << QPointF(20, 2);

QChart *chart = new QChart();
chart->addSeries(series);
chart->createDefaultAxes();

QHash<QXYSeries::PointConfiguration, QVariant> conf;
conf[QXYSeries::PointConfiguration::Color] = QColor(Qt::red);
conf[QXYSeries::PointConfiguration::Size] = 8;
conf[QXYSeries::PointConfiguration::LabelVisibility] = true;

series->setPointConfiguration(4, conf);

conf.remove(QXYSeries::PointConfiguration::Color);
conf[QXYSeries::PointConfiguration::LabelFormat] = "This Point";
series->setPointConfiguration(6, conf);

Dans cet exemple, vous pouvez voir une QLineSeries par défaut comportant 10 points, dont la configuration de deux points a été modifiée. Les deux points modifiés sont visiblement plus grands que les autres et leur apparence est dérivée de la configuration de la série. Par défaut, les points n’ont pas d’étiquette, mais le point à l’index 4 en possède une grâce aux valeurs de configuration QXYSeries::PointConfiguration::LabelVisibility et QXYSeries::PointConfiguration::LabelFormat. Le point à l’index 6 porte une étiquette personnalisée « This Point » grâce à la valeur de configuration QXYSeries::PointConfiguration::LabelFormat. Voici un exemple de graphique créé de cette manière :

Cette fonction a été introduite dans Qt 6.2.

Voir également pointConfiguration(), pointsConfiguration() et clearPointsConfiguration().

[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value)

Permet de personnaliser un aspect particulier de la configuration d'un point.

Cette fonction a été introduite dans Qt 6.2.

Voir également pointsConfiguration().

[since 6.2] void QXYSeries::setPointSelected(int 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 aux paramètres définis dans « selected ».

Cette fonction a été introduite dans Qt 6.2.

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

[since 6.2] void QXYSeries::setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant>> &pointsConfiguration)

Permet de personnaliser la configuration de plusieurs points, comme indiqué sur pointsConfiguration.

Cette fonction a été introduite dans Qt 6.2.

Voir également pointsConfiguration().

[since 6.2] void QXYSeries::setSelectedLightMarker(const QImage &selectedLightMarker)

Définit l'image utilisée pour dessiner les marqueurs sur les points de la série sélectionnée : selectedLightMarker.

La valeur par défaut est QImage(), ce qui signifie que l'image habituelle lightMarker() sera affichée.

Cette fonction est équivalente à ` selectedColor ` si vous préférez des marqueurs clairs aux points normaux, mais que vous souhaitez tout de même distinguer les points sélectionnés.

Cette fonction a été introduite dans Qt 6.2.

Voir également selectedLightMarker(), lightMarker(), selectedColor et setPointSelected().

[since 6.2] void QXYSeries::sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize)

Définit la taille des points en fonction d'une liste de valeurs transmise. Les valeurs issues de sourceData sont triées et associées à une taille de point comprise entre minSize et maxSize.

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointConfiguration() et pointConfiguration().

[since 6.2] void QXYSeries::toggleSelection(const QList<int> &indexes)

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointSelected().

QXYSeries &QXYSeries::operator<<(const QList<QPointF> &points)

Opérateur de flux permettant d'ajouter à la série la liste des points de données spécifiée par points.

Voir également append().

QXYSeries &QXYSeries::operator<<(const QPointF &point)

Opérateur de flux permettant d'ajouter le point de données point à la série.

Voir également append().