柱状图QCPBars

一、QCPBars 概述

QCPBars 是 QCustomPlot 中用于绘制柱状图/条形图的类，支持单组或多组柱状图显示，可自定义宽度、颜色和间距等属性。

二、主要属性

三、常用方法

1. 数据相关方法

2. 样式设置方法

3. 交互相关方法

四、信号列表

五、枚举类型

1. WidthType 宽度类型

六、基础使用示例

cpp

// 创建柱状图
QCPBars *bars = new QCPBars(customPlot->xAxis, customPlot->yAxis);

// 设置数据
QVector<double> x(5), y(5);
for (int i=0; i<5; ++i) {
    x[i] = i+1;  // 1, 2, 3, 4, 5
    y[i] = QRandomGenerator::global()->bounded(1, 10); // 随机值1-10
}
bars->setData(x, y);

// 设置样式
bars->setName("月度销售额");
bars->setWidth(0.5); // 柱子宽度
bars->setPen(QPen(Qt::darkBlue));
bars->setBrush(QColor(100, 150, 250));

// 设置坐标轴
customPlot->xAxis->setRange(0, 6);
customPlot->yAxis->setRange(0, 10);

// 刷新显示
customPlot->replot();

七、高级功能示例

1. 多组柱状图

cpp

// 创建第一组柱状图
QCPBars *bars1 = new QCPBars(customPlot->xAxis, customPlot->yAxis);
bars1->setData({1,2,3,4}, {3,5,2,6});
bars1->setWidth(0.3);
bars1->setBrush(QColor(100, 150, 250));
bars1->setName("第一季度");

// 创建第二组柱状图
QCPBars *bars2 = new QCPBars(customPlot->xAxis, customPlot->yAxis);
bars2->setData({1,2,3,4}, {4,3,6,2});
bars2->setWidth(0.3);
bars2->setBrush(QColor(250, 150, 100));
bars2->setName("第二季度");

// 创建柱状图分组并设置间距
QCPBarsGroup *group = new QCPBarsGroup(customPlot);
group->setSpacingType(QCPBarsGroup::stAbsolute);
group->setSpacing(0.1); // 柱子间距
group->append(bars1);
group->append(bars2);

2. 堆叠柱状图

cpp

// 创建基础柱状图
QCPBars *baseBars = new QCPBars(customPlot->xAxis, customPlot->yAxis);
baseBars->setData({1,2,3,4}, {3,2,4,1});
baseBars->setBrush(QColor(100, 150, 250));

// 创建堆叠在上方的柱状图
QCPBars *stackedBars = new QCPBars(customPlot->xAxis, customPlot->yAxis);
stackedBars->setData({1,2,3,4}, {2,3,1,4});
stackedBars->setBrush(QColor(250, 150, 100));
stackedBars->moveAbove(baseBars); // 关键：设置堆叠顺序

3. 自定义柱子选择样式

cpp

bars->setSelectable(QCP::stSingleData); // 允许选择单个柱子
bars->setSelectedPen(QPen(Qt::red, 2));
bars->setSelectedBrush(QBrush(QColor(255, 100, 100, 150)));

// 连接选择变化信号
connect(customPlot, &QCustomPlot::selectionChangedByUser, [=](){
    if (bars->selected()) {
        QCPDataSelection selection = bars->selection();
        if (selection.dataRangeCount() > 0) {
            int index = selection.dataRange().begin();
            qDebug() << "选中了第" << index+1 << "个柱子";
        }
    }
});

八、性能优化技巧

1. 大数据集处理：

   cpp

   bars->setAntialiased(false); // 关闭抗锯齿提高性能

2. 自定义绘制：

   cpp

   // 继承QCPBars重写draw方法实现自定义绘制
   class CustomBars : public QCPBars {
   protected:
       virtual void draw(QCPPainter *painter) override {
           // 自定义绘制逻辑
       }
   };

3. 使用OpenGL加速：

   cpp

   customPlot->setOpenGl(true);

QCPBars 提供了丰富的自定义选项，可以创建各种复杂的柱状图可视化效果，包括分组柱状图、堆叠柱状图、百分比柱状图等。