QXYSeries Class

Documentation des fonctions membres

[virtual noexcept] QXYSeries::~QXYSeries()

Supprime la série. Les séries ajoutées aux instances QChart leur appartiennent et sont supprimées lorsque les instances QChart 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és 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 à la position spécifiée par index dans la série interne de points.

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

Ce signal est émis lorsque la couleur utilisée pour la ligne de meilleur ajustement passe à color.

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

Renvoie une paire de nombres dont le premier est un facteur de pente et le second l'ordonnée à l'origine d'une fonction linéaire pour une ligne de meilleur ajustement.

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 est utilisé pour signaler un échec en fixant sa valeur à false et pour signaler un succès en fixant sa valeur à true.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi QXYSeries::bestFitLineVisible().

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

Ce signal est émis lorsque la visibilité de la ligne de meilleur ajustement passe à visible.

QBrush QXYSeries::brush() const

Renvoie la brosse utilisée 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 également pointsRemoved().

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

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 index et rétablit l'aspect par défaut dérivé 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 index avec les personnalisations de configuration, ce qui permet à cette propriété de configuration d'être rendue comme 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 aussi clearPointsConfiguration() et setPointConfiguration().

[since 6.2] void QXYSeries::clearPointsConfiguration()

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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'aspect par défaut dérivé 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 avec des personnalisations de configuration, permettant à cette propriété de configuration d'être rendue comme 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 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 transmise. Les valeurs provenant de sourceData sont triées et mises en correspondance avec gradient.

Si la série a un QColorAxis attaché, alors un gradient de l'axe sera utilisé.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointConfiguration(), pointConfiguration(), et QColorAxis.

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

Ce signal est émis lorsque la couleur de la ligne (du stylo) devient color.

int QXYSeries::count() const

Renvoie le nombre de points de données dans 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 également setPointSelected().

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

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

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointSelected().

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

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

Cette fonction a été introduite dans Qt 6.2.

Voir également 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'adresse point est le point où la première pression a été déclenchée.

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

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

Ce signal est émis lorsque la souris passe sur le point point dans le graphique. Lorsque la souris passe au-dessus du point, state devient true, et lorsque la souris s'éloigne à nouveau, il devient false.

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

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

Voir également pointAdded().

[since 6.2] bool QXYSeries::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.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi selectedPoints(), setPointSelected() et setSelectedColor().

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

Obtient l'image utilisée pour dessiner des marqueurs sur chaque point de la série.

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

Les marqueurs lumineux permettent de visualiser les points de données de cette série et constituent donc une alternative à setPointsVisible(true). Les deux fonctions 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 peints (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 domaine du point si vous cliquez/appuyez/surplombez le marqueur lumineux. Vous obtiendrez toujours la valeur du domaine intermédiaire si vous cliquez sur la ligne. Les marqueurs lumineux sont au-dessus de la ligne en termes de peinture et d'événements.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi QXYSeries::setLightMarker().

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

Ce signal est émis lorsque l'image du marqueur lumineux devient lightMarker.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi QXYSeries::setLightMarker().

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

Obtient la taille du marqueur utilisé pour rendre les points de la série.

La taille par défaut dépend du type de QXYSeries. QScatterSeries a une valeur par défaut de 15.0 QLineSeries a une valeur par défaut de la taille du stylo de la série * 1.5

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 dessiner 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 à pen.

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

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

Voir aussi 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 à l'adresse index.

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointConfiguration().

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

Ce signal est émis lorsque l'écrêtage des étiquettes 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 devient 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 étiquettes des points de données passe à visible.

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

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

Voir aussi remove().

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

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

Renvoie une carte avec les index des points comme clés et la configuration des points comme valeurs.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 spécifié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 aussi replace().

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

Ce signal est émis lorsque l'utilisateur appuie 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 la pression 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 également pointRemoved().

void QXYSeries::remove(int index)

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

Voir aussi pointRemoved().

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

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

Voir aussi pointRemoved().

void QXYSeries::removePoints(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.

Voir aussi pointsRemoved().

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

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

Voir également pointsReplaced().

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

Remplace le point spécifié par oldPoint par celui spécifié par newPoint.

Voir aussi pointReplaced().

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

Remplace le point à la position spécifiée par index par le point spécifié par newPoint.

Voir aussi pointReplaced().

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

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

Voir aussi 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 étant sélectionnés,

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointSelected().

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

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

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointSelected().

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

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setPointSelected().

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

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

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

Cela équivaut à selectedColor si vous préférez les marqueurs légers aux points normaux, mais que vous souhaitez toujours distinguer les points sélectionnés.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setSelectedLightMarker(), lightMarker(), selectedColor, et setPointSelected().

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 la brosse utilisée pour dessiner les points sur la carte à brush. Si la brosse n'est pas définie, la brosse du thème de la carte est utilisée.

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

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

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

La valeur par défaut est une QImage() (QImage::isNull() == true), ce qui signifie qu'aucun marqueur lumineux ne sera peint. Vous pouvez rétablir la valeur par défaut (désactivée) en appelant cette fonction avec une valeur nulle QImage (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 à l'aide de 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 peints (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 de domaine exacte du point si vous cliquez/appuyez/sur le marqueur lumineux. Vous obtiendrez toujours la valeur du domaine intermédiaire si vous cliquez sur la ligne. Les marqueurs lumineux sont au-dessus de la ligne en termes de peinture et d'événements.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi QXYSeries::lightMarker().

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

Définit l'adresse size du marqueur utilisé pour rendre 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 dessiner des points sur la carte à pen. Si le stylo n'est pas défini, le stylo du thème de la carte 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 en fonction de l'adresse configuration.

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

La configuration d'un point est représentée sous la forme d'une carte de hachage avec des clés QXYSeries::pointConfiguration et des valeurs QVariant. Par exemple, dans cet exemple, vous pouvez voir une carte de hachage avec des clés et des valeurs :

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 un site QLineSeries par défaut avec 10 points et avec une configuration modifiée de deux points. Les deux points modifiés sont visiblement plus grands que les autres, avec une apparence 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 a une grâce aux valeurs de configuration QXYSeries::PointConfiguration::LabelVisibility et QXYSeries::PointConfiguration::LabelFormat. Le point à l'indice 6 a une étiquette personnalisée This Point grâce à la valeur de configuration QXYSeries::PointConfiguration::LabelFormat. Vous trouverez ci-dessous un exemple de graphique créé de cette manière :

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 aussi pointsConfiguration().

[since 6.2] void QXYSeries::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.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 spécifié par pointsConfiguration.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 peinte.

C'est un équivalent de selectedColor si vous préférez les marqueurs légers aux points normaux, mais que vous souhaitez toujours distinguer les points sélectionnés.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 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 aussi setPointConfiguration() et pointConfiguration().

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

Change l'état de sélection des points à une adresse indexes donnée en un état opposé. Fait

Cette fonction a été introduite dans Qt 6.2.

Voir également setPointSelected().

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

Opérateur de flux pour ajouter à la série la liste des points de données spécifiés par points.

Voir également append().

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

Opérateur de flux pour ajouter le point de données point à la série.

Voir également append().