说明
使用 QCustomPlot 绘图库辅助开发时整理的学习笔记。同系列文章目录可见 《绘图库 QCustomPlot 学习笔记》目录。本篇介绍 QCustomPlot 的一种使用方法，通过包含源码的方式进行使用，这也是最常用的方法，示例中使用的 QCustomPlot 版本为 Version 2.1.1。
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 即是下载所得的两个文件。