class QBarSet

The QBarSet class represents one set of bars in a bar graph. More

Inheritance diagram of PySide6.QtGraphs.QBarSet

Synopsis

Properties

Methods

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 bar set contains one data value for each category. The first value of a set is assumed to belong to the first category, the second one to the second category, and so on. If the set has fewer values than there are categories, the missing values are assumed to be located at the end of the set. For missing values in the middle of a set, the numerical value of zero is used. Labels for zero value sets are not shown.

See also

QBarSeries

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property borderColorᅟ: QColor

This property holds The border color of the bar set..

Access functions:
property brushᅟ: QBrush
Access functions:
property colorᅟ: QColor

This property holds The fill color of the bar set..

Access functions:
property labelᅟ: str

This property holds The label of the bar set..

Access functions:
property labelBrushᅟ: QBrush
Access functions:
property labelColorᅟ: QColor

This property holds The text (label) color of the bar set..

Access functions:
property labelFontᅟ: QFont
Access functions:
property penᅟ: QPen
Access functions:
__init__(label[, parent=None])
Parameters:

Constructs a bar set with the label label and the parent parent.

append(values)
Parameters:

values – .list of qreal

Appends the list of real values specified by values to the end of the bar set.

See also

append()

append(value)
Parameters:

value – float

at(index)
Parameters:

index – int

Return type:

float

Returns the value specified by index from the bar set. If the index is out of bounds, 0.0 is returned.

borderColor()
Return type:

QColor

Getter of property borderColorᅟ .

borderColorChanged(color)
Parameters:

colorQColor

Notification signal of property borderColorᅟ .

brush()
Return type:

QBrush

Getter of property brushᅟ .

brushChanged()

Notification signal of property brushᅟ .

clicked(index)
Parameters:

index – int

color()
Return type:

QColor

Getter of property colorᅟ .

colorChanged(color)
Parameters:

colorQColor

Notification signal of property colorᅟ .

count()
Return type:

int

Returns the number of values in a bar set.

deselectAllBars()

Deselects all bars in the set.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

deselectBar(index)
Parameters:

index – int

Deselects the bar at index.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

deselectBars(indexes)
Parameters:

indexes – .list of int

Marks multiple bars passed in an indexes list as deselected.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

doubleClicked(index)
Parameters:

index – int

hovered(status, index)
Parameters:
  • status – bool

  • index – int

insert(index, value)
Parameters:
  • index – int

  • value – float

Inserts value in the position specified by index. The values following the inserted value are moved up one position.

See also

remove()

isBarSelected(index)
Parameters:

index – int

Return type:

bool

Returns true if the bar at the given index is among selected bars and false otherwise.

Note

Selected bars are drawn using the selected color if it was specified using setSelectedColor .

label()
Return type:

str

Returns the label of the bar set.

See also

setLabel()

Getter of property labelᅟ .

labelBrush()
Return type:

QBrush

Getter of property labelBrushᅟ .

labelBrushChanged()

Notification signal of property labelBrushᅟ .

labelChanged()

Notification signal of property labelᅟ .

labelColor()
Return type:

QColor

Getter of property labelColorᅟ .

labelColorChanged(color)
Parameters:

colorQColor

Notification signal of property labelColorᅟ .

labelFont()
Return type:

QFont

Getter of property labelFontᅟ .

labelFontChanged()

Notification signal of property labelFontᅟ .

operator(index)
Parameters:

index – int

Return type:

float

Returns the value of the bar set specified by index. If the index is out of bounds, 0.0 is returned.

pen()
Return type:

QPen

Getter of property penᅟ .

penChanged()

Notification signal of property penᅟ .

pressed(index)
Parameters:

index – int

released(index)
Parameters:

index – int

remove(index[, count=1])
Parameters:
  • index – int

  • count – int

Removes the number of values specified by count from the bar set starting with the value specified by index.

See also

insert()

replace(index, value)
Parameters:
  • index – int

  • value – float

Adds the value specified by value to the bar set at the position specified by index.

selectAllBars()

Marks all bars in the set as selected.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

selectBar(index)
Parameters:

index – int

Marks the bar at index as selected.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

selectBars(indexes)
Parameters:

indexes – .list of int

Marks multiple bars passed in an indexes list as selected.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

selectedBars()
Return type:

.list of int

Returns a list of bars marked as selected.

See also

setBarSelected()

selectedBarsChanged(indexes)
Parameters:

indexes – .list of int

This signal is emitted when the selected bar changes. indexes is a list selected bar indexes.

selectedColor()
Return type:

QColor

Returns the color of the selected bars.

This is the fill (brush) color of bars marked as selected. If not specified, value of color is used as default.

selectedColorChanged(color)
Parameters:

colorQColor

setBarSelected(index, selected)
Parameters:
  • index – int

  • selected – bool

Marks the bar at index as either selected or deselected as specified by selected.

Note

Selected bars are drawn using the selected color if it was specified. Emits selectedBarsChanged .

setBorderColor(color)
Parameters:

colorQColor

Sets the line color for the bar set to color.

See also

borderColor()

Setter of property borderColorᅟ .

setBrush(brush)
Parameters:

brushQBrush

Setter of property brushᅟ .

setColor(color)
Parameters:

colorQColor

Sets the fill color for the bar set to color.

See also

color()

Setter of property colorᅟ .

setLabel(label)
Parameters:

label – str

Sets label as the new label for the bar set.

See also

label()

Setter of property labelᅟ .

setLabelBrush(brush)
Parameters:

brushQBrush

Setter of property labelBrushᅟ .

setLabelColor(color)
Parameters:

colorQColor

Sets the text color for the bar set to color.

See also

labelColor()

Setter of property labelColorᅟ .

setLabelFont(font)
Parameters:

fontQFont

Setter of property labelFontᅟ .

setPen(pen)
Parameters:

penQPen

Setter of property penᅟ .

setSelectedColor(color)
Parameters:

colorQColor

Sets the color of the selected bars.

See also

selectedColor

sum()
Return type:

float

Returns the sum of all values in the bar set.

toggleSelection(indexes)
Parameters:

indexes – .list of int

Changes the selection state of bars at the given indexes to the opposite one.

Note

Emits selectedBarsChanged .

See also

setBarSelected()

valueChanged(index)
Parameters:

index – int

This signal is emitted when the value at the position specified by index is modified.

See also

at()

valuesAdded(index, count)
Parameters:
  • index – int

  • count – int

This signal is emitted when new values are added to the bar set. index indicates the position of the first inserted value, and count is the number of inserted values.

See also

append() insert()

valuesRemoved(index, count)
Parameters:
  • index – int

  • count – int

This signal is emitted when values are removed from the bar set. index indicates the position of the first removed value, and count is the number of removed values.

See also

remove()