QPieSeries

The QPieSeries class presents data in pie charts. More

Inheritance diagram of PySide6.QtCharts.QPieSeries

Synopsis

Functions

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 .

../../_images/examples_piechart.png ../../_images/examples_donutchart.png

See also

QPieSlice QChart

class PySide6.QtCharts.QPieSeries([parent=None])
Parameters

parentPySide6.QtCore.QObject

Constructs a series object that is a child of parent.

PySide6.QtCharts.QPieSeries.added(slices)
Parameters

slices

PySide6.QtCharts.QPieSeries.append(slices)
Parameters

slices

Return type

bool

PySide6.QtCharts.QPieSeries.append(label, value)
Parameters
  • label – str

  • value – float

Return type

PySide6.QtCharts.QPieSlice

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.

PySide6.QtCharts.QPieSeries.append(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

Return type

bool

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

Returns true if appending succeeds.

PySide6.QtCharts.QPieSeries.clear()

Clears all slices from the series.

PySide6.QtCharts.QPieSeries.clicked(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

PySide6.QtCharts.QPieSeries.count()
Return type

int

Returns the number of the slices in this series.

PySide6.QtCharts.QPieSeries.countChanged()
PySide6.QtCharts.QPieSeries.doubleClicked(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

PySide6.QtCharts.QPieSeries.holeSize()
Return type

float

See also

setHoleSize()

PySide6.QtCharts.QPieSeries.horizontalPosition()
Return type

float

PySide6.QtCharts.QPieSeries.hovered(slice, state)
Parameters
PySide6.QtCharts.QPieSeries.insert(index, slice)
Parameters
Return type

bool

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.

PySide6.QtCharts.QPieSeries.isEmpty()
Return type

bool

Returns true if the series is empty.

PySide6.QtCharts.QPieSeries.__lshift__(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

Return type

PySide6.QtCharts.QPieSeries

PySide6.QtCharts.QPieSeries.pieEndAngle()
Return type

float

Returns the end angle of the pie.

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

PySide6.QtCharts.QPieSeries.pieSize()
Return type

float

See also

setPieSize()

PySide6.QtCharts.QPieSeries.pieStartAngle()
Return type

float

PySide6.QtCharts.QPieSeries.pressed(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

PySide6.QtCharts.QPieSeries.released(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

PySide6.QtCharts.QPieSeries.remove(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

Return type

bool

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.

PySide6.QtCharts.QPieSeries.removed(slices)
Parameters

slices

PySide6.QtCharts.QPieSeries.setHoleSize(holeSize)
Parameters

holeSize – float

See also

holeSize()

PySide6.QtCharts.QPieSeries.setHorizontalPosition(relativePosition)
Parameters

relativePosition – float

PySide6.QtCharts.QPieSeries.setLabelsPosition(position)
Parameters

positionLabelPosition

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 LabelOutside .

PySide6.QtCharts.QPieSeries.setLabelsVisible([visible=true])
Parameters

visible – bool

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.

PySide6.QtCharts.QPieSeries.setPieEndAngle(endAngle)
Parameters

endAngle – float

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.

PySide6.QtCharts.QPieSeries.setPieSize(relativeSize)
Parameters

relativeSize – float

See also

pieSize()

PySide6.QtCharts.QPieSeries.setPieStartAngle(startAngle)
Parameters

startAngle – float

See also

pieStartAngle()

PySide6.QtCharts.QPieSeries.setVerticalPosition(relativePosition)
Parameters

relativePosition – float

PySide6.QtCharts.QPieSeries.slices()
Return type

Returns a list of slices that belong to this series.

PySide6.QtCharts.QPieSeries.sum()
Return type

float

Returns the sum of all slice values in this series.

PySide6.QtCharts.QPieSeries.sumChanged()
PySide6.QtCharts.QPieSeries.take(slice)
Parameters

slicePySide6.QtCharts.QPieSlice

Return type

bool

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.

PySide6.QtCharts.QPieSeries.verticalPosition()
Return type

float