QBarSet、QAbstractBarSeries及其子类

QBarSet

一、描述

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

条形集包含每个类别的一个数值。假设集的第一个值属于第一个类别，第二个属于第二个类别，依此类推。

如果集合中的值少于类别，则假定缺失值位于集合的末尾。对于集合中间的缺失值，使用零的数值。将不显示零值集的标签。

二、属性成员

1、borderColor : QColor

边框颜色（画笔）。

2、brush : QBrush

填充条形的画刷。

      color : QColor

brush 的颜色。

3、label : QString

标签。

4、labelBrush : QBrush

绘制标签的画刷。

5、labelColor : QColor

标签颜色。

6、labelFont : QFont

绘制标签的字体。

7、pen : QPen

绘制条线的画笔。

三、成员函数

1、【信号】void clicked(int index)

当单击条形集中由 index 指定的条形时，将发出此信号。

2、【信号】void doubleClicked(int index)

当单击条形集中由 index 指定的条形时，将发出此信号。

3、【信号】void hovered(bool status, int index)

当鼠标悬停在条形集中索引指定的条形时，会发出此信号。当鼠标移到条形上时，status 变为 true，当鼠标再次移开时，status 变为 false。

4、【信号】void pressed(int index)

当单击条形集由 index 指定的条形并按住鼠标按钮时，将发出此信号。

5、【信号】void released(int index)

当在条形集中由 index 指定的条形上释放鼠标按下时，将发出此信号。

6、【信号】void valueChanged(int index)

当 index 指定位置的值被修改时，会发出此信号。

7、【信号】void valuesAdded(int index, int count)

当新值添加到条形集时，会发出此信号。index 表示第一个插入值的位置，count 是插入值的个数。

8、【信号】void valuesRemoved(int index, int count)

当从条形集中移除值时会发出此信号。index 是第一个移除值的位置，count 是移除值的个数。

9、void append(const qreal value)

     void append(const QList<qreal> &values)

     QBarSet & operator<<(const qreal &value)

将新值附加到条形集的末尾。

10、qreal at(const int index)

        qreal operator[](const int index)

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

11、int count()

返回条形集中值的数量。

12、void deselectAllBars()

取消选择条形图中的所有条形。将发出 selectedBarsChanged() 信号。

       void deselectBar(int index)

       void deselectBars(const QList<int> &indexes)

取消选择参数指定的条形。将发出 selectedBarsChanged() 信号。

13、void insert(const int index, const qreal value)

在 index 指定的位置插入值。

14、bool isBarSelected(int index)

返回 index 处的条形是否被选中。

如果使用 setSelectedColor() 指定选定颜色，则使用选定颜色绘制选定条形。

15、void remove(const int index, const int count = 1)

从条形集中 index 处移除 count 个值。

16、void replace(const int index, const qreal value)

替换值。

17、void selectAllBars()

        void selectBar(int index)

        void selectBars(const QList<int> &indexes)

        QList<int> selectedBars()

        void setBarSelected(int index, bool selected)

选中条形。将发出 selectedBarsChanged() 信号。

        void toggleSelection(const QList<int> &indexes)

将列表中指定的索引选择状态更改为相反的状态。将发出 selectedBarsChanged() 信号。

18、QColor selectedColor() / void setSelectedColor(const QColor &color)

选中条形的填充颜色。如果未指定，则使用 color 的值作为默认值。

19、qreal sum()

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

---

QAbstractBarSeries

一、描述

是所有条形图类的抽象父类。

二、类型成员

1、enum QAbstractBarSeries::LabelsPosition：此枚举值描述了数据值标签的位置。

• LabelsCenter：中心。
• LabelsInsideEnd：顶部，条形内。
• LabelsInsideBase：底部，条形内。
• LabelsOutsideEnd：顶部，条形外。

三、属性成员

1、barWidth : qreal

条形宽度。是 x 轴的单位。最小宽度为零，负值被视为零。将宽度设置为零意味着屏幕上的条形宽度为一个像素，而与 x 轴的比例无关。使用 x 轴刻度对宽于零的条进行缩放。

注意：当与 QBarSeries 一起使用时，此值指定一组条形的宽度，而不是单个条形的宽度。

2、count : const int

条形图中条形集的数量。

3、labelsAngle : qreal

以度为单位的值标签的角度。

4、labelsFormat : QString

在条形图中显示标签的格式。

支持以下格式标签：

• @value：条形的值

例如，以下用法将生成显示值后跟单位 (u) 的标签：

series->setLabelsFormat("@value u");

5、labelsPosition : LabelsPosition

标签的位置。

6、labelsPrecision : int

标签中显示的有效数字的最大位数。默认为 6。

7、labelsVisible : bool

标签是否可见。

四、成员函数

1、【信号】void barsetsAdded(const QList<QBarSet *> &sets)

图形集添加到条形图中时，将发出此信号。

2、【信号】void barsetsRemoved(const QList<QBarSet *> &sets)

图形集从条形图中移除时，将发出此信号。

3、【信号】void clicked(int index, QBarSet *barset)

单击条形集 barset 中的第 index 个条形发出此信号。

4、【信号】void doubleClicked(int index, QBarSet *barset)

双击条形集 barset 中的第 index 个条形发出此信号。

5、【信号】void hovered(bool status, int index, QBarSet *barset)

当鼠标悬停在条形集 barset 中的第 index 个条形上时，将发出此信号。当鼠标移到条上时，status 变为 true，当鼠标再次移开时，status 变为 false。

6、【信号】void pressed(int index, QBarSet *barset)

在条形集 barset 中单击第 index 个图形并按住鼠标按钮时，将发出此信号。

7、【信号】void released(int index, QBarSet *barset)

在条形集 barset 中第 index 个图形上释放鼠标按下时，将发出此信号。

8、bool append(QBarSet *set)

     bool append(const QList<QBarSet *> &sets)

将条形集追加到条形图并获得条形集的所有权。

9、QList<QBarSet *> barSets()

返回条形图中条形集的列表。

10、void clear()

从条形图中移除所有条形集并永久删除它们。

11、bool insert(int index, QBarSet *set)

将条形集插入到由 index 指定的位置处的条形图中，并获得该图形集的所有权。

12、bool remove(QBarSet *set)

从条形图中移除条形集并将其永久删除。

13、bool take(QBarSet *set)

从系列中移除图形集但不 delete 它。条形图仍然是该图形集的父对象。

---

QBarSeries

一、描述

此类将一系列数据显示为按类别分组的垂直条形。

---

QHorizontalBarSeries

一、描述

此类将一系列数据显示为按类别分组的水平条形。

---

QStackedBarSeries

一、描述

此类将一系列数据显示为垂直堆叠的条形图，每个类别一个条形。

---

QHorizontalStackedBarSeries

一、描述

此类将一系列数据显示为水平堆叠的条形图，每个类别一个条形。

添加到条形图中的每个条形集都会为每个堆叠条形贡献一个段。段大小对应于段值与堆栈中所有段的总值相比的百分比。不绘制零值条。

---

QPercentBarSeries

一、描述

此类将数据绘制为一系列大小一致的垂直堆叠条形图，每个类别一个条形图。

添加到条形图中的每个条形集都会为每个堆叠条形贡献一个段。段大小对应于段值与堆栈中所有段的总值相比的百分比。 不绘制零值条。

---

QHorizontalPercentBarSeries

一、描述

此类将数据绘制为一系列大小一致的水平堆叠条形图，每个类别一个条形图。