QBarSet Class
QBarSet 类表示条形图中的一组条形。更多
属性
|
|
公共功能
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
此属性保存用于填充条形图组中条形的笔刷。
访问功能:
通知信号:
void | brushChanged() |
color : QColor
该属性用于保存条形图集的填充(画笔)颜色。
访问功能
通知信号:
void | colorChanged(QColor color) |
label : QString
此属性用于保存条形图集的标签。
访问功能:
通知信号:
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
此属性保存用于绘制条形图组中条形线条的笔。
访问功能:
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 是插入值的个数。
[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.