QBoxPlotSeries Class
QBoxPlotSeries 类用于以箱线图的形式展示数据。更多内容...
| Header: | #include <QBoxPlotSeries> |
| In QML: | BoxPlotSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
该类已弃用。我们强烈建议不要在新代码中使用它。
属性
|
公共函数
| QBoxPlotSeries(QObject *parent = nullptr) | |
| virtual | ~QBoxPlotSeries() |
| bool | append(QBoxSet *set) |
| bool | append(const QList<QBoxSet *> &sets) |
| bool | boxOutlineVisible() |
| QList<QBoxSet *> | boxSets() const |
| qreal | boxWidth() |
| QBrush | brush() const |
| void | clear() |
| int | count() const |
| bool | insert(int index, QBoxSet *set) |
| QPen | pen() const |
| bool | remove(QBoxSet *set) |
| void | setBoxOutlineVisible(bool visible) |
| void | setBoxWidth(qreal width) |
| void | setBrush(const QBrush &brush) |
| void | setPen(const QPen &pen) |
| bool | take(QBoxSet *set) |
重新实现的公共函数
| virtual QAbstractSeries::SeriesType | type() const override |
信号
| void | boxOutlineVisibilityChanged() |
| void | boxWidthChanged() |
| void | boxsetsAdded(const QList<QBoxSet *> &sets) |
| void | boxsetsRemoved(const QList<QBoxSet *> &sets) |
| void | brushChanged() |
| void | clicked(QBoxSet *boxset) |
| void | countChanged() |
| void | doubleClicked(QBoxSet *boxset) |
| void | hovered(bool status, QBoxSet *boxset) |
| void | penChanged() |
| void | pressed(QBoxSet *boxset) |
| void | released(QBoxSet *boxset) |
详细说明
箱线图系列充当箱线图数据项的容器。来自多个系列的数据项会根据其索引值被分组到不同的类别中。
QBarCategoryAxis 类用于将类别添加到图表的坐标轴上。类别标签必须是唯一的。如果为多个箱线图数据点定义了相同的类别标签,则仅绘制第一个。
请参阅“带小部件的图表”图库,了解如何创建箱线图。

另请参阅 QBoxSet 和QBarCategoryAxis 。
属性文档
boxOutlineVisible : bool
该属性控制框线的外观可见性。
访问函数:
| bool | boxOutlineVisible() |
| void | setBoxOutlineVisible(bool visible) |
通知信号:
| void | boxOutlineVisibilityChanged() |
boxWidth : qreal
该属性存储箱线图项的宽度。该值表示该项在其所属类别中的相对宽度。该值范围为 0.0 到 1.0。负值将替换为 0.0,大于 1.0 的值将替换为 1.0。
访问函数:
| qreal | boxWidth() |
| void | setBoxWidth(qreal width) |
通知信号:
| void | boxWidthChanged() |
brush : QBrush
该属性存储用于填充箱线图项目中各箱体的画笔。
访问函数:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
通知器信号:
| void | brushChanged() |
[read-only] count : int
该属性表示箱线图序列中各箱线图条目的数量。
访问函数:
| int | count() const |
通知信号:
| void | countChanged() |
pen : QPen
该属性存储用于绘制箱线图项目中各条线的画笔。
访问函数:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
通知器信号:
| void | penChanged() |
成员函数文档
[explicit] QBoxPlotSeries::QBoxPlotSeries(QObject *parent = nullptr)
构建一个空的箱线图系列,该系列是QObject ,并且是parent 的子对象。
[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()
将该时间序列从图表中移除。
bool QBoxPlotSeries::append(QBoxSet *set)
将由set 指定的单个箱线图项添加到序列中,并获取其所有权。如果该项为null,或者它已经属于该序列,则不会将其追加。如果追加成功,则返回true 。
bool QBoxPlotSeries::append(const QList<QBoxSet *> &sets)
将由sets 指定的箱线图项目列表添加到该系列中,并将其所有权移交该系列。如果该列表为空,或者这些项目已属于该系列,则不会将其追加。如果追加成功,则返回true 。
[signal] void QBoxPlotSeries::boxOutlineVisibilityChanged()
当框线可见性发生变化时,会触发此信号。
注意: 这是属性boxOutlineVisible 的Notifier 信号。
QList<QBoxSet *> QBoxPlotSeries::boxSets() const
返回箱线图系列中各箱线图项的列表。保持对这些项的所有权。
[signal] void QBoxPlotSeries::boxWidthChanged()
当箱线图条目的宽度发生变化时,会发出此信号。
注意: 这是属性boxWidth的通知器 信号。
[signal] void QBoxPlotSeries::boxsetsAdded(const QList<QBoxSet *> &sets)
当通过 `sets ` 指定的箱线图项目列表被添加到序列中时,会发出此信号。
[signal] void QBoxPlotSeries::boxsetsRemoved(const QList<QBoxSet *> &sets)
当由 `sets ` 指定的箱线图项目列表从该序列中移除时,将发出此信号。
[signal] void QBoxPlotSeries::brushChanged()
当用于填充箱线图项目中各箱体的画笔发生变化时,将触发此信号。
注意: 这是属性brush 的Notifier 信号。
void QBoxPlotSeries::clear()
从序列中移除所有箱线图项目,并将其永久删除。
[signal] void QBoxPlotSeries::clicked(QBoxSet *boxset)
当用户点击图表中由 `boxset ` 指定的箱线图项目时,会触发此信号。
int QBoxPlotSeries::count() const
返回箱线图系列中各箱线图条目的数量。
注意: 这是属性 count 的获取 函数。
[signal] void QBoxPlotSeries::countChanged()
当该序列中的箱线图条目数量发生变化时,会发出此信号。
注意: 这是属性count的通知 信号。
[signal] void QBoxPlotSeries::doubleClicked(QBoxSet *boxset)
当用户在图表中双击由boxset 指定的箱线图项目时,会发出此信号。
[signal] void QBoxPlotSeries::hovered(bool status, QBoxSet *boxset)
当鼠标悬停在图表中由 `boxset ` 指定的箱线图项目上时,会发出此信号。当鼠标移至该项目上方时,`status ` 变为 `true`;当鼠标再次移开时,它又变为 `false`。
bool QBoxPlotSeries::insert(int index, QBoxSet *set)
将由set 指定的箱线图项插入到序列中,位置由index 指定,并取得该项的所有权。如果该项为空或已属于该序列,则不会将其追加。若插入成功,则返回true 。
[signal] void QBoxPlotSeries::penChanged()
当用于绘制箱线图数据项线条的画笔发生变化时,会发出此信号。
注意: 这是属性pen的通知器 信号。
[signal] void QBoxPlotSeries::pressed(QBoxSet *boxset)
当用户在图表中单击由boxset 指定的箱线图元素并按住鼠标按钮时,会触发此信号。
[signal] void QBoxPlotSeries::released(QBoxSet *boxset)
当用户松开鼠标按钮,且该操作作用于图表中由 `boxset ` 指定的箱线图元素时,将触发此信号。
bool QBoxPlotSeries::remove(QBoxSet *set)
从序列中移除由set 指定的箱线图项目,若移除成功则永久删除该项目。若项目已被移除,则返回true 。
bool QBoxPlotSeries::take(QBoxSet *set)
从序列中获取由set 指定的箱线图项。不会删除该项。
注意:该系列 仍为该项的父对象。您必须将父对象设置为完全所有者。
如果提取操作成功,则返回true 。
[override virtual] QAbstractSeries::SeriesType QBoxPlotSeries::type() const
重新实现了属性QAbstractSeries::type 的访问函数。
返回序列的类型。
另请参阅 QAbstractSeries 和SeriesType 。
© 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.