QBarCategoryAxis Class
The QBarCategoryAxis class adds categories to a chart's axes. More...
Header: | #include <QBarCategoryAxis> |
Instantiated By: | BarCategoryAxis |
Inherits: | QAbstractAxis |
Properties
- categories : QStringList
- count : const int
- max : QString
- min : QString
- 27 properties inherited from QAbstractAxis
- 1 property inherited from QObject
Public Functions
QBarCategoryAxis(QObject *parent = Q_NULLPTR) | |
~QBarCategoryAxis() | |
void | append(const QStringList &categories) |
void | append(const QString &category) |
QString | at(int index) const |
QStringList | categories() |
void | clear() |
int | count() const |
void | insert(int index, const QString &category) |
QString | max() const |
QString | min() const |
void | remove(const QString &category) |
void | replace(const QString &oldCategory, const QString &newCategory) |
void | setCategories(const QStringList &categories) |
void | setMax(const QString &max) |
void | setMin(const QString &min) |
void | setRange(const QString &minCategory, const QString &maxCategory) |
Reimplemented Public Functions
virtual AxisType | type() const |
- 58 public functions inherited from QAbstractAxis
- 32 public functions inherited from QObject
Signals
void | categoriesChanged() |
void | countChanged() |
void | maxChanged(const QString &max) |
void | minChanged(const QString &min) |
void | rangeChanged(const QString &min, const QString &max) |
- 25 signals inherited from QAbstractAxis
- 2 signals inherited from QObject
Additional Inherited Members
- 1 public slot inherited from QObject
- 11 static public members inherited from QObject
- 9 protected functions inherited from QObject
Detailed Description
The QBarCategoryAxis class adds categories to a chart's axes.
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 Line and BarChart Example.
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);
Property Documentation
categories : QStringList
This property holds the categories of an axis.
Access functions:
QStringList | categories() |
void | setCategories(const QStringList &categories) |
Notifier signal:
void | categoriesChanged() |
count : const int
This property holds the number of categories of an axis.
Access functions:
int | count() const |
Notifier signal:
void | countChanged() |
max : QString
This property holds the maximum value on the axis.
Access functions:
QString | max() const |
void | setMax(const QString &max) |
Notifier signal:
void | maxChanged(const QString &max) |
min : QString
This property holds the minimum value on the axis.
Access functions:
QString | min() const |
void | setMin(const QString &min) |
Notifier signal:
void | minChanged(const QString &min) |
Member Function Documentation
QBarCategoryAxis::QBarCategoryAxis(QObject *parent = Q_NULLPTR)
Constructs an axis object that is the child of parent.
QBarCategoryAxis::~QBarCategoryAxis()
Destroys the axis object.
void QBarCategoryAxis::append(const QStringList &categories)
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.
void QBarCategoryAxis::append(const QString &category)
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.
QString QBarCategoryAxis::at(int index) const
Returns the category at index. The index must be valid.
QStringList QBarCategoryAxis::categories()
Returns categories.
Note: Getter function for property categories.
See also setCategories().
[signal]
void QBarCategoryAxis::categoriesChanged()
This signal is emitted when the categories of the axis change.
Note: Notifier signal for property categories.
void QBarCategoryAxis::clear()
Removes all categories. Sets the maximum and minimum values of the axis range to QString::null.
int QBarCategoryAxis::count() const
Returns the number of categories.
Note: Getter function for property count.
[signal]
void QBarCategoryAxis::countChanged()
This signal is emitted when the number of categories of an axis changes.
Note: Notifier signal for property count.
void QBarCategoryAxis::insert(int index, const QString &category)
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.
QString QBarCategoryAxis::max() const
Returns the maximum category.
Note: Getter function for property max.
See also setMax().
[signal]
void QBarCategoryAxis::maxChanged(const QString &max)
This signal is emitted when the max value of the axis changes.
Note: Notifier signal for property max.
QString QBarCategoryAxis::min() const
Returns the minimum category.
Note: Getter function for property min.
See also setMin().
[signal]
void QBarCategoryAxis::minChanged(const QString &min)
This signal is emitted when the min value of the axis changes.
Note: Notifier signal for property min.
[signal]
void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)
This signal is emitted when min or max value of the axis changes.
void QBarCategoryAxis::remove(const QString &category)
Removes category from the axis. Removing a category that currently sets the maximum or minimum value on the axis will affect the axis range.
void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)
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.
void QBarCategoryAxis::setCategories(const QStringList &categories)
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.
Note: Setter function for property categories.
See also categories().
void QBarCategoryAxis::setMax(const QString &max)
Sets the maximum category to max.
Note: Setter function for property max.
See also max().
void QBarCategoryAxis::setMin(const QString &min)
Sets the minimum category to min.
Note: Setter function for property min.
See also min().
void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)
Sets the axis range from minCategory to maxCategory.
[virtual]
AxisType QBarCategoryAxis::type() const
Reimplemented from QAbstractAxis::type().
Returns the type of the axis.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qbarcategoryaxis.html