Qt读写Excel--QXlsx插入图表5

Qt读写Excel–QXlsx插入图表5

更多精彩内容
个人内容分类汇总

1、概述

• QXlsx是一个可以读写Excel文件的库。不依赖office以及wps组件，可以在Qt5支持的任何平台上使用；

• 使用方式

  1. QXlsx可以编译为动态库使用（使用动态库不用每次的编译，也可以让项目代码量更少，不用一打开工程就几十个文件）；
  2. 直接将QXlsx.pri加入代码中使用（我比较推荐直接使用源码，因为QXlsx的注释信息基本在cpp文件中，可以通过阅读源码和注释来学习QXlsx的功能，当然，如果你已经熟悉了QXlsx的使用方式那编译成库使用会更方便，可以使工程的代码量变少）；

• 本文中实现的功能：

  • 插入所有类型的图表
    1. 插入面积图；
    2. 插入3D面积图（在WPS中显示存在问题，office没有测试）；
    3. 插入折线图；
    4. 插入3D折线图；
    5. 插入雷达图（貌似还不支持）；
    6. 插入散点图（在WPS中效果和CT_LineChart一样）；
    7. 插入饼图；
    8. 插入3D饼图（这个图表在WPS中样式和CT_PieChart一样，没有表现出3D效果，无法设置三维旋转）；
    9. 插入圆环图；
    10. 插入柱状图；
    11. 插入3D柱状图（在WPS中显示异常，不支持3D柱状图）；
    12. 插入饼图（CT_OfPieChart还不支持）；
    13. 插入曲面图（还不支持）；
    14. 插入3D曲面图（还不支持）；
    15. 插入气泡图（还不支持）；
  • 工作表插入图表【进阶】
    1. 设置【图例】位置；
    2. 设置图表【标题】；
    3. 打开图表网格线；
    4. 行列交换标头；
    5. 设置插入的数据范围是否包含标题；
    6. 插入图表，引用其它工作表数据。
  • 添加一个图表Sheet，并插入柱状图。

2、准备工作

Qt读写Excel–QXlsx基本使用1
Qt读写Excel–QXlsx编译为静态库2

3、函数说明

注意：执行了操作要保存才生效。⛔

• Chart *Document::insertChart(int row, int col, const QSize &size)

  • 功能说明： 在当前工作表第row行col列单元格【右下角位置】插入一个大小为size的图表；
  • 参数row： 插入图表的左上角位于row行；
  • 参数col： 插入图表的左上角位于col行；
  • 参数size： 图表的大小；
  • 返回值：返回指向刚插入的图表的指针；

• void Chart::setChartType(ChartType type)

  • 功能说明： 设置图表的类型；
  • 参数type： Chart::ChartType枚举定义的16种图表类型，其中部分类型还不支持；

• void Chart::addSeries(const CellRange &range, AbstractSheet *sheet, bool headerH, bool headerV, bool swapHeaders)

  • 功能说明： 为图表添加用于显示的数据系列；
  • 参数range： 添加数据的范围，例如：CellRange(“A1:C9”)表示添加第一列A1到C9的数据；
  • 参数sheet： 添加的数据位于哪一个工作表，默认为当前工作表；
  • 参数headerH： 数据系列范围第一行是否为列标题，true：为标题，默认为false；
  • 参数headerV： 数据系列范围第1列是否为行标题，true：为标题，默认为false；
  • 参数swapHeaders： true：交换行列标头；

• void Chart::setChartLegend(Chart::ChartAxisPos legendPos, bool overlay)

  • 功能说明： 设置图表图例的位置；
  • 参数legendPos： 图例位置，由Chart::ChartAxisPos枚举定义，可设置None：无图例, Left：左边, Right：右边， Top：上边, Bottom：下边；
  • 参数overlay： 图例是否会被图表遮挡，true：被遮挡，默认为false。

• void Chart::setChartTitle(QString strchartTitle)

  • 功能说明： 设置图表的标题；
  • 参数strchartTitle： 需要设置的标题内容。

• void Chart::setGridlinesEnable(bool majorGridlinesEnable, bool minorGridlinesEnable)

  • 功能说明： 是否开启图表的网格线；
  • 参数majorGridlinesEnable： true：启动主网格线，默认为false；
  • 参数minorGridlinesEnable： true：启动次网格线，默认为false；

4、示例代码

4.1 .h文件

/******************************************************************************
 * @文件名     test4.h
 * @功能       1、演示在工作表中插入所有QXlsx支持的图表类型和还不支持的类型，并通过WPS演示效果；
 *            2、设置【图例】位置；
 *            3、设置图表【标题】；
 *            4、打开图表网格线；
 *            5、行列交换标头；
 *            6、设置插入的数据范围是否包含标题；
 *            7、插入图表，引用其它工作表数据;
 *            8、插入图表Sheet，并绘制一个柱状图
 *
 * @开发者     mhf
 * @邮箱       [email protected]
 * @时间       2022/06/26
 * @备注
 *****************************************************************************/
#ifndef TEST4_H
#define TEST4_H

#include 
#include "Interface.h"

namespace Ui {
class Test4;
}

class Test4 :public InterFace
{
    Q_OBJECT

public:
    explicit Test4(QWidget *parent = nullptr);
    ~Test4();

    QString getExcelName() override;

private slots:
    void on_pushButton_clicked();

    void on_pushButton_2_clicked();

    void on_pushButton_3_clicked();

private:
    Ui::Test4 *ui;
};

#endif // TEST4_H

4.2 .cpp文件

#include "test4.h"
#include "ui_test4.h"

#include 
#include 
#include 
#include 
#include 
#include 
QXLSX_USE_NAMESPACE

#define EXCEL_NAME "chart.xlsx"         // 本Demo使用的Excel文件名

Test4::Test4(QWidget *parent) :
    InterFace(parent),
    ui(new Ui::Test4)
{
    ui->setupUi(this);
    this->setWindowTitle("QXlsx在工作表中插入所有支持的图表、插入图表Sheet");
    this->setToolTip(this->windowTitle());
}

Test4::~Test4()
{
    delete ui;
}

QString Test4::getExcelName()
{
    return EXCEL_NAME;
}

/**
 * @brief 演示在工作表中插入图表，这里演示了Qxlsx中所有图表类型；
 *        从源码中void ChartPrivate::saveXmlChart(QXmlStreamWriter &writer) const函数看
 *        部分ChartType类型还不支持，如CT_StockChart
 */
void Test4::on_pushButton_clicked()
{
    Document xlsx;                    // 创建一个Excel对象（默认有一个Sheet1）
    for(int i = 1; i < 10; i++)
    {
        xlsx.write(i, 1, i * i * i);    // 在第一列写入9个数据
        xlsx.write(i, 2, i * i);       // 在第二列写入9个数据
        xlsx.write(i, 3, i *i - 1);    // 写入第三列数据
    }
    qDebug() << CellReference(1, 2).toString();                    // 可将行列号转换为【字符串】单元格引用

    // 插入面积图
    xlsx.write(3, 4, "CT_AreaChart");  // 在图标左上角单元格中写入图标的类型
    Chart* areaChart = xlsx.insertChart(3, 3, QSize(300, 300));
    areaChart->setChartType(Chart::CT_AreaChart);
    areaChart->addSeries(CellRange("A1:C9"));

    // 插入3D面积图（在WPS中显示存在问题，office没有测试）
    xlsx.write(3, 10, "CT_Area3DChart");
    Chart *area3DChart = xlsx.insertChart(3, 9, QSize(300, 300));
    area3DChart->setChartType(Chart::CT_Area3DChart);
    area3DChart->addSeries(CellRange("A1:C9"));

    // 插入折线图
    xlsx.write(3, 16, "CT_LineChart");
    Chart* lineChart = xlsx.insertChart(3, 15, QSize(300, 300));
    lineChart->setChartType(Chart::CT_LineChart);
    lineChart->addSeries(CellRange("A1:C9"));

    // 插入3D折线图
    xlsx.write(23, 4, "CT_Line3DChart");
    Chart* line3DChart = xlsx.insertChart(23, 3, QSize(300, 300));
    line3DChart->setChartType(Chart::CT_Line3DChart);
    line3DChart->addSeries(CellRange("A1:C9"));

    // 插入股价图（貌似还不支持）
    xlsx.write(23, 10, "CT_StockChart");
    Chart* stockChart = xlsx.insertChart(23, 9, QSize(300, 300));
    stockChart->setChartType(Chart::CT_StockChart);
    stockChart->addSeries(CellRange("A1:C9"));

    // 插入雷达图（貌似还不支持）
    xlsx.write(23, 16, "CT_RadarChart");
    Chart* radarChart = xlsx.insertChart(23, 15, QSize(300, 300));
    radarChart->setChartType(Chart::CT_RadarChart);
    radarChart->addSeries(CellRange("A1:A9"));

    // 插入散点图（在WPS中效果和CT_LineChart一样）
    xlsx.write(43, 4, "CT_ScatterChart");
    Chart* scatterChart = xlsx.insertChart(43, 3, QSize(300, 300));
    scatterChart->setChartType(Chart::CT_ScatterChart);
    scatterChart->addSeries(CellRange("A1:A9"));             // 插入三个数据系列
    scatterChart->addSeries(CellRange("B1:B9"));
    scatterChart->addSeries(CellRange("C1:C9"));
    // 散点图不能以A1:C9这种方式同时选择三列数据，在WPS中会默认把第一列数据当做X轴数据，QXlsx中会直接舍弃掉第一列数据，
    // 由addSeries函数中if (d->chartType == CT_ScatterChart || d->chartType == CT_BubbleChart)可看出
//    scatterChart->addSeries(CellRange("A1:C9"));

    // 插入饼图
    xlsx.write(43, 10, "CT_PieChart");
    Chart* pieChart = xlsx.insertChart(43, 9, QSize(300, 300));    // 在第三行、三列的单元格右下角位置插入一个长宽为300的图表
    pieChart->setChartType(Chart::CT_PieChart);                    // 指定图表类型为【饼图】（支持16种类型图表）
    pieChart->addSeries(CellRange("A1:A9"));                       // 添加饼图的数据系列1（单元格引用字符串方式指定【第一列数据】）
    pieChart->addSeries(CellRange(CellReference(1, 2), CellReference(9, 2))); // 添加饼图数据2（通过CellReference指定【第二列数据】）
    pieChart->addSeries(CellRange(1, 3, 9, 3));                    // 添加饼图数据系列3（通过[开始行列号]和[结束行列号]指定【第三列数据】）

    // 插入3D饼图（这个图表在WPS中样式和CT_PieChart一样，没有表现出3D效果，无法设置三维旋转）
    xlsx.write(43, 16, "CT_Pie3DChart");
    Chart* pie3DChart = xlsx.insertChart(43, 15, QSize(300, 300));
    pie3DChart->setChartType(Chart::CT_Pie3DChart);
    pie3DChart->addSeries(CellRange("A1:A9"));

    // 插入圆环图
    xlsx.write(63, 4, "CT_DoughnutChart");
    Chart* doughnutChart = xlsx.insertChart(63, 3, QSize(300, 300));
    doughnutChart->setChartType(Chart::CT_DoughnutChart);
    doughnutChart->addSeries(CellRange("A1:A9"));

    // 插入柱状图
    xlsx.write(63, 10, "CT_BarChart");
    Chart* barChart = xlsx.insertChart(63, 9, QSize(300, 300));
    barChart->setChartType(Chart::CT_BarChart);
    barChart->addSeries(CellRange("A1:A9"));

    // 插入3D柱状图（在WPS中显示异常，不支持3D柱状图）
    xlsx.write(63, 16, "CT_Bar3DChart");
    Chart* bar3DChart = xlsx.insertChart(63, 15, QSize(300, 300));
    bar3DChart->setChartType(Chart::CT_Bar3DChart);
    bar3DChart->addSeries(CellRange("A1:A9"));

    // 插入饼图（还不支持）
    xlsx.write(83, 4, "CT_OfPieChart");
    Chart* ofPieChart = xlsx.insertChart(83, 3, QSize(300, 300));
    ofPieChart->setChartType(Chart::CT_OfPieChart);
    ofPieChart->addSeries(CellRange("A1:A9"));

    // 插入曲面图（还不支持）
    xlsx.write(83, 10, "CT_SurfaceChart");
    Chart* surfaceChart = xlsx.insertChart(83, 9, QSize(300, 300));
    surfaceChart->setChartType(Chart::CT_SurfaceChart);
    surfaceChart->addSeries(CellRange("A1:A9"));

    // 插入3D曲面图（还不支持）
    xlsx.write(83, 16, "CT_Surface3DChart");
    Chart* surface3DChart = xlsx.insertChart(83, 15, QSize(300, 300));
    surface3DChart->setChartType(Chart::CT_Surface3DChart);
    surface3DChart->addSeries(CellRange("A1:A9"));

    // 插入气泡图（还不支持）
    xlsx.write(103, 4, "CT_BubbleChart");
    Chart* bubbleChart = xlsx.insertChart(103, 3, QSize(300, 300));
    bubbleChart->setChartType(Chart::CT_BubbleChart);
    bubbleChart->addSeries(CellRange("A1:A9"));

    if(xlsx.saveAs(EXCEL_NAME))    // 如果文件已经存在则覆盖
    {
        qInfo() << "插入所有图表Demo保存成功！";
    }
    else
    {
        qWarning() << "插入所有图表Demo保存失败！";
    }
}

/**
 * @brief 1、设置【图例】位置；
 *        2、设置图表【标题】；
 *        3、打开图表网格线；
 *        4、行列交换标头；
 *        5、设置插入的数据范围是否包含标题；
 *        6、插入图表，引用其它工作表数据。
 */
void Test4::on_pushButton_2_clicked()
{
    Document xlsx;

    for(int i = 1; i < 10; i++)
    {
        xlsx.write(1, i + 1, QString("Pos %1").arg(i));      // 写入列标题
        xlsx.write(2, i + 1, i * i * i);                     // 写入数据
        xlsx.write(3, i + 1, i * i);
    }
    // 写入行标题
    xlsx.write(2, 1, "Set 1");
    xlsx.write(3, 1, "Set 2");

    // 插入一个柱状图，并设置图例在【右边】
    xlsx.write(5, 4, "图例在右边");
    Chart* barChart1 = xlsx.insertChart(5, 3, QSize(300, 300));  // 插入图表
    barChart1->setChartType(Chart::CT_BarChart);
    barChart1->setChartLegend(Chart::Right);     // 设置图例在右边，可设置None：无图例, Left：左边, Right：右边， Top：上边, Bottom：下边
    barChart1->setChartTitle("Test1");
    barChart1->addSeries(CellRange(1, 1, 3, 10), nullptr, true, true, false);

    // 插入一个柱状图，启动【主网格线】
    xlsx.write(5, 10, "图例在左边，启动主网格线");
    Chart* barChart2 = xlsx.insertChart(5, 9, QSize(300, 300));  // 插入图表
    barChart2->setChartType(Chart::CT_BarChart);
    barChart2->setChartLegend(Chart::Left);
    barChart2->setChartTitle("Test2");
    barChart2->setGridlinesEnable(true);   // 启动主网格线
    barChart2->addSeries(CellRange(1, 1, 3, 10), nullptr, true, true, false);

    // 插入一个柱状图，启动【次网格线】
    xlsx.write(5, 16, "图例在上边，启动次网格线");
    Chart* barChart3 = xlsx.insertChart(5, 15, QSize(300, 300));  // 插入图表
    barChart3->setChartType(Chart::CT_BarChart);
    barChart3->setChartLegend(Chart::Top);
    barChart3->setChartTitle("Test3");
    barChart3->setGridlinesEnable(false, true);  // 关闭主网格线，启动子网格线
    barChart3->addSeries(CellRange(1, 1, 3, 10), nullptr, true, true, false);

    // 插入一个柱状图，【行列交换标头】
    xlsx.write(25, 4, "图例在下边，行列交换标头");
    Chart* barChart4 = xlsx.insertChart(25, 3, QSize(300, 300));  // 插入图表
    barChart4->setChartType(Chart::CT_BarChart);
    barChart4->setChartLegend(Chart::Bottom);
    barChart4->setChartTitle("Test4");
    barChart4->addSeries(CellRange(1, 1, 3, 10), nullptr, false, true, true);  // 参数5【true：以1列为1个数据系列，false：以1行为1个数据系列】

    // 插入一个柱状图，【数据范围不包含标题】
    xlsx.write(25, 10, "数据范围不包含标题");
    Chart* barChart5 = xlsx.insertChart(25, 9, QSize(300, 300));  // 插入图表
    barChart5->setChartType(Chart::CT_BarChart);
    barChart5->setChartLegend(Chart::Right);
    barChart5->setChartTitle("Test5");
    // 参数1：添加数据系列范围；参数2：指定插入的数据位于哪个工作表（Sheet），默认为NULL，即当前工作表；
    // 参数3，数据系列范围第一行是否为列标题，true：为标题；参数4，数据系列范围第1列是否为行标题，true：为标题；默认都不为标题
    // 参数5：交换行列标头。
    barChart5->addSeries(CellRange(1, 1, 3, 10));

    // 插入一个柱状图，【数据范围包含列标题】
    xlsx.write(25, 16, "数据范围包含列标题");
    Chart* barChart6 = xlsx.insertChart(25, 15, QSize(300, 300));  // 插入图表
    barChart6->setChartType(Chart::CT_BarChart);
    barChart6->setChartLegend(Chart::Right);
    barChart6->setChartTitle("Test6");
    barChart6->addSeries(CellRange(1, 1, 3, 10), nullptr, true);

    // 插入一个柱状图，【数据范围包含行标题】
    xlsx.write(45, 4, "数据范围包含行标题");
    Chart* barChart7 = xlsx.insertChart(45, 3, QSize(300, 300));  // 插入图表
    barChart7->setChartType(Chart::CT_BarChart);
    barChart7->setChartLegend(Chart::Right);
    barChart7->setChartTitle("Test7");
    barChart7->addSeries(CellRange(1, 1, 3, 10), nullptr, false, true);

    // 添加一个工作表（Sheet2）,在Sheet2中插入图表，数据为Sheet1中的数据
    xlsx.addSheet("Sheet2");                                     // 添加一个工作表，当前工作表为Sheet2
    xlsx.write(3, 4, "插入图表，引用Sheet1数据");
    Chart* barChart8 = xlsx.insertChart(3, 3, QSize(300, 300));  // 插入图表
    barChart8->setChartType(Chart::CT_BarChart);
    barChart8->setChartLegend(Chart::Right);
    barChart8->setChartTitle("Test8");
    barChart8->addSeries(CellRange(1, 1, 3, 10), xlsx.sheet("Sheet1"));   // 添加数据系列范围，并指定为Sheet1中的数据

    if(xlsx.saveAs(EXCEL_NAME))                             // 如果文件已经存在则覆盖
    {
        qInfo() << "保存成功！";
    }
    else
    {
        qWarning() << "保存失败！";
    }
}

/**
 * @brief 插入图表Sheet，并绘制一个柱状图
 */
void Test4::on_pushButton_3_clicked()
{
    Document xlsx;
    for(int i = 1; i < 10; i++)
    {
        xlsx.write(i, 1, i * i);         // 在Sheet1中写入1列数据
    }

    xlsx.addSheet("Chart1", AbstractSheet::ST_ChartSheet);               // 插入一个名称为【Chart1】，类型为【图表】的Sheet
    Chartsheet* sheet = static_cast<Chartsheet*>(xlsx.currentSheet());   // 获取当前工作表，并将类型转换为Chartsheet*
    Chart* barChart = sheet->chart();           // 图表Sheet中会默认内置一个Chart，从这一步开始就和正常操作图表一样了
    barChart->setChartType(Chart::CT_BarChart); // 设置图表类型位柱状图
    barChart->addSeries(CellRange("A1:A9"), xlsx.sheet("Sheet1")); // 添加数据系列，数据位于Sheet1中的A1-A9

    if(xlsx.saveAs(EXCEL_NAME))                             // 如果文件已经存在则覆盖
    {
        qInfo() << "保存成功！";
    }
    else
    {
        qWarning() << "保存失败！";
    }
}

5、实现效果

6、源代码

gitee
github