0
0

C++(Qt) 和 Word 交互总结(二)

阅读本文大概需要 6 分钟

之前有一篇文章介绍过 C++/Qt 操作 Word的一些方法，虽然能满足一部分使用场景，但是终究是在某些平台上有限制，使用起来还是不方便，所以就有了这边文章

我们知道操作 

  1. Word

其实还有一种方法，那就按照 

  1. OOXML

规范读写即可，

  1. OOXML

是微软 2007之后推出的一套标准，凡是符合这个标准生成的文档都可以正常打开，遗憾的是这方面 

  1. C++

没有可用的库，一是因为本身 

  1. C++

人群少，二是是用 

  1. C++

实现工作量大，所以就只能选择现有成熟的轮子

  1. Python

有非常多的开源库可以使用，其中有一个

  1. Python-docx

库，完美实现了

  1. Word

读写，使用 

  1. C++

调用 

  1. Python

是非常方便的，所以可以间接来实现 

  1. Word

的交互

支持功能：

  • 支持自定义标题，包括样式、字体、对齐方式、标题级别等；
  • 支持插入任意行列表格，表格支持单独设置某个单元格样式，字体、颜色、是否加粗、水平、垂直对齐方式等；
  • 支持合并任意单元格；
  • 支持插入图片，支持相对路径和绝对路径
  • 支持市面上大部分平台，不依赖客户电脑安装的 WPS和Word

下面看测试导出的效果:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fRgkmS1p-1663075645648)
在这里插入图片描述

原理介绍

我们知道 

  1. C/C++/Qt

都是编译型语言，也是是说不能直接从源码运行，而

  1. Python

是解释型语言，不需要经过编译成二进制代码可以直接从源码运行，在运行 

  1. Python

的时候首先经过 

  1. Python

解释器解释，你可以理解成翻译的意思，解释成字节码，然后在一条一条字节码指令开始执行

  1. Python

提供了一些

  1. C

库，我们可以在

  1. C/C++

程序中包含对应头文件、库文件，进而调用函数方法来实现某个功能

调用 

  1. Python

主要流程如下：

  • 初始化Python上下文环境(解释器环境)
  • 导入对应的模块
  • 获取对应函数对象，参数转换，调用函数
  • 解析返回值，结束调用
  • 释放 python解释器
  1. C++

根据实际业务生成对应的

  1. JSON

字符串，然后调用

  1. Python

传递给对应函数，在

  1. Python

函数中解析

  1. JSON

字符串然后生成

  1. Word

内容

整个脚本实现库以及对应 Example 都已经开源，感兴趣的朋友直接访问即可

https://github.com/kevinlq/QtPythonDocx

环境配置

下载并安装好

  1. Python

相关库，确保本地环境没有问题，记得安装好

  1. Python-docx

库。拷贝

  1. Python

相关依赖库到你的项目目录，不如下面这样

  1. QtPythonDocx
  2. |  3rdparty
  3. │  └─Python310
  4. │      ├─include
  5. │      │  ├─cpython
  6. │      │  └─internal
  7. │      └─libs
  8. ├─bin
  9. │  ├─Python310
  10. │  │  ├─DLLs
  11. │  │  └─Lib
  12. |  |─script
  13. │  │  wordOperate.py

关于一些版本事项、以及中间会遇到那些坑，文末有注意事项统一介绍

调用

  1. Python

库

为了做到简洁、通用，我们编写一个脚本调用类，该类和具体的业务无关，只负责传入不同模块、函数、参数调用对应的

  1. Python

函数并能够返回对应的结果，这样后续的调用者就使用的时候和使用普通函数没有区别

为了实现这个目的，目前有几个知识点需要解决：

  • 由于Python数据类型和C++不一样，如果要通用那么就需要进行转换，怎么做到C++一个参数类型匹配Python多个类型？
  • 返回值处理，我们的业务函数返回值可能多种多样，怎么兼容？
  • 编码转换，Python中支持UTF-8，我们程序处理中数据可能包含多种类型，怎么转换

解决了上述问题，基本也就是完成了本次要写的脚本加载类

脚本调用类实现

首先看下类型问题，其实我们这里需要一个万能类型来作为函数入参，那么有这个类型么？有，如果你的编译器支持 

  1. C++17

，那么可以用

  1. std::variant
  1. std::variant<int, double, std::string> inputArg

由于作者本人对 

  1. Qt

比较熟一点，所以本次程序中使用了大量的

  1. Qt

内置数据类型，原理是相通的

  1. KPythonRunScript

类的实现，核心函数如下所示

  1. bool callFun(const char *funcName,
  2.                  const QVariantList &args = QVariantList(),
  3.                  QVariant &returnValue = QVariant(QVariant::Invalid));
  • funcName: python 脚本中对应的函数名字
  • args: 函数入参，根据实际脚本中函数参数个数而定
  • returnValue： 返回值，如果脚本函数有返回值初始化的时候赋予对应类型

实际

  1. Python

脚本中函数的入参个数是不确定的，为了兼容多个调用场景，所以采用了数组作为实际的入参，数组每个元素采用

  1. QVariant

类型，这样就能根据实际传入的类型来判断，在调用

  1. Python

的时候应该转换为什么类型

返回值类型也一样，初始化调用时确定好本次调用的返回值类型，这样在

  1. Python

脚本调用完成后才能把返回值转为我们

  1. C++

实际的返回值

类型转换:

  1. for(int index = 0; index < args.size(); index++)
  2. {
  3.     QVariant arg = args[index];
  4.     switch (arg.type())
  5.     {
  6.     case QVariant::String:
  7.     {
  8.     QByteArray baContent = arg.toString().toLocal8Bit();
  9.     PyTuple_SetItem(pArgsObj, index, Py_BuildValue("s", baContent.constData()));
  10.     }
  11.     break;
  12.     case QVariant::Int:         PyTuple_SetItem(pArgsObj, index, Py_BuildValue("i", arg.toInt()));                                      break;
  13.     case QVariant::Double:      PyTuple_SetItem(pArgsObj, index, Py_BuildValue("d", arg.toDouble()));                                   break;
  14.     case QVariant::LongLong:    PyTuple_SetItem(pArgsObj, index, Py_BuildValue("l", arg.toLongLong()));                                 break;
  15.     case QVariant::Char:        PyTuple_SetItem(pArgsObj, index, Py_BuildValue("b", arg.toChar().toLatin1()));                          break;
  16.     case QVariant::Invalid:     PyTuple_SetItem(pArgsObj, index, Py_BuildValue("()"));                                                  break;
  17.     default: break;
  18.     }
  19. }

这里目前适配了上述几种类型，如果后续不满足继续扩展其它类型即可

  1. Python

脚本对应的函数

  1. defgenerateWord(strContent):#...returnTrue

详细调用

在上述实现的类的基础上，调用其实就变的很简单了，就和我们调用本地某个函数一样，非常轻松

  1. KPythonRunScript *pRunScript = KPythonRunScript::instance("wordOperate");
  2. QVariant returnValue = true;
  3. QVariantList args ={""};bool bResult = pRunScript->callFun("generateWord", args, returnValue);
  4. qDebug()<<"run generateWord result:"<< bResult << returnValue;if(!bResult){
  5.     qWarning()<<"write word fail.....";return;}

可能你注意到程序中使用了单例，为什么使用单例？这是因为单个进程

  1. Python

解释器相关内容初始化一次即可，后续随意调用不用再次初始化，实际验证中也证实了，多次初始化会有一些异常问题(虽然每次用完已经释放了，再次初始化还是会有问题)

这样就实现了一个简单的调用过程，具体

  1. Python

文件中的内容可以看我开源的工程目录中的内容，其实就是把各种操作

  1. Word

方法封装成函数了，扩展了常用的字段

  1. QtPythonDocx/bin/script/wordOperate.py

  1. JSON

格式说明

由于 

  1. Word

内容较多，调用时兼容很多写入场景，因此目前设计使用 

  1. JSON

格式来交互，基本覆盖大部分使用场景，而且支持各种自定义，完全满足日常使用，下面是各个字段的说明

全局配置

  • savePath: 定义了生成的 Word 文档路径，确保该路径有写入权限，否则可能会失败
  • openFile： 导入成功后是否打开该文档
  • line_spacing： 行间距，默认给 1.5倍
  • header： 页眉文本，不需要页眉直接给空即可
  • footer： 页脚文本
  • content：[] 这里是 Word 内容部分，采用数组存储，由于数组有有序的，因此严格按照你的内容顺序依次传入即可
  • fontSize: 全局字体大小
  • fontName: 全局字体名字，设置后后续每个正文、标题、表格等可以不用设置，全局统一

正文

下面是正文内容部分说明

  • type: 标识是那种类型，0:标题,1: 普通文本,2:图片，3：表格，其它类型后续扩展自定义
  • text： 如果是文本或者标题给定内容
  • level： 级别，目前只有标题类型生效
  • bold： 是否加粗
  • italic： 是否倾斜
  • strike: 是否删除线
  • alignment： 对齐方式，主要有这么几种：left, right,center
  • color: 对应文本的颜色
  • height： 行高

插入表格

如果是表格，那么有这些扩展字段

  • columns: 列数
  • rows: 行数
  • height： 行高，所有行设置一样的行高，也可以自定义每行的行高
  • mergeCells： 要合并的单元格数组,比如合并 (0,0)和(0,1)单元格，那么内容如下
  1. {"begin": [0,0], "end": [0,1]}
  • tableCell: 单元格内容，依次填充每个单元格内容即可，每个单元格内容和普通文本类似，下面是一个示例
  1. tableCell": [
  2.                 {"text": "我是第一个单元格,加粗，倾斜,红色", "style": "", "bold": true, "italic": true,"color": "#ff0000","alignment": "center"},
  3.                 {"text": "00和01合并了，02会覆盖01的值，加粗变红,左对齐", "style": "", "bold": true, "italic": false,"color": "#ff0000","alignment": "left"},
  4.                 {"text": "03", "style": "", "bold": false, "italic": false,"color": "#000000","alignment": "center"},
  5.                 {"text": "04", "style": "", "bold": false, "italic": false,"color": "#000000","alignment": "center"},
  6.                 {"text": "05", "style": "", "bold": false, "italic": false,"color": "#000000","alignment": "center"},
  7.                 {"text": "06", "style": "", "bold": false, "italic": false,"color": "#000000","alignment": "center"},
  8.                 {"text": "07", "style": "", "bold": false, "italic": false,"color": "#000000","alignment": "center"},
  9.                 {"text": "08", "style": "", "bold": false, "italic": false,"color": "#000000","alignment": "center"}
  10.             ]

插入图片

图片字段和其它文本字段类似，额外添加图片路径属性即可

  • picture: “./test.png”

注意图片路径支持相对路径和绝对路径，根据自己实际需要传递即可

总结

本次通过

  1. Python

的方式可以很好的支持很多之前出现的异常问题，足以满足我们遇到的各种业务需要导出生成

  1. Word

难题，而且导出速度非常快，实际测试生成 

  1. 10

页左右文档耗时不到 

  1. 2

秒，测试了多台电脑，实际效果都非常理想

注意事项

  • Python版本选择问题，确保你的程序最终要运行的平台，如果要最低要求是Windows7，那么建议选择 Python3.8版本即可，如果无所谓那么选择最新稳定版本即可；
  • Python 注意选择和你程序使用同一个位数，程序编译器使用的是 64 位，那就下载 64 位，32位同理 ;
  • 导出的文档使用 Micor Office 2007之后的任意版本都能打开，WPS也能打开，但是在 2007之前的版本是不支持的。不过目前这种场景较少，如果真的遇到了还是给客户建议升级对应的版本吧

推荐阅读

  • Qt Creator 源码学习笔记01，初识QTC
  • Qt Creator 源码学习笔记02，认识框架结构结构
  • Qt Creator 源码学习笔记03，大型项目如何管理工程
  • Qt Creator 源码学习笔记04，多插件实现原理分析
  • Qt Creator 源码学习笔记 05，菜单栏是怎么实现插件化的？
标签： qt c++ word
本文转载自: https://blog.csdn.net/u013704336/article/details/126842199
版权归原作者 流浪的鹅卵石 所有， 如有侵权，请联系我们删除。
登录后发布评论

“C++(Qt) 和 Word 交互总结(二)”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

网络安全法-网络运行安全

使用selenium/drissionpage时如何阻止chrome自动跳转http到https

docker desktop 里部署的Open WebUI 管理员密码忘记了的处理方法

在ubuntu20.04中搭建onsite比赛运行环境

利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

Kafka学习笔记

【前端】浏览器输入url到页面呈现发生了什么？