QBoxSet Class
QBoxSet 类表示箱线图中的一个数据点。更多内容...
该类已弃用。我们强烈建议不要在新代码中使用它。
公共类型
| enum | ValuePositions { LowerExtreme, LowerQuartile, Median, UpperQuartile, UpperExtreme } |
属性
公共函数
| QBoxSet(const QString label = QString(), QObject *parent = nullptr) | |
| QBoxSet(const qreal le, const qreal lq, const qreal m, const qreal uq, const qreal ue, const QString label = QString(), QObject *parent = nullptr) | |
| virtual | ~QBoxSet() |
| void | append(const QList<qreal> &values) |
| void | append(const qreal value) |
| qreal | at(const int index) const |
| QBrush | brush() const |
| void | clear() |
| int | count() const |
| QString | label() const |
| QPen | pen() const |
| void | setBrush(const QBrush &brush) |
| void | setLabel(const QString label) |
| void | setPen(const QPen &pen) |
| void | setValue(const int index, const qreal value) |
| QBoxSet & | operator<<(const qreal &value) |
| qreal | operator[](const int index) const |
信号
| void | brushChanged() |
| void | cleared() |
| void | clicked() |
| void | doubleClicked() |
| void | hovered(bool status) |
| void | penChanged() |
| void | pressed() |
| void | released() |
| void | valueChanged(int index) |
| void | valuesChanged() |
详细说明
箱线图是通过五个不同的数值构建的，用于图形化展示一个范围及其三个中位数值。 有两种方法可以指定这些值。第一种方法是使用构造函数或流运算符（<<）。这些值必须按以下顺序指定：下极值、下四分位数、中位数、上四分位数和上极值。
第二种方法是创建一个空的 QBoxSet 实例，并使用 `setValue()` 方法指定这些值。
请参阅“带小部件的图表”示例库，了解如何创建箱线图。
另请参阅 QBoxPlotSeries 。
成员类型文档
enum QBoxSet::ValuePositions
该枚举类型定义了箱线图中各项的值：
| 常量 | 值 | 描述 |
|---|---|---|
QBoxSet::LowerExtreme | 0 | 箱线图项的最小值。 |
QBoxSet::LowerQuartile | 1 | 箱线图数据项下半部分的中位数。 |
QBoxSet::Median | 2 | 箱线图项的中位数。 |
QBoxSet::UpperQuartile | 3 | 箱线图中下半部分的中位数。 |
QBoxSet::UpperExtreme | 4 | 箱线图项的最大值。 |
属性文档
brush : QBrush
该属性用于指定填充“箱线图”项中箱体的画笔。
访问函数：
通知器信号：
| void | brushChanged() |
pen : QPen
该属性保存了用于绘制箱线图项目中各条线的画笔。
访问函数：
通知器信号：
| void | penChanged() |
成员函数文档
[explicit] QBoxSet::QBoxSet(const QString label = QString(), QObject *parent = nullptr)
创建一个带箱线图，其可选标签为label ，父对象为parent 。
[explicit] QBoxSet::QBoxSet(const qreal le, const qreal lq, const qreal m, const qreal uq, const qreal ue, const QString label = QString(), QObject *parent = nullptr)
构建一个包含以下有序值的箱线图：le 指定下限，lq 指定下四分位数，m 指定中位数，uq 指定上四分位数，ue 指定上四分位数。可选地，还可以指定label 和parent 。
[virtual noexcept] QBoxSet::~QBoxSet()
删除一个箱线图项。
void QBoxSet::append(const QList<qreal> &values)
将由values 指定的实数列表追加到箱线图项的末尾。
另请参阅 append ()。
void QBoxSet::append(const qreal value)
将value 指定的新值追加到箱线图条目的末尾。
qreal QBoxSet::at(const int index) const
返回由 `index` 指定的箱线图项的值。索引可通过使用 `ValuePositions ` 枚举值来指定。如果索引超出范围，则返回 0.0。
QBrush QBoxSet::brush() const
返回用于填充箱线图项的画笔。
注意： 这是属性 brush 的获取 函数。
另请参阅 setBrush()。
[signal] void QBoxSet::brushChanged()
当箱线图项的画笔发生变化时，会发出此信号。
注意： 这是属性brush的通知器 信号。
另请参阅 brush 。
void QBoxSet::clear()
将箱线图项的所有值设置为 0。
[signal] void QBoxSet::cleared()
当箱线图项的所有值均设为 0 时，会发出此信号。
[signal] void QBoxSet::clicked()
当用户点击图表中的箱线图项目时，会触发此信号。
int QBoxSet::count() const
返回附加到箱线图项目上的值的个数。
[signal] void QBoxSet::doubleClicked()
当用户双击箱线图项目时，会发出此信号。
[signal] void QBoxSet::hovered(bool status)
当鼠标悬停在图表中的箱线图项目上时，会触发此信号。当鼠标移至该项目上方时，status 会变为true ；当鼠标再次移开时，它会变为false 。
QString QBoxSet::label() const
返回箱线图条目的类别标签。
另请参阅 setLabel()。
QPen QBoxSet::pen() const
返回用于绘制箱线图项的绘图笔。
注意： 这是属性 pen 的获取器 函数。
另请参阅 setPen()。
[signal] void QBoxSet::penChanged()
当箱线图项的笔形发生变化时，会触发此信号。
注意： 这是属性 `pen`的通知器 信号。
另请参阅 pen 。
[signal] void QBoxSet::pressed()
当用户在图表中点击一个箱线图项目并按住鼠标按钮时，会发出此信号。
[signal] void QBoxSet::released()
当用户在箱线图项目上松开鼠标按钮时，会发出此信号。
void QBoxSet::setBrush(const QBrush &brush)
将用于填充箱线图项的画笔设置为brush 。
注意： 这是属性 `brush`的设置 函数。
另请参阅 brush()。
void QBoxSet::setLabel(const QString label)
将由 `label ` 指定的标签设置为箱线图条目的类别。
另请参阅 label()。
void QBoxSet::setPen(const QPen &pen)
将用于绘制箱线图项的画笔设置为pen 。
注意： 这是属性 `pen`的设置 函数。
另请参阅 pen()。
void QBoxSet::setValue(const int index, const qreal value)
将value 指定的值设置到index 指定的位置。索引可通过使用ValuePositions 枚举值来指定。
[signal] void QBoxSet::valueChanged(int index)
当由 `index ` 指定的箱线图项的值发生变化时，会触发此信号。
另请参阅 at()。
[signal] void QBoxSet::valuesChanged()
当箱线图项的多个值发生变化时，会触发此信号。
另请参阅 append()。
QBoxSet &QBoxSet::operator<<(const qreal &value)
一个便捷运算符，用于将由value 指定的实际值追加到箱线图条目的末尾。
另请参阅 append()。
qreal QBoxSet::operator[](const int index) const
返回由index 指定的箱线图项的值。可以通过ValuePositions 枚举值指定索引。如果索引超出范围，则返回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.
