Qt中使用QPdfWriter类结合QPainter类绘制并输出PDF文件

一.类的介绍

1.QPdfWriter介绍

Qt中提供了一个直接可以处理PDF的类，这就是QPdfWriter类。
（1）PDF文件生成
支持创建新的PDF文件或覆盖已有文件，通过构造函数直接绑定文件路径或QFile对象；
默认生成矢量图形PDF，支持高分辨率输出（可设置DPI）；
（2）页面属性配置
页面方向：通过setPageOrientation(QPageLayout::Orientation)设置纵向（Portrait）或横向（Landscape）；
页面尺寸：使用setPageSize(QPageSize::A4)定义纸张大小，支持ISO标准尺寸（如A4、A3）；
页边距：通过setPageMargins()调整内容区域与页边的距离；
（3）内容绘制
与QPainter深度集成，支持所有标准绘图操作：
图形：线段、矩形、椭圆、多边形等；
文本：多字体样式、对齐方式、旋转文字；
图像：支持PNG、JPG、SVG等格式的嵌入；
（4）多页面管理
通过QPainter::begin()和QPainter::end()控制绘制流程；
使用QPrinter::newPage()或手动分页逻辑实现多页文档；

2.QPainter介绍

（1）QPainter类功能
QPainter是Qt框架中用于2D图形绘制的核心类，提供高度优化的绘图功能，支持在QWidget、QImage、QPixmap、QPrinter等设备上进行绘制。其主要特性包括：

  • 支持矢量图形（直线/曲线/几何图形）和位图操作；
  • 提供坐标变换、复合模式、抗锯齿等高级特性；
  • 集成字体渲染、图像合成等专业级功能；
  • 必须通过paintEvent()事件或在继承自QPaintDevice的类中使用；
    （2）QPainter类接口
  1. 基础绘图操作
    在这里插入图片描述
  2. 文本与图像处理
    在这里插入图片描述
  3. 状态控制与高级特性
    在这里插入图片描述
    QPainter类还有很多接口函数，尤其是跟绘制有关的，很多重载的接口方便不同情况的使用，具体可以参考官网的介绍QPainter类。

二.开发生成PDF文件

下面开始用上文中的两个类来封装一个专门用来绘制PDF文件的类。

1.使用前要注意：

  • 坐标系系统：PDF坐标系原点在页面左上角，Y轴向下延伸，X轴向右延伸；
  • 单位换算：使用QPageLayout::Millimeter设置毫米单位，绘制时默认使用像素单位；
  • 图像缩放：推荐使用QRect参数控制图片显示尺寸，避免直接缩放；
  • 字体嵌入：中文字体需通过QFontDatabase加载系统字体；
  • 多页处理：通过QPdfWriter的newPage()创建新页面；

2.绘制流程梳理

  • 想要操作PDF文件，首先得有个文件，使用QFile的对象指向文件，然后创建QPdfWriter类的对象，并将QPdfWriter绑定在该文件上，然后用QPdfWriter对象设定PDF的一些参数，比如DPI，绘制页面大小等。
  • 其次，想要绘制得打开文件，调用QFile对象打开绑定的pdf格式的文件；
  • 再次，创建QPainter类对象，用该对象的各个规制接口来绘制各种图形文字等，如果你要设计绘制的接口很多的话，这里其实是最耗时的；
  • 最后，正确的释放资源，关闭文件；

3.代码说明

现在实操

  • QtCreator上创建一个简单的应用程序项目，先编译下，确保原始项目没问题；
  • 在程序界面上添加一个按钮，命名“btCreatePdf”，连接好按钮对应的点击信号槽；
  • 添加新的C++类，继承自QObject，类命名“PdfGenerator”，这就是我们准备开发的一个专门操作PDF的自定义类，也就是我们所有对PDF的操作都在这个类里边完成；
  • “PdfGenerator”类的设计开发，包含QPdfWriter，QPainter，QFont，QImage，QPageSize， QFile等类；创建QPdfWriter类的对象，QPainter类的对象，QFile类的对象；调用这些对象的接口实现PDF的绘制。
  • 最后，在主程序中包含上面自定义类，在界面按钮“btCreatePdf”中调用其实现PDF绘制。
    不多说，直接上代码：

PdfGenerator 类的头文件：


// pdfgenerator.h 
#include <QObject>
#include <QPdfWriter>
#include <QPainter>
#include <QFont>
#include <QImage>
#include <QPageSize>
#include <QFile>class PdfGenerator : public QObject {Q_OBJECT
public:explicit PdfGenerator(const QString &fileName, QPagedPaintDevice::PageSize size = QPagedPaintDevice::PageSize::A4);~PdfGenerator();// 基础设置 void setMargins(qreal left, qreal top, qreal right, qreal bottom);void setResolution(int dpi);void newPage();bool beginPage();bool endPage();// 绘制接口//绘制线段void drawLine(const QPointF &start, const QPointF &end, const QColor &color, qreal width);//绘制文字void drawText(const QRectF &rect, const QString &text, const QFont &font, const QColor &color, Qt::Alignment align);//绘制图片void drawImage(const QRectF &rect, const QString &imagePath, bool keepAspectRatio);//绘制矩形void drawRect(const QRectF &rect, const QColor &fillColor, const QColor &borderColor, qreal borderWidth);//绘制椭圆void drawEllipse(const QRectF &rect, const QColor &fillColor, const QColor &borderColor, qreal borderWidth);//想设计其他绘制接口继续往下加	private:QPdfWriter *m_writer = nullptr;QPainter *m_painter = nullptr;QRect m_pageRect;QFile m_pdfFile;
};

PdfGenerator 类的cpp文件

#include "PdfGenerator.h"
#include <QtDebug>
// pdfgenerator.cpp  
PdfGenerator::PdfGenerator(const QString &fileName, QPagedPaintDevice::PageSize size)
{m_pdfFile.setFileName(fileName);m_writer = new QPdfWriter(&m_pdfFile);m_writer->setPageSize(size);m_writer->setResolution(300);m_writer->setPageMargins(QMarginsF(20, 20, 20, 20), QPageLayout::Millimeter);m_pageRect = m_writer->pageLayout().paintRectPixels(m_writer->resolution());// 计算可绘制区域 m_pageRect = QRect(0, 0, m_writer->width(), m_writer->height());if(!m_pdfFile.open(QIODevice::WriteOnly))return ;}PdfGenerator::~PdfGenerator()
{if (m_painter->isActive()){m_painter->end();}delete m_painter;delete m_writer;
}void PdfGenerator::setMargins(qreal left, qreal top, qreal right, qreal bottom)
{m_writer->setPageMargins(QMarginsF(left, top, right, bottom), QPageLayout::Millimeter);m_pageRect = m_writer->pageLayout().paintRectPixels(m_writer->resolution()); // 更新绘制区域[5]()
}void PdfGenerator::newPage()
{// 创建新页m_writer->newPage();
}bool PdfGenerator::beginPage(){bool bRet = false;if(nullptr == m_painter){m_painter = new QPainter(m_writer);}//启用抗锯齿m_painter->setRenderHint(QPainter::Antialiasing);if (nullptr != m_painter){m_painter->begin(m_writer);//m_painter->reset(new  QPainter(m_writer.data()));bRet = m_painter->isActive();}qDebug() << "beginPage bRet is " << bRet;return bRet;
}bool PdfGenerator::endPage() {if (m_painter && m_painter->isActive()){m_painter->end();m_writer->deleteLater();m_pdfFile.close();return true;}m_pdfFile.close();return false;
}// 绘制线段 
void PdfGenerator::drawLine(const QPointF &start, const QPointF &end, const QColor &color, qreal width)
{if (!m_painter->isActive())return;m_painter->save();m_painter->setPen(QPen(color, width));m_painter->drawLine(start, end);m_painter->restore();
}// 绘制文本（支持对齐）
void PdfGenerator::drawText(const QRectF &rect, const QString &text, const QFont &font, const QColor &color, Qt::Alignment align)
{if (!m_painter->isActive()) return;m_painter->save();m_painter->setFont(font);m_painter->setPen(color);m_painter->drawText(rect, static_cast<int>(align), text);m_painter->restore();
}// 绘制图片（自动缩放）
void PdfGenerator::drawImage(const QRectF &rect, const QString &imagePath, bool keepAspectRatio)
{if (!m_painter->isActive())return;QPixmap pixmap(imagePath);if (pixmap.isNull())  return;QRectF targetRect = rect;if (keepAspectRatio) {QSizeF scaled = pixmap.size().scaled(rect.size().toSize(),  Qt::KeepAspectRatio);targetRect.setSize(scaled); }m_painter->drawPixmap(targetRect, pixmap, pixmap.rect()); 
}// 绘制矩形（支持填充）
void PdfGenerator::drawRect(const QRectF &rect, const QColor &fillColor, const QColor &borderColor, qreal borderWidth)
{if (!m_painter->isActive())return;m_painter->save();m_painter->setBrush(QBrush(fillColor));m_painter->setPen(QPen(borderColor, borderWidth));m_painter->drawRect(rect);m_painter->restore();
}// 绘制椭圆 
void PdfGenerator::drawEllipse(const QRectF &rect, const QColor &fillColor, const QColor &borderColor, qreal borderWidth)
{if (!m_painter->isActive()) return;m_painter->save();m_painter->setBrush(QBrush(fillColor));m_painter->setPen(QPen(borderColor, borderWidth));m_painter->drawEllipse(rect);m_painter->restore();
}

主程序按钮调用PdfGenerator类绘制PDF

//创建Pdf
void MainWindow::on_btCreatePdf_clicked()
{qDebug() << "into on_btCreatePdf_clicked";PdfGenerator doc("E:/test/output.pdf");if (doc.beginPage()){qDebug() << "beginPage success";// 绘制灰色线段doc.drawLine(QPointF(20,  60), QPointF(150, 200), Qt::lightGray, 2.0);// 添加图片（保持比例），例子的资源里没有添加这张图片，所以下面PDF里没有绘制出来图片doc.drawImage(QRectF(100,  100, 100, 100), "logo.png", false);// 绘制蓝色文字QFont font("Arial", 12, QFont::Bold);doc.drawText(QRectF(70,  270, 270, 50), "Hello PDF!", font, Qt::blue, Qt::AlignVCenter | Qt::AlignHCenter);// 绘制绿色填充矩形doc.drawRect(QRectF(300,  150, 100, 40), Qt::green, Qt::black, 1.5);// 绘制黄色边框椭圆doc.drawEllipse(QRectF(250,  200, 100, 80), Qt::transparent, Qt::yellow, 2.0);doc.endPage();}}

执行后，展示结果：
在这里插入图片描述
以此自定义PdfGenerator类作为基础，后续可以根据QPainter类本身带有的各种图形绘制功能，封装你想做的绘制接口，实际项目应用中，就以你封装的接口进行各种布局绘制操作，来完成项目要求。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.rhkb.cn/news/21463.html

如若内容造成侵权/违法违规/事实不符，请联系长河编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

快速上手gdb/cgdb

快速上手gdb/cgdb

Linux调试器-gdb使用 1.背景2.调试原理、技巧命令2.1指令2.2 本质2.3 技巧 1.背景 程序的发布方式有两种&#xff0c;debug模式和release模式 Linux gcc/g出来的二进制程序&#xff0c;默认是release模式 要使用gdb调试&#xff0c;必须在源代码生成二进制程序的时候, 加上 -g…
阅读更多...
linux网络编程(1.5w字+内部程序理解网络)

linux网络编程(1.5w字+内部程序理解网络)

目录 核心大图&#xff1a; 网络字节序 网络字节序与主机字节序 地址转换函数 一、inet_ntoa函数 二、inet_aton函数 三、inet_aton和inet_ntoa的测试 in_addr转字符串的函数: socket编程接口 socket 常见API 1.socket 参数1&#xff1a;int af 参数2&#xff1a;…
阅读更多...
windows环境下用docker搭建php开发环境dnmp

windows环境下用docker搭建php开发环境dnmp

安装WSL WSL即Linux子系统&#xff0c;比虚拟机占用资源少&#xff0c;安装的前提是系统必须是win10以上。 WSL的安装比较简单&#xff0c;网上有很多教程&#xff0c;例如&#xff1a;WSL简介与安装流程&#xff08;Windows 下的 Linux 子系统&#xff09;_wsl安装-CSDN博客&…
阅读更多...
Nginx之rewrite重写功能

Nginx之rewrite重写功能

目录 一、rewrite概述 1、rewrite功能 2、跳转场景 二、标准配置指令 1、rewrite日志记录指令 2、未初始化变量告警日志记录指令 3、rewrite 指令 3.1 正则表达式 三、rewrite模块使用实例 1.基于域名的跳转 2.基于客户端 IP 访问跳转 3.?基于旧域名跳转到新域名后…
阅读更多...
Mybatis(一)

Mybatis(一)

配置文件 必要的用户密码要修改, 还有绿色线的名字要修改成数据库的 配置文件直接cv 创建 复习之前的知识进行分层处理 与前面一一对应, 后面三个发现后面输出是null, 没有一一对应, 后面再解释解决方法 运行发现, 输出正常 idea的测试类 两个注解了解 记得加上这个, 不然无…
阅读更多...
一周学会Flask3 Python Web开发-http响应状态码

一周学会Flask3 Python Web开发-http响应状态码

锋哥原创的Flask3 Python Web开发 Flask3视频教程&#xff1a; 2025版 Flask3 Python web开发 视频教程(无废话版) 玩命更新中~_哔哩哔哩_bilibili 在Flask程序中&#xff0c;客户端发出的请求触发相应的视图函数&#xff0c;获取返回值会作为响应的主体&#xff0c;最后生成…
阅读更多...
七星棋牌源码高阶技术指南：6端互通、200+子游戏玩法深度剖析与企业级搭建实战(完全开源)

七星棋牌源码高阶技术指南：6端互通、200+子游戏玩法深度剖析与企业级搭建实战(完全开源)

在棋牌游戏行业高速发展的今天&#xff0c;如何构建一个具备高并发、强稳定性与多功能支持的棋牌游戏系统成为众多开发者和运营团队关注的焦点。七星棋牌全开源修复版源码 凭借其 六端互通、200子游戏玩法、多省区本地化支持&#xff0c;以及 乐豆系统、防沉迷、比赛场、AI智能…
阅读更多...
C++和OpenGL实现3D游戏编程【总览】

C++和OpenGL实现3D游戏编程【总览】

欢迎来到zhooyu的游戏专栏。 主页网址&#xff1a;【zhooyu】 专栏网址&#xff1a;【C和OpenGL实现3D游戏编程】 &#x1f31f;&#x1f31f;&#x1f31f;这里将通过一个OpenGL实现3D游戏编程实例教程&#xff0c;带大家深入学习OpenGL知识。知识无穷而人力有穷&#xff0c;…
阅读更多...
pycharm社区版有个window和arm64版本，到底下载哪一个？还有pycharm官网

pycharm社区版有个window和arm64版本，到底下载哪一个？还有pycharm官网

首先pycharm官网是这一个。我是在2025年2月16日9:57进入的网站。如果网站还没有更新的话&#xff0c;那么就往下滑一下找到 community Edition,这个就是社区版了免费的。PyCharm&#xff1a;适用于数据科学和 Web 开发的 Python IDE 适用于数据科学和 Web 开发的 Python IDE&am…
阅读更多...
GPT-Sovits：语音克隆训练-遇坑解决

GPT-Sovits：语音克隆训练-遇坑解决

前言 本来以为3050完全无法执行GPT-Sovits训练的&#xff0c;但经过实践发现其实是可以&#xff0c;并且仅花费了十数分钟便成功训练和推理验证了自己的语音模型。 官方笔记&#xff1a;GPT-SoVITS指南 语雀 项目地址&#xff1a;https://github.com/RVC-Boss/GPT-SoVITS 本人…
阅读更多...
8 SpringBootWeb案例（上）： 查询【分页功能（分页插件）】、删除、新增、修改

8 SpringBootWeb案例（上）： 查询【分页功能（分页插件）】、删除、新增、修改

文章目录 前言：SpringBootWeb案例1. 准备工作1.1 需求&环境搭建1.1.1 需求说明1.1.2 环境搭建1.2 开发规范1.2.1 开发规范-REST（不强求非要这种风格，传统风格有时候更方便）1.2.2 开发规范-统一响应结果和异常处理1.2.3 开发流程2. 部门管理2.1 查询部门2.1.1 原型和需求…
阅读更多...
深入了解 DevOps 基础架构：可追溯性的关键作用

深入了解 DevOps 基础架构：可追溯性的关键作用

在当今竞争激烈的软件环境中&#xff0c;快速交付强大的应用程序至关重要。尽管如此&#xff0c;在不影响质量的情况下保持速度可能是一项艰巨的任务&#xff0c;这就是 DevOps 中的可追溯性发挥作用的地方。通过提供软件开发生命周期 &#xff08;SDLC&#xff09; 的透明视图…
阅读更多...
用C++ Qt实现安卓电池充电动效 | 打造工业级电量控件

用C++ Qt实现安卓电池充电动效 | 打造工业级电量控件

一、为什么需要自定义电池控件&#xff1f; 在工业控制、车机系统、智能硬件等领域的UI开发中&#xff0c;电池状态显示是高频出现的UI组件。通过实现一个支持颜色渐变、动态充电动画、警戒阈值提示的电池控件&#xff0c;开发者可以系统掌握以下核心能力&#xff1a; Qt绘图…
阅读更多...
一批起飞猪名单配图

一批起飞猪名单配图

好久没有使用风口猪选股指标了&#xff0c;今天去玩了一把&#xff0c;发现起飞猪指标显示了好多一批猪票 华曙高科 汉威科技 双林股份 曼恩斯特 长盈精密 江苏雷利 双飞集团 奥飞数据 硅宝科技 水晶光电 长盈精密
阅读更多...
机器学习笔记——常用损失函数

机器学习笔记——常用损失函数

大家好&#xff0c;这里是好评笔记&#xff0c;公主号&#xff1a;Goodnote&#xff0c;专栏文章私信限时Free。本笔记介绍机器学习中常见的损失函数和代价函数&#xff0c;各函数的使用场景。 热门专栏 机器学习 机器学习笔记合集 深度学习 深度学习笔记合集 文章目录 热门…
阅读更多...
Ubuntu 服务器Llama Factory 搭建DeepSeek-R1微调训练环境

Ubuntu 服务器Llama Factory 搭建DeepSeek-R1微调训练环境

1.首先了解一下什么是LLM微调 LLM 微调指的是在已经预训练好的大型语言模型基础上&#xff0c;使用特定的任务数据或领域数据&#xff0c;通过进一步的训练来调整模型的参数&#xff0c;使其在特定任务或领域上能够表现得更好。简单来说&#xff0c;就是对一个已经具备了丰富语…
阅读更多...
环境变量与本地变量

环境变量与本地变量

目录 本地变量的创建 环境变量VS本地变量 认识完了环境变量我们来认识一下本地变量。 本地变量的创建 我们如果直接env是看不到本地变量的&#xff0c;因为本地变量和环境变量都具有独立性&#xff0c;环境变量是系统提供的具有全局属性的变量&#xff0c;都存在bash进程的…
阅读更多...
智慧农业新生态 | 农业数字化服务平台——让土地生金，让服务无忧

智慧农业新生态 | 农业数字化服务平台——让土地生金，让服务无忧

一部手机管农事&#xff0c;从播种到丰收&#xff0c;全链路数字化赋能&#xff01; 面向农户、农机手、农服商、农资商打造的一站式农业产业互联网平台&#xff0c;打通农资交易、农机调度、农服管理、技术指导全场景闭环&#xff0c;助力乡村振兴提效增收。 三大核心场景&am…
阅读更多...
【运维自动化-作业平台】如何创建执行方案和作业模板

【运维自动化-作业平台】如何创建执行方案和作业模板

蓝鲸智云作业平台&#xff0c;以下简称作业平台或JOB平台作业模板和执行方案&#xff1a;将运维操作场景中涉及到的多个脚本执行或文件分发步骤组合成一个作业模板&#xff0c;这个作业模板尽可能把场景相关的共性逻辑都包含进去&#xff0c;然后再根据实际使用场景衍生出相应的…
阅读更多...
广度优先搜索--之重生之我是蒟蒻,从入坟到入坑式讲解

广度优先搜索--之重生之我是蒟蒻,从入坟到入坑式讲解

广度优先搜索 1.什么是广度优先搜索? 广度优先搜索&#xff08;Breadth-First Search&#xff0c;简称BFS&#xff09;是一种遍历或搜索树和图的算法&#xff0c;也称为宽度优先搜索&#xff0c;BFS算法从图的某个节点开始&#xff0c;依次对其所有相邻节点进行探索和遍历&am…
阅读更多...
最新文章
推荐文章

Copyright @ 2022~2023