QPieSeries Class

The QPieSeries class draws its slices as a pie or a donut. More…

List of all members, including inherited members

Public Functions

Reimplemented Public Functions

Signals

Detailed Description

Each QPieSlice takes a share of the circle in proportion to its value. setHoleSize() makes the pie a donut, and setPieStartAngle() and setPieEndAngle() draw part of a circle, such as a half-circle gauge. The series owns its slices.

auto *series = new QPieSeries;
series->setHoleSize(0.4);
series->append("Passed", 182);
series->append("Skipped", 11);
QPieSlice *failed = series->append("Failed", 7);
failed->setExploded(true);
failed->setLabelVisible(true);
QObject::connect(series, &QPieSeries::hovered, [](QPieSlice *slice, bool state) { slice->setExploded(state); });

auto *chart = new QChart;
chart->setTitle("Tests");
chart->addSeries(series);
chart->legend()->setAlignment(Qt::AlignRight);

A pie series has no axes. The pie is centered at horizontalPosition() and verticalPosition() of the plot area, and its diameter is pieSize() times the smaller side of the plot area. Outside labels must fit in the plot area, so the pie is made smaller when they need the room.

See also QPieSlice.

Differences from Qt

Member Function Documentation

[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)

Constructs an empty pie series with the given parent.

[override] QPieSeries::~QPieSeries()

Destroys the series and its slices.

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

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

bool QPieSeries::append(QPieSlice *slice)

Appends slice to the series, which takes ownership of it. Returns false if slice is nullptr or already in a series.

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

This is an overloaded function.

Appends slices. Returns false, and appends none of them, if one of them is nullptr, appears twice or is already in a series.

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

This is an overloaded function.

Appends a new slice called label with the value value, and returns it.

void QPieSeries::clear()

Removes and deletes all slices.

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

This signal is emitted when the user clicks slice.

int QPieSeries::count() const

Returns the number of slices.

[signal] void QPieSeries::countChanged()

This signal is emitted when the number of slices changes.

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

This signal is emitted when the user double-clicks slice.

qreal QPieSeries::holeSize() const

Returns the diameter of the hole, as a share of the smaller side of the plot area.

qreal QPieSeries::horizontalPosition() const

Returns the horizontal position of the center, from 0.0 to 1.0.

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

This signal is emitted when the mouse enters or leaves slice; state is true when it enters.

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

Inserts slice at index; an index out of range appends it. Returns false if slice is nullptr or already in a series.

bool QPieSeries::isEmpty() const

Returns true if the series has no slices; otherwise returns false.

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

Appends slice and returns a reference to the series.

qreal QPieSeries::pieEndAngle() const

Returns the angle at which the last slice ends.

qreal QPieSeries::pieSize() const

Returns the diameter of the pie, as a share of the smaller side of the plot area.

qreal QPieSeries::pieStartAngle() const

Returns the angle at which the first slice starts.

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

This signal is emitted when the user presses a mouse button on slice.

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

This signal is emitted when the user releases a mouse button on slice.

bool QPieSeries::remove(QPieSlice *slice)

Removes slice from the series and deletes it. Returns true on success.

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

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

void QPieSeries::setHoleSize(qreal holeSize)

Sets the diameter of the hole in the middle to holeSize, as a share of the smaller side of the plot area, from 0.0 (a pie) to pieSize() (nothing left).

void QPieSeries::setHorizontalPosition(qreal relativePosition)

Sets the horizontal position of the center to relativePosition, from 0.0 (left edge of the plot area) to 1.0 (right edge). The default is 0.5.

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

Sets where the labels of all slices are drawn to position.

void QPieSeries::setLabelsVisible(bool visible = true)

Shows the labels of all slices if visible is true, and hides them otherwise.

void QPieSeries::setPieEndAngle(qreal endAngle)

Sets the angle at which the last slice ends to endAngle degrees, clockwise from 12 o'clock. The default is 360.

void QPieSeries::setPieSize(qreal relativeSize)

Sets the diameter of the pie to relativeSize, as a share of the smaller side of the plot area, from 0.0 to 1.0. The default is 0.7.

void QPieSeries::setPieStartAngle(qreal startAngle)

Sets the angle at which the first slice starts to startAngle degrees, clockwise from 12 o'clock. The default is 0.

void QPieSeries::setVerticalPosition(qreal relativePosition)

Sets the vertical position of the center to relativePosition, from 0.0 (top edge of the plot area) to 1.0 (bottom edge). The default is 0.5.

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

Returns the slices.

qreal QPieSeries::sum() const

Returns the sum of the values of the slices; negative values count as zero.

[signal] void QPieSeries::sumChanged()

This signal is emitted when the sum of the values changes.

bool QPieSeries::take(QPieSlice *slice)

Removes slice from the series without deleting it; the caller owns it. Returns true on success.

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

Reimplements QAbstractSeries::type().

Returns QAbstractSeries::SeriesTypePie.

qreal QPieSeries::verticalPosition() const

Returns the vertical position of the center, from 0.0 to 1.0.