Qt Charts 之 QBarSeries Class

详细描述

QBarSeries类提供一系列按类别分组的垂直条形图（柱状图）。

这个类将数据绘制为按类别分组的垂直条形图，每个分组的每一个条形都添加到这个系列（QBarSeries）中。

bar chart example 演示了怎么创建一个分组条形图：

相关代码：

      QBarSet *set0 = new QBarSet("Jane");
      QBarSet *set1 = new QBarSet("John");
      QBarSet *set2 = new QBarSet("Axel");
      QBarSet *set3 = new QBarSet("Mary");
      QBarSet *set4 = new QBarSet("Samantha");

      *set0 << 1 << 2 << 3 << 4 << 5 << 6;
      *set1 << 5 << 0 << 0 << 4 << 0 << 7;
      *set2 << 3 << 5 << 8 << 13 << 8 << 5;
      *set3 << 5 << 6 << 7 << 3 << 4 << 5;
      *set4 << 9 << 7 << 5 << 3 << 1 << 2;

创建五个条集合（QBarSet）实例代表“Jane”等五个人并给每个条集合填充6个数据，这里中间的缺失值以0表示，缺失值在条形图中不会显示。

      QBarSeries *series = new QBarSeries();
      series->append(set0);
      series->append(set1);
      series->append(set2);
      series->append(set3);
      series->append(set4);

将每个条集合（QBarSet）实例添加到条系列（QBarSeries）中，从图中我们可以看出条形图显示是按类别是显示的，有多少个类别就有多少个分组，这里的类别是月份，因为有一月到六月，所以就有六个分组。

常用API

QBarSeries::QBarSeries(QObject *parent = Q_NULLPTR)

构造一个空的父对象为parent的条系列。

QBarSeries::~QBarSeries()

从图标中移除条系列。

[virtual] QAbstractSeries::SeriesType QBarSeries::type() const

返回条系列的类型（ QAbstractSeries::SeriesTypeBar，QAbstractSeries::SeriesTypeStackedBar，QAbstractSeries::SeriesTypePercentBar，QAbstractSeries::SeriesTypeHorizontalBar，QAbstractSeries::SeriesTypeHorizontalStackedBar，QAbstractSeries::SeriesTypeHorizontalPercentBar等）。

继承的成员函数：

bool QAbstractBarSeries::append(QBarSet *set)

增加指定条集合set到条系列中并获得条集合的所有权。如果条集合是空的或者已经属于该系列，将不会被添加到条系列中。添加成功返回true。

bool QAbstractBarSeries::append(QList<QBarSet *> sets)

添加指定条集合链表sets到条系列中并获得条集合的所有权。如果添加成功返回true。如果任意一个sets是空的或者已经在之前添加到条系列中，什么也不会被添加到条系列中并返回false。如果任意一个条集合在链表中出现超过一次，什么也不会被添加到条系列中并且函数返回false。