QBarCategoryAxis 类

QBarCategoryAxis 类向图表的轴增加了类别。更多信息...

头文件	#include <QBarCategoryAxis>
实例化自	BarCategoryAxis
继承自	QAbstractAxis

所有成员的列表，包括继承成员

属性

categories : QStringList
count : const int
max : QString
min : QString

公共函数

	QBarCategoryAxis(QObject *parent = 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)

重写的公共函数

虚拟 QAbstractAxis::AxisType type() const override

信号

void	categoriesChanged()
void	countChanged()
void	maxChanged(const QString &max)
void	minChanged(const QString &min)
void	rangeChanged(const QString &min, const QString &max)

详细描述

QBarCategoryAxis 可以设置显示带有刻度线、网格线和阴影的轴线。类别在刻度之间绘制。它还可以与线条系列一起使用，如图表与控件画廊中所示。

以下代码演示了如何使用 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);

属性文档

categories : QStringList

此属性包含轴的类别。

访问函数

QStringList	categories()
void	setCategories(const QStringList &categories)

通知信号

void	categoriesChanged()

`[只读]` count : const int

此属性包含轴的类别数。

访问函数

int	count() const

通知信号

void	countChanged()

max : QString

此属性包含轴上的最大值。

访问函数

QString	max() const
void	setMax(const QString &max)

通知信号

void	maxChanged(const QString &max)

min : QString

此属性包含轴上的最小值。

访问函数

QString	min() const
void	setMin(const QString &min)

通知信号

void	minChanged(const QString &min)

成员函数文档

`[显式]` QBarCategoryAxis::QBarCategoryAxis(QObject **parent* = nullptr)

构建一个轴对象，它是 parent 的子对象。

`[虚函数 noexcept]` QBarCategoryAxis::~QBarCategoryAxis()

销毁轴对象。

void QBarCategoryAxis::append(const QStringList &categories)

将 categories 添加到轴。轴的最大值将更改为与 categories 中的最后一个类别匹配。如果没有先前定义类别，轴上的最小值也将更改为与 categories 中的第一个类别匹配。

类别必须是有效的 QString，并且不能重复。重复的类别将不会添加。

void QBarCategoryAxis::append(const QString &category)

将 category 添加到轴。轴的最大值将更改为与最后一个 category 匹配。如果没有先前定义类别，轴上的最小值也将更改为与 category 匹配。

类别必须是有效的 QString，并且不能重复。重复的类别将不会添加。

QString QBarCategoryAxis::at(int index) const

返回 index 处的类别。索引必须是有效的。

QStringList QBarCategoryAxis::categories()

返回类别。

注意：类别属性的获取函数。

另请参阅 setCategories()。

`[信号]` void QBarCategoryAxis::categoriesChanged()

当轴的分类变化时，会发出此信号。

注意： 属性 categories 的通知信号。

`[可调用]` void QBarCategoryAxis::clear()

移除所有分类。将轴范围的最大值和最小值设置为 QString::null。

注意： 此函数可以通过元对象系统从 QML 中调用。请参阅 Q_INVOKABLE。

int QBarCategoryAxis::count() const

返回分类的数量。

注意： 此函数是属性 count 的获取函数。

`[信号]` void QBarCategoryAxis::countChanged()

当轴的分类数量变化时，会发出此信号。

注意： 属性 count 的通知信号。

void QBarCategoryAxis::insert(int index, const QString &category)

将分类 category 插入到轴的 index 位置。分类 category 必须是有效的 QString 且不能重复。如果 category 预先添加或附加到其他分类，则相应更新轴上的最小值和最大值。

QString QBarCategoryAxis::max() const

返回最大分类。

注意： 此函数是属性 max 的获取函数。

另请参阅 setMax()。

`[信号]` void QBarCategoryAxis::maxChanged(const QString &max)

当轴的 max 值变化时，会发出此信号。

注意： 属性 max 的通知信号。

QString QBarCategoryAxis::min() const

返回最小分类。

注意： 此函数是属性 min 的获取函数。

另请参阅 setMin()。

`[信号]` void QBarCategoryAxis::minChanged(const QString &min)

当轴的 min 值变化时，会发出此信号。

注意： 属性 min 的通知信号。

`[信号]` void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

当轴的 min 或 max 值变化时，会发出此信号。

void QBarCategoryAxis::remove(const QString &category)

从轴中移除分类 category。如果移除的类别当前设置轴的最大值或最小值，将影响轴的取值范围。

void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

用 newCategory 替换 oldCategory。如果 oldCategory 在轴上不存在，则不执行任何操作。 newCategory 必须是一个有效的 QString 且不能重复。如果替换最小或最大类别，则轴上的最小值和最大值将相应更新。

void QBarCategoryAxis::setCategories(const QStringList &categories)

设置 categories 并且丢弃旧的类别。轴的范围调整为匹配 categories 中的第一个和最后一个类别。

类别必须是一个有效的 QString 且不能重复。

注意： 属性 categories 的设置器函数。

另请参阅 categories。

void QBarCategoryAxis::setMax(const QString &max)

设置最大类别为 max。

注意： 属性 max 的设置器函数。

另请参阅 max。

void QBarCategoryAxis::setMin(const QString &min)

设置最小类别为 min。

注意： 属性 min 的设置器函数。

另请参阅 min。

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

将轴的范围设置为从 minCategory 到 maxCategory。

`[覆盖虚函数]` QAbstractAxis::AxisType QBarCategoryAxis::type() const

重实现：QAbstractAxis::type() const。

返回轴的类型。

QBarCategoryAxis 类

属性

公共函数

重写的公共函数

信号

详细描述

属性文档

categories : QStringList

[只读] count : const int

max : QString

min : QString

成员函数文档

[显式] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)

[虚函数 noexcept] QBarCategoryAxis::~QBarCategoryAxis()

void QBarCategoryAxis::append(const QStringList &categories)

void QBarCategoryAxis::append(const QString &category)

QString QBarCategoryAxis::at(int index) const

QStringList QBarCategoryAxis::categories()

[信号] void QBarCategoryAxis::categoriesChanged()

[可调用] void QBarCategoryAxis::clear()

int QBarCategoryAxis::count() const

[信号] void QBarCategoryAxis::countChanged()

void QBarCategoryAxis::insert(int index, const QString &category)

QString QBarCategoryAxis::max() const

[信号] void QBarCategoryAxis::maxChanged(const QString &max)

QString QBarCategoryAxis::min() const

[信号] void QBarCategoryAxis::minChanged(const QString &min)

[信号] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

void QBarCategoryAxis::remove(const QString &category)

void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

void QBarCategoryAxis::setCategories(const QStringList &categories)

void QBarCategoryAxis::setMax(const QString &max)

void QBarCategoryAxis::setMin(const QString &min)

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

[覆盖虚函数] QAbstractAxis::AxisType QBarCategoryAxis::type() const

`[只读]` count : const int

`[显式]` QBarCategoryAxis::QBarCategoryAxis(QObject **parent* = nullptr)

`[虚函数 noexcept]` QBarCategoryAxis::~QBarCategoryAxis()

`[信号]` void QBarCategoryAxis::categoriesChanged()

`[可调用]` void QBarCategoryAxis::clear()

`[信号]` void QBarCategoryAxis::countChanged()

`[信号]` void QBarCategoryAxis::maxChanged(const QString &max)

`[信号]` void QBarCategoryAxis::minChanged(const QString &min)

`[信号]` void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

`[覆盖虚函数]` QAbstractAxis::AxisType QBarCategoryAxis::type() const