【QCustomPlot】使用方法（源码方式）

说明

使用 QCustomPlot 绘图库辅助开发时整理的学习笔记。同系列文章目录可见《绘图库 QCustomPlot 学习笔记》目录。本篇介绍 QCustomPlot 的一种使用方法，通过包含源码的方式进行使用，这也是最常用的方法，示例中使用的 QCustomPlot 版本为 Version 2.1.1。

说明
1. 下载源码
2. 使用方法
3. 示例工程源码

1. 下载源码

详见本人另一篇博客【QCustomPlot】下载，使用时，只需要 qcustomplot.h 与 qcustomplot.cpp 两个文件。官网 - QCustomPlot - SettingUp 有对 QCustomPlot 的使用方法做介绍。

2. 使用方法

2.1 将源文件添加进项目

把 qcustomplot.h 与 qcustomplot.cpp 两个文件放在项目路径下，然后右键 项目名 -> 添加现有文件...，选择 qcustomplot.h 与 qcustomplot.cpp。

2.2 修改 .pro 工程文件

由于 QCustomPlot 具有导出 PDF 的功能，使用到了 printsupport 模块，因此需要在 .pro 工程文件中添加这一模块，如下所示，注意前面的版本条件。

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport

2.3 将 QWidget 提升为 QCustomPlot

在设计界面中，右键某个 QWidget 控件，点击 提升为...。

在弹出的对话框中，先在 ”提升的类名称“ 一栏写上 QCustomPlot，注意大小写要完全一致，然后点击添加按钮，最后点击提升按钮。

至此，这个 QWidget 控件就被提升为了 QCustomPlot 控件，可以进行绘图了。

2.4 绘制图像

完成以上几步后，点击左下方的绿色三角，运行项目，会得到一个空的坐标轴，如下所示：

在这个区域内，可以使用 QCustomPlot 提供的方法绘制函数曲线图、参数曲线图、柱状图、箱线图、热力图等，详见帮助文档，或本人同系列博客。这里提供一个示例，在合适的地方添加如下代码：

QVector<double> x = {0,1,2,3,4,5,6,7,8,9};

QVector<double> y = {0,2,4,9,16,25,36,49,64,81};

ui->widget->addGraph();

ui->widget->graph(0)->setData(x, y);

ui->widget->graph(0)->rescaleAxes();

ui->widget->replot();

再次点击左下方的绿色三角，运行项目，会得到以下曲线图：

3. 示例工程源码

3.1 文件 demoQCP.pro

QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport

TARGET = demoQCP

TEMPLATE = app

SOURCES += \

        main.cpp \

        mainwindow.cpp \

        qcustomplot.cpp

HEADERS += \

        mainwindow.h \

        qcustomplot.h

FORMS += \

        mainwindow.ui

3.2 文件 main.cpp

#include "mainwindow.h"

#include <QApplication>

int main(int argc, char *argv[])

{

    QApplication a(argc, argv);

    MainWindow w;

    w.show();

    return a.exec();

}

3.3 文件 mainwindow.h

#ifndef MAINWINDOW_H

#define MAINWINDOW_H

#include <QMainWindow>

namespace Ui {

class MainWindow;

}

class MainWindow : public QMainWindow

{

    Q_OBJECT

public:

    explicit MainWindow(QWidget *parent = 0);

    ~MainWindow();

private:

    Ui::MainWindow *ui;

};

#endif // MAINWINDOW_H

3.4 文件 mainwindow.cpp

#include "mainwindow.h"

#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent) :

    QMainWindow(parent),

    ui(new Ui::MainWindow)

{

    ui->setupUi(this);

    // 绘图代码

    QVector<double> x = {0,1,2,3,4,5,6,7,8,9};

    QVector<double> y = {0,2,4,9,16,25,36,49,64,81};

    ui->widget->addGraph();

    ui->widget->graph(0)->setData(x, y);

    ui->widget->graph(0)->rescaleAxes();

    ui->widget->replot();

}

MainWindow::~MainWindow()

{

    delete ui;

}

3.5 其他文件

除以上四个文件外，还剩三个文件：mainwindow.ui、qcustomplot.h、qcustomplot.cpp。其中 mainwindow.ui 是 Qt Creator 生成的默认 UI 文件，界面中只多了一个提升后的 QCustomPlot 控件，可使用同样步骤再次生成。qcustomplot.h 与 qcustomplot.cpp 即是下载所得的两个文件。