QBarSet Class

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

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

属性

公共功能

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)

详细说明

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

另请参阅 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)

通知信号:

labelColor : QColor

该属性用于保存条形图集的文本(标签)颜色。

访问功能:

QColor labelColor()
void setLabelColor(QColor color)

通知信号:

void labelColorChanged(QColor color)

labelFont : QFont

此属性用于保存绘制条形图组标签时使用的字体。

访问功能:

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

通知信号:

pen : QPen

此属性保存用于绘制条形图组中条形线条的笔。

访问功能:

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

Notifier 信号:

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 属性的通知信号。

另请参阅 brush

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

当用户点击条形图组中由index 指定的条形图时,就会发出该信号。

QColor QBarSet::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)

当鼠标悬停在条形图组中index 指定的条形图上时,就会发出该信号。当鼠标移到条形图上时,status 会变成true ,当鼠标再次移开时,会变成false

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

value 插入index 指定的位置。插入值后面的值向上移动一个位置。

另请参见 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

返回条形图组的标签。

注: 属性标签的获取函数。

另请参阅 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)

当用户点击条形图组中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。

© 2025 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.