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 QChart
- class PySide6.QtCharts.QPieSeries([parent=None])#
- Parameters:
parent – PySide6.QtCore.QObject
Constructs a series object that is a child of parent
.
Note
Properties can be used directly when from __feature__ import true_property
is used or via accessor functions otherwise.
- property PᅟySide6.QtCharts.QPieSeries.count: int#
This property holds The number of slices in the series..
- Access functions:
count ()
Signal countChanged ()
- property PᅟySide6.QtCharts.QPieSeries.endAngle: float#
This property holds The ending angle of the pie..
A full pie is 360 degrees, where 0 degrees is at 12 a’clock.
The default value is 360.
- Access functions:
pieEndAngle ()
setPieEndAngle (endAngle)
- property PᅟySide6.QtCharts.QPieSeries.holeSize: float#
This property holds The donut hole size..
The value is relative to the chart rectangle, so that:
0.0 is the minimum size (full pie drawn without a hole).
1.0 is the maximum size that can fit the chart (the donut has no width).
When setting this property, the size
property is adjusted if necessary, to ensure that the hole size is not greater than the pie size.
The default value is 0.0.
- Access functions:
holeSize ()
setHoleSize (holeSize)
- property PᅟySide6.QtCharts.QPieSeries.horizontalPosition: float#
This property holds The horizontal position of the pie..
The value is relative to the chart rectangle, so that:
0.0 is the absolute left.
1.0 is the absolute right.
The default value is 0.5 (center).
See also
verticalPosition
- Access functions:
horizontalPosition ()
setHorizontalPosition (relativePosition)
- property PᅟySide6.QtCharts.QPieSeries.size: float#
This property holds The pie size..
The value is relative to the chart rectangle, so that:
0.0 is the minimum size (pie not drawn).
1.0 is the maximum size that can fit the chart.
When setting this property, the holeSize property is adjusted if necessary, to ensure that the hole size is not greater than the pie size.
The default value is 0.7.
- Access functions:
pieSize ()
setPieSize (relativeSize)
- property PᅟySide6.QtCharts.QPieSeries.startAngle: float#
This property holds The starting angle of the pie..
A full pie is 360 degrees, where 0 degrees is at 12 a’clock.
The default value is 0.
- Access functions:
pieStartAngle ()
setPieStartAngle (startAngle)
- property PᅟySide6.QtCharts.QPieSeries.sum: float#
This property holds The sum of all slices..
The series keeps track of the sum of all the slices it holds.
- Access functions:
sum ()
Signal sumChanged ()
- property PᅟySide6.QtCharts.QPieSeries.verticalPosition: float#
This property holds The vertical position of the pie..
The value is relative to the chart rectangle, so that:
0.0 is the absolute top.
1.0 is the absolute bottom.
The default value is 0.5 (center).
See also
horizontalPosition
- Access functions:
verticalPosition ()
setVerticalPosition (relativePosition)
- PySide6.QtCharts.QPieSeries.added(slices)#
- Parameters:
slices –
This signal is emitted when the slices specified by slices
are added to the series.
See also
append() insert()
- PySide6.QtCharts.QPieSeries.append(slice)#
- Parameters:
slice – PySide6.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.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(slices)
- Parameters:
slices –
- Return type:
bool
Appends the array of slices specified by slices
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:
slice – PySide6.QtCharts.QPieSlice
This signal is emitted when the slice specified by slice
is clicked.
See also
clicked()
- PySide6.QtCharts.QPieSeries.count()#
- Return type:
int
Returns the number of the slices in this series.
Getter of property count .
- PySide6.QtCharts.QPieSeries.countChanged()#
This signal is emitted when the slice count changes.
See also
count
Notification signal of property count .
- PySide6.QtCharts.QPieSeries.doubleClicked(slice)#
- Parameters:
slice – PySide6.QtCharts.QPieSlice
This signal is emitted when the slice specified by slice
is double-clicked.
See also
doubleClicked()
- PySide6.QtCharts.QPieSeries.holeSize()#
- Return type:
float
See also
setHoleSize()
Getter of property holeSize .
- PySide6.QtCharts.QPieSeries.horizontalPosition()#
- Return type:
float
See also
setHorizontalPosition()
Getter of property horizontalPosition .
- PySide6.QtCharts.QPieSeries.hovered(slice, state)#
- Parameters:
slice – PySide6.QtCharts.QPieSlice
state – bool
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
hovered()
- PySide6.QtCharts.QPieSeries.insert(index, slice)#
- Parameters:
index – int
slice – PySide6.QtCharts.QPieSlice
- 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:
slice – PySide6.QtCharts.QPieSlice
- Return type:
PySide6.QtCharts.QPieSeries
Appends the slice specified by slice
to the series and returns a reference to the series. Slice ownership is passed to the series.
- 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.
See also
setPieEndAngle() pieStartAngle() setPieStartAngle()
Getter of property endAngle .
- PySide6.QtCharts.QPieSeries.pieSize()#
- Return type:
float
See also
setPieSize()
Getter of property size .
- PySide6.QtCharts.QPieSeries.pieStartAngle()#
- Return type:
float
See also
setPieStartAngle()
Getter of property startAngle .
- PySide6.QtCharts.QPieSeries.pressed(slice)#
- Parameters:
slice – PySide6.QtCharts.QPieSlice
This signal is emitted when the user clicks the slice specified by slice
and holds down the mouse button.
See also
pressed()
- PySide6.QtCharts.QPieSeries.released(slice)#
- Parameters:
slice – PySide6.QtCharts.QPieSlice
This signal is emitted when the user releases the mouse press on the slice specified by slice
.
See also
released()
- PySide6.QtCharts.QPieSeries.remove(slice)#
- Parameters:
slice – PySide6.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 –
This signal is emitted when the slices specified by slices
are removed from the series.
See also
remove()
- PySide6.QtCharts.QPieSeries.setHoleSize(holeSize)#
- Parameters:
holeSize – float
See also
holeSize()
Setter of property holeSize .
- PySide6.QtCharts.QPieSeries.setHorizontalPosition(relativePosition)#
- Parameters:
relativePosition – float
See also
horizontalPosition()
Setter of property horizontalPosition .
- PySide6.QtCharts.QPieSeries.setLabelsPosition(position)#
- Parameters:
position – LabelPosition
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
.
See also
labelPosition() setLabelPosition()
- 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
.
See also
isLabelVisible() setLabelVisible()
- 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.
See also
pieEndAngle() pieStartAngle() setPieStartAngle()
Setter of property endAngle .
- PySide6.QtCharts.QPieSeries.setPieSize(relativeSize)#
- Parameters:
relativeSize – float
See also
pieSize()
Setter of property size .
- PySide6.QtCharts.QPieSeries.setPieStartAngle(startAngle)#
- Parameters:
startAngle – float
See also
pieStartAngle()
Setter of property startAngle .
- PySide6.QtCharts.QPieSeries.setVerticalPosition(relativePosition)#
- Parameters:
relativePosition – float
See also
verticalPosition()
Setter of property verticalPosition .
- 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.
See also
value() setValue() percentage()
Getter of property sum .
- PySide6.QtCharts.QPieSeries.sumChanged()#
This signal is emitted when the sum of all slices changes.
See also
sum
Notification signal of property sum .
- PySide6.QtCharts.QPieSeries.take(slice)#
- Parameters:
slice – PySide6.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
See also
setVerticalPosition()
Getter of property verticalPosition .