QAbstractSeries Class

The QAbstractSeries class is the base class of the data series of a chart. More…

Header	`#include <QAbstractSeries>`
CMake	`target_link_libraries(app PRIVATE Nt::Charts)`
Module	Nt Charts C++ Classes
Inherits	QObject
Inherited by	QAbstractBarSeries, QAreaSeries, QPieSeries, QXYSeries

List of all members, including inherited members

Public Types

enum	SeriesType

Public Functions

	~QAbstractSeries()
virtual SeriesType	type() const
void	setName(const QString &name)
QString	name() const
void	setVisible(bool visible = true)
bool	isVisible() const
qreal	opacity() const
void	setOpacity(qreal opacity)
void	setUseOpenGL(bool enable = true)
bool	useOpenGL() const
QChart *	chart() const
bool	attachAxis(QAbstractAxis *axis)
bool	detachAxis(QAbstractAxis *axis)
QList<QAbstractAxis *>	attachedAxes()
void	show()
void	hide()

Signals

void	nameChanged()
void	visibleChanged()
void	opacityChanged()
void	useOpenGLChanged()

Protected Functions

	QAbstractSeries(QObject *parent = nullptr)
void	markChanged()

Detailed Description

A series holds data and the way it is drawn. Add it to a chart with QChart::addSeries(); the chart then owns it. A series is drawn against the axes attached to it with attachAxis(), or, with none, against a scale that fits its data.

See also QChart, QXYSeries, QAbstractBarSeries, QPieSeries and QAreaSeries.

Differences from Qt

The series is drawn by the chart; there is no OpenGL acceleration, and useOpenGL() is kept but has no effect. A series has at most one axis of each orientation: attaching a second one detaches the first.

Member Type Documentation

enum QAbstractSeries::SeriesType

The type of a series.

Constant	Description
`QAbstractSeries::SeriesTypeLine`	A QLineSeries.
`QAbstractSeries::SeriesTypeArea`	A QAreaSeries.
`QAbstractSeries::SeriesTypeBar`	A QBarSeries.
`QAbstractSeries::SeriesTypeStackedBar`	A QStackedBarSeries.
`QAbstractSeries::SeriesTypePercentBar`	A QPercentBarSeries.
`QAbstractSeries::SeriesTypePie`	A QPieSeries.
`QAbstractSeries::SeriesTypeScatter`	A QScatterSeries.
`QAbstractSeries::SeriesTypeSpline`	A QSplineSeries.
`QAbstractSeries::SeriesTypeHorizontalBar`	A QHorizontalBarSeries.
`QAbstractSeries::SeriesTypeHorizontalStackedBar`	A QHorizontalStackedBarSeries.
`QAbstractSeries::SeriesTypeHorizontalPercentBar`	A QHorizontalPercentBarSeries.
`QAbstractSeries::SeriesTypeBoxPlot`	A box plot series; Nt has none.
`QAbstractSeries::SeriesTypeCandlestick`	A candlestick series; Nt has none.

Member Function Documentation

[explicit, protected] QAbstractSeries::QAbstractSeries(QObject **parent* = nullptr)

Constructs a series with the given parent.

[override] QAbstractSeries::~QAbstractSeries()

Destroys the series and removes it from its chart.

bool QAbstractSeries::attachAxis(QAbstractAxis **axis*)

Attaches axis to the series, so that the series is drawn against it. Both must be in the same chart. An axis of the same orientation that was attached before is detached. Returns true on success.

If the range of axis was not set, it becomes the extent of the data of its series.

See also detachAxis() and QChart::addAxis().

QList<QAbstractAxis *> QAbstractSeries::attachedAxes()

Returns the axes attached to the series.

QChart * QAbstractSeries::chart() const

Returns the chart the series is in, or nullptr if it is in none.

bool QAbstractSeries::detachAxis(QAbstractAxis **axis*)

Detaches axis from the series. Returns true on success.

void QAbstractSeries::hide()

Hides the series.

bool QAbstractSeries::isVisible() const

Returns true if the series is drawn; otherwise returns false.

[protected] void QAbstractSeries::markChanged()

Tells the chart that the series must be drawn again.

QString QAbstractSeries::name() const

Returns the name of the series.

[signal] void QAbstractSeries::nameChanged()

This signal is emitted when the name of the series changes.

qreal QAbstractSeries::opacity() const

Returns the opacity of the series, from 0.0 (transparent) to 1.0 (opaque).

[signal] void QAbstractSeries::opacityChanged()

This signal is emitted when the opacity of the series changes.

void QAbstractSeries::setName(const QString &name)

Sets the name of the series to name. The legend shows it.

void QAbstractSeries::setOpacity(qreal opacity)

Sets the opacity of the series to opacity, from 0.0 (transparent) to 1.0 (opaque).

void QAbstractSeries::setUseOpenGL(bool enable = true)

Sets whether the series asks for OpenGL to enable. Nt draws every series the same way, so this has no effect.

void QAbstractSeries::setVisible(bool visible = true)

Shows the series if visible is true and hides it otherwise.

void QAbstractSeries::show()

Shows the series.

[virtual] SeriesType QAbstractSeries::type() const

Returns the type of the series.

bool QAbstractSeries::useOpenGL() const

Returns true if setUseOpenGL() was set; otherwise returns false.

[signal] void QAbstractSeries::useOpenGLChanged()

This signal is emitted when useOpenGL() changes.

[signal] void QAbstractSeries::visibleChanged()

This signal is emitted when the series is shown or hidden.