QBoxPlotSeries#

The QBoxPlotSeries class presents data in box-and-whiskers charts. More

Inheritance diagram of PySide6.QtCharts.QBoxPlotSeries

Synopsis#

Properties#

  • boxOutlineVisible - Visibility of the box outline

  • boxWidth - Width of the box-and-whiskers item. The value indicates the relative width of the item within its category. The value can be between 0.0 and 1.0. Negative values are replaced with 0.0 and values greater than 1.0 are replaced with 1.0

  • brush - Used to fill the boxes of the box-and-whiskers items

  • count - Number of box-and-whiskers items in a box plot series

  • pen - Used to draw the lines of the box-and-whiskers items

Functions#

Signals#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

A box plot series acts as a container for box-and-whiskers items. Items from multiple series are grouped into categories according to their index value.

The QBarCategoryAxis class is used to add the categories to the chart’s axis. Category labels have to be unique. If the same category label is defined for several box-and-whiskers items, only the first one is drawn.

See the Charts with Widgets Gallery to learn how to create a box-and-whiskers chart.

class PySide6.QtCharts.QBoxPlotSeries([parent=None])#
Parameters:

parentPySide6.QtCore.QObject

Constructs an empty box plot series that is a QObject and 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.QBoxPlotSeries.boxOutlineVisible: bool#

This property holds The visibility of the box outline..

Access functions:
property PᅟySide6.QtCharts.QBoxPlotSeries.boxWidth: float#

This property holds The width of the box-and-whiskers item. The value indicates the relative width of the item within its category. The value can be between 0.0 and 1.0. Negative values are replaced with 0.0 and values greater than 1.0 are replaced with 1.0..

Access functions:
property PᅟySide6.QtCharts.QBoxPlotSeries.brush: PySide6.QtGui.QBrush#

This property holds The brush used to fill the boxes of the box-and-whiskers items..

Access functions:
property PᅟySide6.QtCharts.QBoxPlotSeries.count: int#

This property holds The number of box-and-whiskers items in a box plot series..

Access functions:
property PᅟySide6.QtCharts.QBoxPlotSeries.pen: PySide6.QtGui.QPen#

This property holds The pen used to draw the lines of the box-and-whiskers items..

Access functions:
PySide6.QtCharts.QBoxPlotSeries.append(boxes)#
Parameters:

boxes – .list of QBoxSet

Return type:

bool

Adds a list of box-and-whiskers items specified by sets to the series and takes ownership of them. If the list is null or the items already belong to the series, it will not be appended. Returns true if appending succeeded.

PySide6.QtCharts.QBoxPlotSeries.append(box)
Parameters:

boxPySide6.QtCharts.QBoxSet

Return type:

bool

Adds a single box-and-whiskers item specified by set to the series and takes ownership of it. If the item is null or it already belongs to the series, it will not be appended. Returns true if appending succeeded.

PySide6.QtCharts.QBoxPlotSeries.boxOutlineVisibilityChanged()#

This signal is emitted when the box outline visibility changes.

Notification signal of property boxOutlineVisible .

PySide6.QtCharts.QBoxPlotSeries.boxOutlineVisible()#
Return type:

bool

Getter of property boxOutlineVisible .

PySide6.QtCharts.QBoxPlotSeries.boxSets()#
Return type:

.list of QBoxSet

Returns a list of box-and-whiskers items in a box plot series. Keeps the ownership of the items.

PySide6.QtCharts.QBoxPlotSeries.boxWidth()#
Return type:

float

See also

setBoxWidth()

Getter of property boxWidth .

PySide6.QtCharts.QBoxPlotSeries.boxWidthChanged()#

This signal is emitted when the width of the box-and-whiskers item changes.

Notification signal of property boxWidth .

PySide6.QtCharts.QBoxPlotSeries.boxsetsAdded(sets)#
Parameters:

sets – .list of QBoxSet

This signal is emitted when the list of box-and-whiskers items specified by sets is added to the series.

PySide6.QtCharts.QBoxPlotSeries.boxsetsRemoved(sets)#
Parameters:

sets – .list of QBoxSet

This signal is emitted when the list of box-and-whiskers items specified by sets is removed from the series.

PySide6.QtCharts.QBoxPlotSeries.brush()#
Return type:

PySide6.QtGui.QBrush

See also

setBrush()

Getter of property brush .

PySide6.QtCharts.QBoxPlotSeries.brushChanged()#

This signal is emitted when the brush used to fill the boxes of the box-and-whiskers items changes.

Notification signal of property brush .

PySide6.QtCharts.QBoxPlotSeries.clear()#

Removes all box-and-whiskers items from the series and permanently deletes them.

PySide6.QtCharts.QBoxPlotSeries.clicked(boxset)#
Parameters:

boxsetPySide6.QtCharts.QBoxSet

This signal is emitted when the user clicks the box-and-whiskers item specified by boxset in the chart.

PySide6.QtCharts.QBoxPlotSeries.count()#
Return type:

int

Returns the number of box-and-whiskers items in a box plot series.

Getter of property count .

PySide6.QtCharts.QBoxPlotSeries.countChanged()#

This signal is emitted when the number of box-and-whiskers items in the series changes.

Notification signal of property count .

PySide6.QtCharts.QBoxPlotSeries.doubleClicked(boxset)#
Parameters:

boxsetPySide6.QtCharts.QBoxSet

This signal is emitted when the user double-clicks the box-and-whiskers item specified by boxset in the chart.

PySide6.QtCharts.QBoxPlotSeries.hovered(status, boxset)#
Parameters:

This signal is emitted when a mouse is hovered over the box-and-whiskers item specified by boxset in the chart. When the mouse moves over the item, status turns true, and when the mouse moves away again, it turns false.

PySide6.QtCharts.QBoxPlotSeries.insert(index, box)#
Parameters:
Return type:

bool

Inserts a box-and-whiskers item specified by set to a series at the position specified by index and takes ownership of the item. If the item is null or already belongs to the series, it will not be appended. Returns true if inserting succeeds.

PySide6.QtCharts.QBoxPlotSeries.pen()#
Return type:

PySide6.QtGui.QPen

See also

setPen()

Getter of property pen .

PySide6.QtCharts.QBoxPlotSeries.penChanged()#

This signal is emitted when the pen used to draw the lines of the box-and-whiskers items changes.

Notification signal of property pen .

PySide6.QtCharts.QBoxPlotSeries.pressed(boxset)#
Parameters:

boxsetPySide6.QtCharts.QBoxSet

This signal is emitted when the user clicks the box-and-whiskers item specified by boxset in the chart and holds down the mouse button.

PySide6.QtCharts.QBoxPlotSeries.released(boxset)#
Parameters:

boxsetPySide6.QtCharts.QBoxSet

This signal is emitted when the user releases the mouse press on the box-and-whiskers item specified by boxset in the chart.

PySide6.QtCharts.QBoxPlotSeries.remove(box)#
Parameters:

boxPySide6.QtCharts.QBoxSet

Return type:

bool

Removes the box-and-whiskers item specified by set from the series and permanently deletes it if the removal succeeds. Returns true if the item was removed.

PySide6.QtCharts.QBoxPlotSeries.setBoxOutlineVisible(visible)#
Parameters:

visible – bool

Setter of property boxOutlineVisible .

PySide6.QtCharts.QBoxPlotSeries.setBoxWidth(width)#
Parameters:

width – float

See also

boxWidth()

Setter of property boxWidth .

PySide6.QtCharts.QBoxPlotSeries.setBrush(brush)#
Parameters:

brushPySide6.QtGui.QBrush

See also

brush()

Setter of property brush .

PySide6.QtCharts.QBoxPlotSeries.setPen(pen)#
Parameters:

penPySide6.QtGui.QPen

See also

pen()

Setter of property pen .

PySide6.QtCharts.QBoxPlotSeries.take(box)#
Parameters:

boxPySide6.QtCharts.QBoxSet

Return type:

bool

Takes the box-and-whiskers item specified by set from the series. Does not delete the item.

Note

The series remains the item’s parent object. You must set the parent object to take full ownership.

Returns true if the take operation succeeds.