【Qt】QCustomPlot 简易配置教程

QCustomPlot 简易配置教程

QCustomPlot 是一个轻量级的 Qt 绘图库，用于在 Qt 应用中绘制各种图表。下面是简单的配置步骤：

一、准备工作

1. 下载 QCustomPlot 库：从官网（www.qcustomplot.com）下载最新版本
2. 解压后会得到两个文件：qcustomplot.h 和 qcustomplot.cpp

二、添加到 Qt 项目

方法1：直接添加文件（推荐新手）

1. 在 Qt Creator 中打开你的项目
2. 右键点击项目 -> “添加现有文件”
3. 选择下载的 qcustomplot.h 和 qcustomplot.cpp 添加到项目中

方法2：修改项目文件（.pro）

确保 .pro 文件中包含必要的模块：

QT       += core gui widgets printsupport
SOURCES += \
    main.cpp \
    mainwindow.cpp \
    qcustomplot.cpp  # 添加这一行

HEADERS += \
    mainwindow.h \
    qcustomplot.h    # 添加这一行

三、在界面中使用

1. 设计界面

• 打开 UI 设计器
• 拖一个 QWidget 到窗口上
• 右键该部件 -> “提升为…”
• 提升的类名称填写 QCustomPlot，头文件填写 qcustomplot.h
• 点击 “添加” 然后 “提升”

2. 简单绘图示例

在代码中添加如下内容绘制简单曲线：

// 包含头文件
#include "qcustomplot.h"

// 在窗口初始化函数中添加
ui->customPlot->addGraph();  // 添加一条曲线
QVector<double> x(101), y(101);  // 数据点
for (int i=0; i<101; ++i)
{
  x[i] = i/50.0 - 1;  // x范围: -1 到 1
  y[i] = x[i]*x[i];   // y = x² 曲线
}
ui->customPlot->graph(0)->setData(x, y);  // 设置数据
ui->customPlot->xAxis->setLabel("x");     // x轴标签
ui->customPlot->yAxis->setLabel("y");     // y轴标签
ui->customPlot->xAxis->setRange(-1, 1);   // x轴范围
ui->customPlot->yAxis->setRange(0, 1);    // y轴范围
ui->customPlot->replot();                 // 重绘图表

四、常见问题解决

1. 若出现 QPrinter 相关错误：确保已添加 printsupport 模块
2. 若出现 QCPGraphData 相关错误：检查 QCustomPlot 版本是否与 Qt 版本匹配
3. 编译错误：尝试先清理项目（Build -> Clean All）再重新构建

完成以上步骤，你就可以在 Qt 项目中使用 QCustomPlot 绘制各种图表了。更多功能可以参考官方示例代码。