Back to Qt.io
Contact Us Blog Download Qt
本页内容

QBarSet Class

QBarSet 类表示条形图中的一组条形。更多...

Header: #include <QBarSet>
In QML: BarSet
Inherits: QObject
Status: Deprecated

该类已弃用。我们强烈建议不要在新代码中使用它。

属性

公共函数

QBarSet(const QString label, QObject *parent = nullptr)
virtual ~QBarSet()
void append(const QList<qreal> &values)
void append(const qreal value)
qreal at(const int index) const
QColor borderColor()
QBrush brush() const
QColor color()
int count() const
(since 6.2) void deselectAllBars()
(since 6.2) void deselectBar(int index)
(since 6.2) void deselectBars(const QList<int> &indexes)
void insert(const int index, const qreal value)
(since 6.2) bool isBarSelected(int index) const
QString label() const
QBrush labelBrush() const
QColor labelColor()
QFont labelFont() const
QPen pen() const
void remove(const int index, const int count = 1)
void replace(const int index, const qreal value)
(since 6.2) void selectAllBars()
(since 6.2) void selectBar(int index)
(since 6.2) void selectBars(const QList<int> &indexes)
(since 6.2) QList<int> selectedBars() const
(since 6.2) QColor selectedColor() const
(since 6.2) void setBarSelected(int index, bool selected)
void setBorderColor(QColor color)
void setBrush(const QBrush &brush)
void setColor(QColor color)
void setLabel(const QString label)
void setLabelBrush(const QBrush &brush)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setPen(const QPen &pen)
(since 6.2) void setSelectedColor(const QColor &color)
qreal sum() const
(since 6.2) void toggleSelection(const QList<int> &indexes)
QBarSet &operator<<(const qreal &value)
qreal operator[](const int index) const

信号

void borderColorChanged(QColor color)
void brushChanged()
void clicked(int index)
void colorChanged(QColor color)
void doubleClicked(int index)
void hovered(bool status, int index)
void labelBrushChanged()
void labelChanged()
void labelColorChanged(QColor color)
void labelFontChanged()
void penChanged()
void pressed(int index)
void released(int index)
void valueChanged(int index)
void valuesAdded(int index, int count)
void valuesRemoved(int index, int count)

详细说明

一个条形数据集包含每个类别的单个数据值。数据集中的第一个值被视为属于第一个类别，第二个值被视为属于第二个类别，以此类推。如果数据集中的值少于类别数，则缺失的值被视为位于数据集的末尾。 对于位于集合中间的缺失值，将使用数值零。零值集合的标签不会显示。

另请参阅 QAbstractBarSeries 、QBarSeries 、QStackedBarSeries 、QPercentBarSeries 、QHorizontalBarSeries 、QHorizontalStackedBarSeries 以及QHorizontalPercentBarSeries 。

属性文档

borderColor : QColor

该属性存储条形图集的线条（笔）颜色。

访问函数：

QColor borderColor()
void setBorderColor(QColor color)

通知信号：

void borderColorChanged(QColor color)

brush : QBrush

该属性存储用于填充条形图集中各条形图的画笔。

访问函数：

QBrush brush() const
void setBrush(const QBrush &brush)

通知器信号：

void brushChanged()

color : QColor

该属性存储条形图集的填充（笔刷）颜色。

访问函数：

QColor color()
void setColor(QColor color)

通知器信号：

void colorChanged(QColor color)

label : QString

该属性存储条形集的标签。

访问函数：

QString label() const
void setLabel(const QString label)

通知信号：

void labelChanged()

labelBrush : QBrush

该属性保存用于绘制条形图集标签的画笔。

访问函数：

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

通知器信号：

void labelBrushChanged()

labelColor : QColor

该属性用于设置条形集的文本（标签）颜色。

访问函数：

QColor labelColor()
void setLabelColor(QColor color)

通知信号：

void labelColorChanged(QColor color)

labelFont : QFont

该属性用于指定绘制条形图集标签所使用的字体。

访问函数：

QFont labelFont() const
void setLabelFont(const QFont &font)

通知信号：

void labelFontChanged()

pen : QPen

该属性存储用于绘制柱形图集中各条柱的线条的绘图笔。

访问函数：

QPen pen() const
void setPen(const QPen &pen)

通知信号：

void penChanged()

成员函数文档

[explicit] QBarSet::QBarSet(const QString label, QObject *parent = nullptr)

创建一个带有标签“label ”且父元素为“parent ”的条形图集。

[virtual noexcept] QBarSet::~QBarSet()

移除该条形图集。

void QBarSet::append(const QList<qreal> &values)

将由values 指定的实数列表追加到条形集合的末尾。

另请参阅 append ()。

void QBarSet::append(const qreal value)

将value 指定的新值追加到柱形数据集的末尾。

qreal QBarSet::at(const int index) const

从条形集返回由 `index ` 指定的值。如果索引超出范围，则返回 0.0。

QColor QBarSet::borderColor()

返回条形图集的线条颜色。

注意： 这是 borderColor 属性的获取器 函数。

另请参阅 setBorderColor()。

[signal] void QBarSet::borderColorChanged(QColor color)

当条形集的线（笔）颜色变为color 时，会发出此信号。

注意： 这是属性borderColor的通知器 信号。

QBrush QBarSet::brush() const

返回用于填充条形集中的条形的画笔。

注意： 这是 brush 属性的获取 函数。

另请参阅 setBrush()。

[signal] void QBarSet::brushChanged()

当用于绘制柱状图集的画笔发生变化时，会发出此信号。

注意： 这是属性brush 的Notifier 信号。

另请参阅 brush 。

[signal] void QBarSet::clicked(int index)

当用户点击条形图集中由index 指定的条形时，会触发此信号。

QColor QBarSet::color()

返回条形图集的填充颜色。

注意： 这是 color 属性的获取 函数。

另请参阅 setColor()。

[signal] void QBarSet::colorChanged(QColor color)

当条形集的填充（画笔）颜色变为color 时，会发出此信号。

注意： 这是属性color 的通知器 信号。

int QBarSet::count() const

返回条形集中的值个数。

[since 6.2] void QBarSet::deselectAllBars()

取消选中该系列中的所有柱形图。

注意：会触发 QBarSet::selectedBarsChanged 。

该函数在 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[since 6.2] void QBarSet::deselectBar(int index)

取消选中位于index 的条形图。

注意：会触发 QBarSet::selectedBarsChanged 信号。

该函数自 Qt 6.2 起引入。

另请参阅 setBarSelected()。

[since 6.2] void QBarSet::deselectBars(const QList<int> &indexes)

将indexes 列表中已通过的多个条目标记为未选中。

注意：会触发 QBarSet::selectedBarsChanged事件 。

该函数在 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[signal] void QBarSet::doubleClicked(int index)

当用户在条形图集中双击由index 指定的条形时，会触发此信号。

[signal] void QBarSet::hovered(bool status, int index)

当鼠标悬停在条形图集（bar set）中由index 指定的条形上时，会触发此信号。当鼠标移至该条形上方时，status 会变为true ；当鼠标再次移开时，它会变为false 。

void QBarSet::insert(const int index, const qreal value)

在index 指定的位置插入value 。插入值之后的值将向上移动一位。

另请参阅 remove()。

[since 6.2] bool QBarSet::isBarSelected(int index) const

如果位于给定坐标index 处的柱形图属于所选柱形图范围，则返回true ；否则返回false 。

注意： 如果已通过 `QBarSet::setSelectedColor` 指定了选定颜色，则选定的 柱状图将使用该颜色绘制。

该函数在 Qt 6.2 中引入。

另请参阅 selectedBars()、setBarSelected() 和setSelectedColor()。

QString QBarSet::label() const

返回条形图集的标签。

注意： 这是 label 属性的获取 函数。

另请参阅 setLabel()。

QBrush QBarSet::labelBrush() const

返回用于在此条形图集上绘制值的画笔。

注意： 这是 labelBrush 属性的获取 函数。

另请参阅 setLabelBrush()。

[signal] void QBarSet::labelBrushChanged()

当用于绘制柱状图集标签的画笔发生变化时，会发出此信号。

注意： 这是属性labelBrush的通知器 信号。

另请参阅 labelBrush 。

[signal] void QBarSet::labelChanged()

当柱状图集的标签发生变化时，会发出此信号。

注意： 这是属性label的通知器 信号。

另请参阅 label 。

QColor QBarSet::labelColor()

返回条形集的文本颜色。

注意： 这是 labelColor 属性的获取 函数。

另请参阅 setLabelColor()。

[signal] void QBarSet::labelColorChanged(QColor color)

当条形集的文本（标签）颜色变为color 时，会发出此信号。

注意： 这是属性labelColor 的通知器 信号。

QFont QBarSet::labelFont() const

返回用于在此柱状图集上绘制值的绘图笔。

注意： 这是 labelFont 属性的获取 函数。

另请参阅 setLabelFont()。

[signal] void QBarSet::labelFontChanged()

当条形图集标签的字体发生变化时，会发出此信号。

注意： 这是属性labelFont 的通知器 信号。

另请参阅 labelBrush 。

QPen QBarSet::pen() const

返回用于在条形集上绘制线条的画笔。

注意： 这是 pen 属性的获取器 函数。

另请参阅 setPen()。

[signal] void QBarSet::penChanged()

当用于绘制条形集的画笔发生变化时，会发出此信号。

注意： 这是属性pen的通知器 信号。

另请参阅 pen 。

[signal] void QBarSet::pressed(int index)

当用户点击条形图集（bar set）中由index 指定的条形，并按住鼠标按钮时，会触发此信号。

[signal] void QBarSet::released(int index)

当用户在条形图集中的某个条形上松开鼠标按钮时，该条形由index 指定，此时会触发此信号。

void QBarSet::remove(const int index, const int count = 1)

从以index 指定的值开头的条形集合中，移除由count 指定的数量的值。

另请参阅 insert()。

void QBarSet::replace(const int index, const qreal value)

将value 指定的值添加到位于index 指定位置的条形上。

[since 6.2] void QBarSet::selectAllBars()

将该系列中的所有小节标记为已选中。

注意：会触发 QBarSet::selectedBarsChanged 。

该函数于 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[since 6.2] void QBarSet::selectBar(int index)

将位于index 的条形标记为已选中。

注意：会触发 QBarSet::selectedBarsChanged 信号。

该函数于 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[since 6.2] void QBarSet::selectBars(const QList<int> &indexes)

将indexes 列表中经过的多个小节标记为已选中。

注意：会发出 QBarSet::selectedBarsChanged 事件。

该函数于 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[since 6.2] QList<int> QBarSet::selectedBars() const

返回一个标记为已选中的条形列表。

该函数在 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[since 6.2] QColor QBarSet::selectedColor() const

返回所选条形图的颜色。

这是标记为选中的条形图的填充（笔刷）颜色。如果未指定，则默认使用QBarSet::color 的值。

该函数在 Qt 6.2 中引入。

另请参阅 setSelectedColor() 和color 。

[since 6.2] void QBarSet::setBarSelected(int index, bool selected)

根据selected 的指定，将index 处的条形标记为已选中或未选中。

注意： 如果指定了选中颜色，则使用该颜色绘制选中 条。发出QBarSet::selectedBarsChanged 信号。

该函数自 Qt 6.2 起引入。

另请参阅 isBarSelected() 和setSelectedColor()。

void QBarSet::setBorderColor(QColor color)

将条形图集的线颜色设置为color 。

注意： 这是属性 `borderColor`的设置 函数。

另请参阅 borderColor()。

void QBarSet::setBrush(const QBrush &brush)

将用于填充brush 中条形图中各条形的画笔设置为 。

注意： 这是属性 `brush`的设置 函数。

另请参阅 brush()。

void QBarSet::setColor(QColor color)

将条形图集的填充颜色设置为color 。

注意： 这是属性color 的设置 函数。

另请参阅 color()。

void QBarSet::setLabel(const QString label)

将label 设置为条形图集的新标签。

注意： 这是属性label 的设置 函数。

另请参阅 label()。

void QBarSet::setLabelBrush(const QBrush &brush)

将用于在此条形图集上绘制值的画笔设置为brush 。

注意： 这是属性 `labelBrush`的设置 函数。

另请参阅 labelBrush()。

void QBarSet::setLabelColor(QColor color)

设置条形集的文本颜色为color 。

注意： 这是属性 `labelColor`的设置 函数。

另请参阅 labelColor()。

void QBarSet::setLabelFont(const QFont &font)

将用于在此柱状图集上绘制值的字体设置为font 。

注意： 这是属性 `labelFont`的设置 函数。

另请参阅 labelFont()。

void QBarSet::setPen(const QPen &pen)

将用于绘制pen 中条形图内线条的画笔设置为指定值。

注意： 这是属性 `pen`的设置 函数。

另请参阅 pen()。

[since 6.2] void QBarSet::setSelectedColor(const QColor &color)

设置所选小节的color 。

该函数在 Qt 6.2 中引入。

另请参阅 selectedColor 。

qreal QBarSet::sum() const

返回条形数据集中的所有值的总和。

[since 6.2] void QBarSet::toggleSelection(const QList<int> &indexes)

将指定indexes 处的小节的选中状态更改为相反的状态。

注意：会触发 QBarSet::selectedBarsChanged 信号。

该函数在 Qt 6.2 中引入。

另请参阅 setBarSelected()。

[signal] void QBarSet::valueChanged(int index)

当index 指定的位置处的值发生变化时，会发出此信号。

另请参阅 at()。

[signal] void QBarSet::valuesAdded(int index, int count)

当向条形数据集添加新值时，会触发此信号。index 表示首个插入值的位置，count 表示插入值的数量。

另请参阅 append() 和insert()。

[signal] void QBarSet::valuesRemoved(int index, int count)

当从柱状图集合中移除值时，会发出此信号。index 表示第一个被移除值的位置，count 表示被移除的值个数。

另请参阅 remove()。

QBarSet &QBarSet::operator<<(const qreal &value)

一个便捷操作符，用于将value 指定的实数值追加到条形集合的末尾。

另请参阅 append()。

qreal QBarSet::operator[](const int index) const

返回由 `index` 指定的条形集的值。如果索引超出范围，则返回 0.0。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.