QXYSeries Class▲

Detailed Description▲

QXYSeries supports displaying best fit line on a chart. Best fit line is a line through a chart that expresses the relationship between points.

Member Type Documentation▲

 

enum QXYSeries::PointConfiguration▲

This enum value describes the particular configuration of a point.

Constant

Value

Description

QXYSeries::PointConfiguration::Color

0

This enum value can be used to change a point's color. If used together with QXYSeries::setPointConfiguration, the configuration's value should be a valid QColor.

QXYSeries::PointConfiguration::Size

1

This enum value can be used to change a point's size. If used together with QXYSeries::setPointConfiguration, the configuration's value should be a number, such as qreal or int.

QXYSeries::PointConfiguration::Visibility

2

This enum value can be used to hide or show the point. If used together with QXYSeries::setPointConfiguration, the configuration's value should be boolean.

QXYSeries::PointConfiguration::LabelVisibility

3

This enum value can be used to hide or show the label of the point. If used together with QXYSeries::setPointConfiguration, the configuration's value should be boolean.
See Also▲

See also setPointConfiguration()

Property Documentation▲

 

[since 6.2] bestFitLineColor : QColor▲

This property holds the color of best fit line.

This property was introduced in Qt 6.2.

Access functions:

  • bestFitLineColor() const

  • void setBestFitLineColor(const &color)

Notifier signal:

See Also▲

See also bestFitLineEquation, bestFitLineVisible

[since 6.2] bestFitLineVisible : bool▲

This property holds the visibility of the best fit line.

This property is false by default.

This property was introduced in Qt 6.2.

Access functions:

  • bool bestFitLineVisible() const

  • void setBestFitLineVisible(bool visible = true)

Notifier signal:

See Also▲

See also bestFitLineEquation

color : QColor▲

This property holds the color of the series.

This is the line (pen) color in case of QLineSeries or QSplineSeries and the fill (brush) color in case of QScatterSeries or QAreaSeries.

Access functions:

  • virtual color() const

  • virtual void setColor(const &color)

Notifier signal:

See Also▲

See also pen(), brush()

pointLabelsClipping : bool▲

This property holds the clipping for data point labels.

This property is true by default. The labels on the edge of the plot area are cut when clipping is enabled.

Access functions:

  • bool pointLabelsClipping() const

  • void setPointLabelsClipping(bool enabled = true)

Notifier signal:

See Also▲

See also pointLabelsVisible

pointLabelsColor : QColor▲

This property holds the color used for data point labels. By default, the color is the color of the brush defined in theme for labels.

Access functions:

  • pointLabelsColor() const

  • void setPointLabelsColor(const &color)

Notifier signal:

See Also▲

See also pointLabelsFormat

pointLabelsFont : QFont▲

This property holds the font used for data point labels.

Access functions:

  • pointLabelsFont() const

  • void setPointLabelsFont(const &font)

Notifier signal:

See Also▲

See also pointLabelsFormat

pointLabelsFormat : QString▲

This property holds the format used for showing labels with data points.

QXYSeries supports the following format tags:

@xPoint

The x-coordinate of the data point.

@yPoint

The y-coordinate of the data point.

For example, the following usage of the format tags would produce labels that display the data point shown inside brackets separated by a comma (x, y):

 
Sélectionnez
series->setPointLabelsFormat("(@xPoint, @yPoint)");

By default, the labels' format is set to @xPoint, @yPoint. The labels are shown on the plot area, and the labels on the edge of the plot area are cut. If the points are close to each other, the labels may overlap.

Access functions:

  • pointLabelsFormat() const

  • void setPointLabelsFormat(const &format)

Notifier signal:

See Also▲

See also pointLabelsVisible, pointLabelsFont, pointLabelsColor

pointLabelsVisible : bool▲

This property holds the visibility of data point labels.

This property is false by default.

Access functions:

  • bool pointLabelsVisible() const

  • void setPointLabelsVisible(bool visible = true)

Notifier signal:

See Also▲

See also pointLabelsFormat, pointLabelsClipping

pointsVisible : bool▲

This property holds whether the data points are visible and should be drawn.

Access functions:

  • bool pointsVisible() const

  • void setPointsVisible(bool visible = true)

[since 6.2] selectedColor : QColor▲

This property holds the color of the selected points.

This is the fill (brush) color of points marked as selected. If not specified, value of QXYSeries::color is used as default.

This property was introduced in Qt 6.2.

Access functions:

  • virtual color() const

  • void setSelectedColor(const &color)

Notifier signal:

  • void selectedColorChanged(const &color)

See Also▲

See also color

Member Function Documentation▲

 

[virtual] QXYSeries::~QXYSeries()▲

Deletes the series. Series added to QChart instances are owned by them, and are deleted when the QChart instances are deleted.

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

Adds the data point with the coordinates x and y to the series.

void QXYSeries::append(const QPointF &point)▲

This is an overloaded function.

Adds the data point point to the series.

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

This is an overloaded function.

Adds the list of data points specified by points to the series.

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

Returns the data point at the position specified by index in the internal series of points.

void QXYSeries::bestFitLineColorChanged(const QColor &color)▲

This signal is emitted when the color used for the best fit line changes to color.

Notifier signal for property bestFitLineColor.

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

Returns a pair of numbers where the first number is a slope factor and the second number is intercept of a linear function for a best fit line.

Those factors are calculated using Least Squares Method based on points passed to the series.

Parameter ok is used to report a failure by setting its value to false and to report a success by setting its value to true.

This function was introduced in Qt 6.2.

See Also▲

See also QXYSeries::bestFitLineVisible()

void QXYSeries::bestFitLineVisibilityChanged(bool visible)▲

This signal is emitted when the visibility of the best fit line changes to visible.

Notifier signal for property bestFitLineVisible.

QBrush QXYSeries::brush() const▲

Returns the brush used to fill the data points for the series.

See Also▲

See also setBrush()

void QXYSeries::clear()▲

Removes all points from the series.

See Also▲

See also pointsRemoved()

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

Removes the configuration of a point located at index and restores the default look derived from the series' settings.

It doesn't affect the configuration of other points.

This function was introduced in Qt 6.2.

See Also▲

See also clearPointsConfiguration(), setPointConfiguration()

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

Removes the configuration property identified by key from the point at index and restores the default look derived from the series' settings.

Removes the configuration type, such as color or size, specified by key from the point at index with configuration customizations, allowing that configuration property to be rendered as the default specified in the series' properties.

It doesn't affect the configuration of other points.

This function was introduced in Qt 6.2.

See Also▲

See also clearPointsConfiguration(), setPointConfiguration()

[since 6.2] void QXYSeries::clearPointsConfiguration()▲

Removes the configuration of all points in the series and restores the default look derived from the series' settings.

This function was introduced in Qt 6.2.

See Also▲

See also setPointConfiguration()

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

Removes the configuration property identified by key from all points and restores the default look derived from the series' settings.

Removes the configuration type, such as color or size, specified by key from all points with configuration customizations, allowing that configuration property to be rendered as the default specified in the series properties.

This function was introduced in Qt 6.2.

See Also▲

See also clearPointsConfiguration(), setPointConfiguration()

void QXYSeries::clicked(const QPointF &point)▲

This signal is emitted when the user triggers a mouse event by clicking the point point in the chart.

See Also▲

See also pressed(), released(), doubleClicked()

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

Sets the points' color according to a passed list of values. Values from sourceData are sorted and mapped to the gradient.

If the series has a QColorAxis attached, then a gradient from the axis is going to be used.

This function was introduced in Qt 6.2.

See Also▲

See also setPointConfiguration(), pointConfiguration(), QColorAxis

void QXYSeries::colorChanged(QColor color)▲

This signal is emitted when the line (pen) color changes to color.

Notifier signal for property color.

int QXYSeries::count() const▲

Returns the number of data points in a series.

[since 6.2] void QXYSeries::deselectAllPoints()▲

Deselects all points in the series.

Emits QXYSeries::selectedPointsChanged

This function was introduced in Qt 6.2.

See Also▲

See also setPointSelected()

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

Deselects point at given index.

Emits QXYSeries::selectedPointsChanged

This function was introduced in Qt 6.2.

See Also▲

See also setPointSelected()

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

Marks multiple points passed in a indexes list as deselected.

Emits QXYSeries::selectedPointsChanged

This function was introduced in Qt 6.2.

See Also▲

See also setPointSelected()

void QXYSeries::doubleClicked(const QPointF &point)▲

This signal is emitted when the user double-clicks the data point point in the chart. The point is the point where the first press was triggered.

See Also▲

See also pressed(), released(), clicked()

void QXYSeries::hovered(const QPointF &point, bool state)▲

This signal is emitted when a mouse is hovered over the point point in the chart. When the mouse moves over the point, state turns true, and when the mouse moves away again, it turns false.

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

Inserts the data point point in the series at the position specified by index.

See Also▲

See also pointAdded()

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

Returns true if point at given index is among selected points and false otherwise.

Selected points are drawn using the selected color if it was specified.

This function was introduced in Qt 6.2.

See Also▲

See also selectedPoints(), setPointSelected(), setSelectedColor()

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

Gets the image used for drawing markers on each point of the series.

The default value is QImage(), meaning no light marker will be painted.

The light markers visualize the data points of this series and as such are an alternative to setPointsVisible(true). Both features can be enabled independently from each other.

Unlike the elements of QScatt