QBarCategoryAxis#

The QBarCategoryAxis class adds categories to a chart’s axes. More…

Synopsis#

Properties#

categories - Of an axis
count - Number of categories of an axis
max - Maximum value on the axis
min - Minimum value on the axis

Functions#

def append (categories)
def append (category)
def at (index)
def categories ()
def clear ()
def count ()
def insert (index, category)
def max ()
def min ()
def remove (category)
def replace (oldCategory, newCategory)
def setCategories (categories)
def setMax (maxCategory)
def setMin (minCategory)
def setRange (minCategory, maxCategory)

Signals#

def categoriesChanged ()
def countChanged ()
def maxChanged (max)
def minChanged (min)
def rangeChanged (min, max)

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#

QBarCategoryAxis can be set up to show an axis line with tick marks, grid lines, and shades. Categories are drawn between the ticks. It can be used also with a line series, as demonstrated by the Charts with Widgets Gallery .

The following code illustrates how to use QBarCategoryAxis :

QChartView *chartView = new QChartView;
QBarSeries *series = new QBarSeries;
// ...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();

QBarCategoryAxis *axisX = new QBarCategoryAxis;
QStringList categories;
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
axisX->append(categories);
axisX->setRange("Feb", "May");
chartView->chart()->setAxisX(axisX, series);

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

Parameters:: parent – PySide6.QtCore.QObject

Constructs an axis object that is the 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.QBarCategoryAxis.categories: list of strings#

This property holds The categories of an axis..

Access functions:

categories ()
setCategories (categories)
Signal categoriesChanged ()

property PᅟySide6.QtCharts.QBarCategoryAxis.count: int#

This property holds The number of categories of an axis..

Access functions:

count ()
Signal countChanged ()

property PᅟySide6.QtCharts.QBarCategoryAxis.max: str#

This property holds The maximum value on the axis..

Access functions:

max ()
setMax (maxCategory)
Signal maxChanged (max)

property PᅟySide6.QtCharts.QBarCategoryAxis.min: str#

This property holds The minimum value on the axis..

Access functions:

min ()
setMin (minCategory)
Signal minChanged (min)

PySide6.QtCharts.QBarCategoryAxis.append(categories)#

Parameters:: categories – list of strings

Appends categories to an axis. The maximum value on the axis will be changed to match the last category in categories. If no categories were previously defined, the minimum value on the axis will also be changed to match the first category in categories.

A category has to be a valid QString and it cannot be duplicated. Duplicated categories will not be appended.

PySide6.QtCharts.QBarCategoryAxis.append(category)

Parameters:: category – str

Appends category to an axis. The maximum value on the axis will be changed to match the last category. If no categories were previously defined, the minimum value on the axis will also be changed to match category.

A category has to be a valid QString and it cannot be duplicated. Duplicated categories will not be appended.

PySide6.QtCharts.QBarCategoryAxis.at(index)#

Parameters:: index – int
Return type:: str

Returns the category at index. The index must be valid.

PySide6.QtCharts.QBarCategoryAxis.categories()#

Return type:: list of strings

Returns categories.

See also

setCategories()

Getter of property categories .

PySide6.QtCharts.QBarCategoryAxis.categoriesChanged()#

This signal is emitted when the categories of the axis change.

Notification signal of property categories .

PySide6.QtCharts.QBarCategoryAxis.clear()#

Removes all categories. Sets the maximum and minimum values of the axis range to QString::null.

PySide6.QtCharts.QBarCategoryAxis.count()#

Return type:: int

Returns the number of categories.

Getter of property count .

PySide6.QtCharts.QBarCategoryAxis.countChanged()#

This signal is emitted when the number of categories of an axis changes.

Notification signal of property count .

PySide6.QtCharts.QBarCategoryAxis.insert(index, category)#

Parameters:

index – int
category – str

Inserts category to the axis at index. category has to be a valid QString and it cannot be duplicated. If category is prepended or appended to other categories, the minimum and maximum values on the axis are updated accordingly.

PySide6.QtCharts.QBarCategoryAxis.max()#

Return type:: str

Returns the maximum category.

See also

setMax()

Getter of property max .

PySide6.QtCharts.QBarCategoryAxis.maxChanged(max)#

Parameters:: max – str

This signal is emitted when the max value of the axis changes.

Notification signal of property max .

PySide6.QtCharts.QBarCategoryAxis.min()#

Return type:: str

Returns the minimum category.

See also

setMin()

Getter of property min .

PySide6.QtCharts.QBarCategoryAxis.minChanged(min)#

Parameters:: min – str

This signal is emitted when the min value of the axis changes.

Notification signal of property min .

PySide6.QtCharts.QBarCategoryAxis.rangeChanged(min, max)#

Parameters:

min – str
max – str

This signal is emitted when min or max value of the axis changes.

PySide6.QtCharts.QBarCategoryAxis.remove(category)#

Parameters:: category – str

Removes category from the axis. Removing a category that currently sets the maximum or minimum value on the axis will affect the axis range.

PySide6.QtCharts.QBarCategoryAxis.replace(oldCategory, newCategory)#

Parameters:

oldCategory – str
newCategory – str

Replaces oldCategory with newCategory. If oldCategory does not exist on the axis, nothing is done. newCategory has to be a valid QString and it cannot be duplicated. If the minimum or maximum category is replaced, the minimum and maximum values on the axis are updated accordingly.

PySide6.QtCharts.QBarCategoryAxis.setCategories(categories)#

Parameters:: categories – list of strings

Sets categories and discards the old ones. The axis range is adjusted to match the first and last category in categories.

A category has to be a valid QString and it cannot be duplicated.

See also

categories()

Setter of property categories .

PySide6.QtCharts.QBarCategoryAxis.setMax(maxCategory)#

Parameters:: maxCategory – str

Sets the maximum category to max.

See also

max()

Setter of property max .

PySide6.QtCharts.QBarCategoryAxis.setMin(minCategory)#

Parameters:: minCategory – str

Sets the minimum category to min.

See also

min()

Setter of property min .

PySide6.QtCharts.QBarCategoryAxis.setRange(minCategory, maxCategory)#

Parameters:

minCategory – str
maxCategory – str

Sets the axis range from minCategory to maxCategory.