- Qt 6.8
- Qt Charts
- QML Types
- XYSeries
- Qt Charts | Commercial or GPLv3

# XYSeries QML Type

A base type for line, spline, and scatter series. More...

Import Statement: | `import QtCharts 2.8`
In C++: | QXYSeries
Inherits: | AbstractSeries
Inherited By: | LineSeries, ScatterSeries, and SplineSeries

- List of all members, including inherited members

## Properties

- axisAngular : AbstractAxis
- axisRadial : AbstractAxis
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- bestFitLineColor : color
- bestFitLineVisible : bool
- color : color
- pointLabelsClipping : bool
- pointLabelsColor : font
- pointLabelsFont : font
- pointLabelsFormat : string
- pointLabelsVisible : bool
- pointsVisible : bool
- selectedColor : color

## Signals

- clicked(point point)
- doubleClicked(point point)
- hovered(point point, bool state)
- pointAdded(int index)
- pointRemoved(int index)
- pointReplaced(int index)
- pointsRemoved(int index, int count)
- pointsReplaced()
- pressed(point point)
- released(point point)

## Methods

- append(real x, real y)
- QPointF at(int index)
- insert(int index, real x, real y)
- remove(int index)
- remove(real x, real y)
- removePoints(int index, int count)
- replace(real oldX, real oldY, real newX, real newY)

## Detailed Description

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

## Property Documentation

axisAngular : AbstractAxis

The angular axis used for the series, drawn around the polar chart view.

See also axisX.

axisRadial : AbstractAxis

The radial axis used for the series, drawn inside the polar chart view.

See also axisY.

axisX : AbstractAxis

The x-axis used for the series. If you leave both axisX and axisXTop undefined, a value axis is created for the series.

See also axisXTop and ValueAxis.

axisXTop : AbstractAxis

The x-axis used for the series, drawn on top of the chart view.

Note: You can only provide either axisX or axisXTop, not both.

See also axisX.

axisY : AbstractAxis

The y-axis used for the series. If you leave both axisY and axisYRight undefined, a value axis is created for the series.

See also axisYRight and ValueAxis.

axisYRight : AbstractAxis

The y-axis used for the series, drawn to the right on the chart view.

Note: You can only provide either axisY or axisYRight, not both.

See also axisY.

bestFitLineColor : color

The color of best fit line.

See also bestFitLineVisible.

bestFitLineVisible : bool

The visibility of the best fit line. This property is `false` by default.

color : color

The color of the series. This is the line (pen) color in case of LineSeries or SplineSeries and the fill (brush) color in case of ScatterSeries or AreaSeries.

pointLabelsClipping : bool

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.

See also pointLabelsVisible.

pointLabelsColor : font

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

See also pointLabelsFormat.

pointLabelsFont : font

The font used for data point labels.

See also pointLabelsFormat.

pointLabelsFormat : string

The format used for showing labels with data points.

See also pointLabelsVisible, pointLabelsFont, and pointLabelsColor.

pointLabelsVisible : bool

The visibility of data point labels. This property is `false` by default.

See also pointLabelsFormat and pointLabelsClipping.

pointsVisible : bool

Whether the data points are visible and should be drawn.

selectedColor : color

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.

See also color.

## Signal Documentation

clicked(point point)

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

     LineSeries {
         XYPoint { x: 0; y: 0 }
         XYPoint { x: 1.1; y: 2.1 }
         onClicked: console.log("onClicked: " + point.x + ", " + point.y);
     }

The corresponding signal handler is `onClicked()`.

Note: The corresponding handler is `onClicked`.

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

doubleClicked(point 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. For example:

     LineSeries {
         XYPoint { x: 0; y: 0 }
         XYPoint { x: 1.1; y: 2.1 }
         onDoubleClicked: console.log("onDoubleClicked: " + point.x + ", " + point.y);
     }

The corresponding signal handler is `onDoubleClicked()`.

Note: The corresponding handler is `onDoubleClicked`.

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

hovered(point 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`.

The corresponding signal handler is `onHovered()`.

Note: The corresponding handler is `onHovered`.

pointAdded(int index)

This signal is emitted when a point is added at the position specified by index.

The corresponding signal handler is `onPointAdded()`.

Note: The corresponding handler is `onPointAdded`.

pointRemoved(int index)

This signal is emitted when a point is removed from the position specified by index.

The corresponding signal handler is `onPointRemoved()`.

Note: The corresponding handler is `onPointRemoved`.

pointReplaced(int index)

This signal is emitted when a point is replaced at the position specified by index.

The corresponding signal handler is `onPointReplaced()`.

Note: The corresponding handler is `onPointReplaced`.

pointsRemoved(int index, int count)

This signal is emitted when the number of points specified by count is removed starting at the position specified by index.

The corresponding signal handler is `onPointRemoved()`.

Note: The corresponding handler is `onPointsRemoved`.

pointsReplaced()

This signal is emitted when all points are replaced with other points.

The corresponding signal handler is `onPointsReplaced()`.

Note: The corresponding handler is `onPointsReplaced`.

pressed(point point)

This signal is emitted when the user presses the data point point in the chart and holds down the mouse button. For example:

     LineSeries {
         XYPoint { x: 0; y: 0 }
         XYPoint { x: 1.1; y: 2.1 }
         onPressed: console.log("onPressed: " + point.x + ", " + point.y);
     }

The corresponding signal handler is `onPressed()`.

Note: The corresponding handler is `onPressed`.

See also clicked(), released(), and doubleClicked().

released(point point)

This signal is emitted when the user releases the mouse press on the data point specified by point. For example:

     LineSeries {
         XYPoint { x: 0; y: 0 }
         XYPoint { x: 1.1; y: 2.1 }
         onReleased: console.log("onReleased: " + point.x + ", " + point.y);
     }

The corresponding signal handler is `onReleased()`.

Note: The corresponding handler is `onReleased`.

See also pressed(), clicked(), and doubleClicked().

## Method Documentation

append(real x, real y)

Appends a point with the coordinates x and y to the series.

QPointF at(int index)

Returns the point at the position specified by index. Returns (0, 0) if the index is not valid.

insert(int index, real x, real y)

Inserts a point with the coordinates x and y to the position specified by index in the series. If the index is 0 or less than 0, the point is prepended to the list of points. If the index is equal to or greater than than the number of points in the series, the point is appended to the list of points.

remove(int index)

Removes the point at the position specified by index from the series.

remove(real x, real y)

Removes the point with the coordinates x and y from the series. Does nothing if the point does not exist.

removePoints(int index, int count)

Removes the number of points specified by count from the series starting at the position specified by index.

replace(real oldX, real oldY, real newX, real newY)

Replaces the point with the coordinates oldX and oldY with the point with the coordinates newX and newY. Does nothing if the old point does not exist.