QPieSeries#

The QPieSeries class presents data in pie charts. More…

Synopsis#

Functions#

def __lshift__ (slice)
def append (label, value)
def append (slice)
def append (slices)
def clear ()
def count ()
def holeSize ()
def horizontalPosition ()
def insert (index, slice)
def isEmpty ()
def pieEndAngle ()
def pieSize ()
def pieStartAngle ()
def remove (slice)
def setHoleSize (holeSize)
def setHorizontalPosition (relativePosition)
def setLabelsPosition (position)
def setLabelsVisible ([visible=true])
def setPieEndAngle (endAngle)
def setPieSize (relativeSize)
def setPieStartAngle (startAngle)
def setVerticalPosition (relativePosition)
def slices ()
def sum ()
def take (slice)
def verticalPosition ()

Signals#

def added (slices)
def clicked (slice)
def countChanged ()
def doubleClicked (slice)
def hovered (slice, state)
def pressed (slice)
def released (slice)
def removed (slices)
def 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 QChart

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

Parameters: parent – PySide6.QtCore.QObject

Constructs a series object that is a child of parent.

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(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.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: 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.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

This property holds The number of slices in the series..

PySide6.QtCharts.QPieSeries.countChanged()#

This signal is emitted when the slice count changes.

See also

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

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.

PySide6.QtCharts.QPieSeries.horizontalPosition()#

Return type: 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

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

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.

PySide6.QtCharts.QPieSeries.pieSize()#

Return type: 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.

PySide6.QtCharts.QPieSeries.pieStartAngle()#

Return type: 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.

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

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.

PySide6.QtCharts.QPieSeries.setHorizontalPosition(relativePosition)#

Parameters: relativePosition – 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

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 .