QPieSeries Class

The QPieSeries class presents data in pie charts. More...

Header:	#include <QPieSeries>
Instantiated By:	PieSeries
Inherits:	QAbstractSeries

• List of all members, including inherited members

Properties

count : const int endAngle : qreal holeSize : qreal horizontalPosition : qreal

size : qreal startAngle : qreal sum : const qreal verticalPosition : qreal

Public Functions

	QPieSeries(QObject *parent = nullptr)
virtual	~QPieSeries()
bool	append(QPieSlice *slice)
bool	append(QList<QPieSlice *> slices)
QPieSlice *	append(QString label, qreal value)
void	clear()
int	count() const
qreal	holeSize() const
qreal	horizontalPosition() const
bool	insert(int index, QPieSlice *slice)
bool	isEmpty() const
qreal	pieEndAngle() const
qreal	pieSize() const
qreal	pieStartAngle() const
bool	remove(QPieSlice *slice)
void	setHoleSize(qreal holeSize)
void	setHorizontalPosition(qreal relativePosition)
void	setLabelsPosition(QPieSlice::LabelPosition position)
void	setLabelsVisible(bool visible = true)
void	setPieEndAngle(qreal angle)
void	setPieSize(qreal relativeSize)
void	setPieStartAngle(qreal startAngle)
void	setVerticalPosition(qreal relativePosition)
QList<QPieSlice *>	slices() const
qreal	sum() const
bool	take(QPieSlice *slice)
qreal	verticalPosition() const
QPieSeries &	operator<<(QPieSlice *slice)

Reimplemented Public Functions

virtual QAbstractSeries::SeriesType

type() const override

Signals

void	added(QList<QPieSlice *> slices)
void	clicked(QPieSlice *slice)
void	countChanged()
void	doubleClicked(QPieSlice *slice)
void	hovered(QPieSlice *slice, bool state)
void	pressed(QPieSlice *slice)
void	released(QPieSlice *slice)
void	removed(QList<QPieSlice *> slices)
void	sumChanged()

Detailed Description

A pie series consists of slices that are defined as QPieSlice objects. The slices can have any values as the QPieSeries object calculates the percentage of a slice compared with the sum of all slices in the series to determine the actual size of the slice in the chart.

Pie size and position on the chart are controlled by using relative values that range from 0.0 to 1.0. These relate to the actual chart rectangle.

By default, the pie is defined as a full pie. A partial pie can be created by setting a starting angle and angle span for the series. A full pie is 360 degrees, where 0 is at 12 a'clock.

See the pie chart example or donut chart example to learn how to use QPieSeries.

See also QPieSlice and QChart.

Member Function Documentation

QPieSeries::QPieSeries(QObject *parent = nullptr)

Constructs a series object that is a child of parent.

[signal] void QPieSeries::added(QList<QPieSlice *> slices)

This signal is emitted when the slices specified by slices are added to the series.

See also append() and insert().

[signal] void QPieSeries::clicked(QPieSlice *slice)

This signal is emitted when the slice specified by slice is clicked.

See also QPieSlice::clicked().

[signal] void QPieSeries::countChanged()

This signal is emitted when the slice count changes.

Note: Notifier signal for property count.

See also count.

[signal] void QPieSeries::doubleClicked(QPieSlice *slice)

This signal is emitted when the slice specified by slice is double-clicked.

See also QPieSlice::doubleClicked().

[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)

This signal is emitted when a mouse is hovered over the slice specified by slice. When the mouse moves over the slice, state turns true, and when the mouse moves away again, it turns false.

See also QPieSlice::hovered().

[signal] void QPieSeries::pressed(QPieSlice *slice)

This signal is emitted when the user clicks the slice specified by slice and holds down the mouse button.

See also QPieSlice::pressed().

[signal] void QPieSeries::released(QPieSlice *slice)

This signal is emitted when the user releases the mouse press on the slice specified by slice.

See also QPieSlice::released().

[signal] void QPieSeries::removed(QList<QPieSlice *> slices)

This signal is emitted when the slices specified by slices are removed from the series.

See also remove().

[signal] void QPieSeries::sumChanged()

This signal is emitted when the sum of all slices changes.

Note: Notifier signal for property sum.

See also sum.

[virtual] QPieSeries::~QPieSeries()

Removes the pie series and its slices.

bool QPieSeries::append(QPieSlice *slice)

Appends the slice specified by slice to the series. Slice ownership is passed to the series.

Returns true if appending succeeds.

bool QPieSeries::append(QList<QPieSlice *> slices)

Appends the array of slices specified by slices to the series. Slice ownership is passed to the series.

Returns true if appending succeeds.

QPieSlice *QPieSeries::append(QString label, qreal value)

Appends a single slice with the specified value and label to the series. Slice ownership is passed to the series. Returns null if value is NaN, Inf, or -Inf and adds nothing to the series.

void QPieSeries::clear()

Clears all slices from the series.

int QPieSeries::count() const

Returns the number of the slices in this series.

Note: Getter function for property count.

bool QPieSeries::insert(int index, QPieSlice *slice)

Inserts the slice specified by slice to the series before the slice at the position specified by index. Slice ownership is passed to the series.

Returns true if inserting succeeds.

bool QPieSeries::isEmpty() const

Returns true if the series is empty.

qreal QPieSeries::pieEndAngle() const

Returns the end angle of the pie.

A full pie is 360 degrees, where 0 degrees is at 12 a'clock.

Note: Getter function for property endAngle.

See also setPieEndAngle(), pieStartAngle(), and setPieStartAngle().

bool QPieSeries::remove(QPieSlice *slice)

Removes a single slice, specified by slice, from the series and deletes it permanently.

The pointer cannot be referenced after this call.

Returns true if the removal succeeds.

void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)

Sets the position of all the slice labels to position.

Note: This function affects only the current slices in the series. If a new slice is added, the default label position is QPieSlice::LabelOutside.

See also QPieSlice::labelPosition() and QPieSlice::setLabelPosition().

void QPieSeries::setLabelsVisible(bool visible = true)

Sets the visibility of all slice labels to visible.

Note: This function affects only the current slices in the series. If a new slice is added, the default label visibility is false.

See also QPieSlice::isLabelVisible() and QPieSlice::setLabelVisible().

void QPieSeries::setPieEndAngle(qreal angle)

Sets the end angle of the pie.

A full pie is 360 degrees, where 0 degrees is at 12 a'clock.

angle must be greater than the start angle.

Note: Setter function for property endAngle.

See also pieEndAngle(), pieStartAngle(), and setPieStartAngle().

QList<QPieSlice *> QPieSeries::slices() const

Returns a list of slices that belong to this series.

qreal QPieSeries::sum() const

Returns the sum of all slice values in this series.

Note: Getter function for property sum.

See also QPieSlice::value(), QPieSlice::setValue(), and QPieSlice::percentage().

bool QPieSeries::take(QPieSlice *slice)

Takes a single slice, specified by slice, from the series. Does not delete the slice object.

Note: The series remains the slice's parent object. You must set the parent object to take full ownership.

Returns true if the take operation was successful.

[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const

Reimplements an access function for property: QAbstractSeries::type.

Returns the type of the series.

QPieSeries &QPieSeries::operator<<(QPieSlice *slice)

Appends the slice specified by slice to the series and returns a reference to the series. Slice ownership is passed to the series.