IT评测·应用市场-qidao123.com

标题: Qt WORD/PDF（四）使用 QAxObject 对 Word 替换（QWidget） [打印本页]

---

作者: 泉缘泉    时间: 2024-12-18 20:50
标题: Qt WORD/PDF（四）使用 QAxObject 对 Word 替换（QWidget）

---

关于QT Widget 其它文章请点击这里:     QT Widget
国际站点 GitHub:     https://github.com/chenchuhan
国内站点 Gitee :      https://gitee.com/chuck_chee
姊妹篇:     
Qt WORD/PDF（一）使用 QtPdfium库实现 PDF 操作
Qt WORD/PDF（二）使用 QtPdfium库实现 PDF 预览、打印等
Qt WORD/PDF（三）使用 QAxObject 对 Word 替换（QML）
Qt WORD/PDF（四）使用 QAxObject 对 Word 替换（QWidget）

---

一、QAxObject 简介

QAxObject 是 Qt 提供的一个类，它用于与 COM（Component Object Model）对象举行交互。COM 是一种微软的技术，广泛用于各种应用程序之间的通讯，尤其在 Windows 平台上，很多软件和系统组件都是基于 COM 构建的。QAxObject 类提供了一个 Qt 风格的接口，简化了与这些 COM 对象的交互。
本文紧张使用 QAxObject 操作 word 文档，使用键值对，对模板文件举行替换操作，导出相应的文档，特殊适合输出陈诉。
本文采用 Qt Widget 纯代码的方式
环境：
QT5.15.2 + MSVC2019 + Widget
二、演示

实现功能：

• 用户可以选择一个模板文件，并举行占位符的批量替换。
  
• 用户可以设置替换后文档的保存路径。
  
• 支持通过界面交互实现选择文件、体现信息以及实行替换操作。
  
• 使用 QAxObject 实现了与 Word 的 COM 接口的交互，允许直接操作 Word 文档中的内容。
  

三、代码

完整代码

mainwindow.cpp：

1. #include "mainwindow.h"
2. // #include "ui_mainwindow.h"
4. #include <QFileDialog>
5. #include <QDebug>
6. #include <QMessageBox>
9. MainWindow::MainWindow(QWidget *parent)
10.     : QMainWindow(parent)
11.     // , ui(new Ui::MainWindow)
12. {
13.     // ui->setupUi(this);
14.     // 初始化 UI
15.     auto *centralWidget = new QWidget(this);
16.     auto *mainLayout = new QVBoxLayout;
18.     mainLayout->setContentsMargins(10, 10, 10, 10); // 设置布局边距
19.     mainLayout->setSpacing(10); // 设置控件之间的间距
20.     // setMinimumSize(600, 520); // 设置窗口最小宽度为600，高度为400
22.     // 模板文件选择
23.     auto *templateLayout = new QHBoxLayout;
24.     auto *templateLabel = new QLabel("打开模板:", this);
25.     templatePathEdit = new QLineEdit(this);
26.     auto *browseTemplateButton = new QPushButton("浏览", this);
27.     templateLayout->addWidget(templateLabel);
28.     templateLayout->addWidget(templatePathEdit);
29.     templateLayout->addWidget(browseTemplateButton);
30.     connect(browseTemplateButton, &QPushButton::clicked, this, &MainWindow::browseTemplateFile);
32.     // 输出文件选择
33.     auto *outputLayout = new QHBoxLayout;
34.     auto *outputLabel = new QLabel("输出路径:", this);
35.     outputPathEdit = new QLineEdit(this);
36.     auto *browseOutputButton = new QPushButton("浏览", this);
37.     outputLayout->addWidget(outputLabel);
38.     outputLayout->addWidget(outputPathEdit);
39.     outputLayout->addWidget(browseOutputButton);
40.     connect(browseOutputButton, &QPushButton::clicked, this, &MainWindow::browseOutputFile);
42.     // 键值对表格
43.     auto *placeholdersLabel = new QLabel("键值对替换:", this);
44.     placeholdersTable = new QTableWidget(this);
45.     placeholdersTable->setColumnCount(2);
46.     placeholdersTable->setHorizontalHeaderLabels({"占位符", "替换值"});
47.     placeholdersTable->setRowCount(5); // 默认三行
49.     // 设置默认值
50.     placeholdersTable->setItem(0, 0, new QTableWidgetItem("[A]"));
51.     placeholdersTable->setItem(0, 1, new QTableWidgetItem("柯布"));
53.     placeholdersTable->setItem(1, 0, new QTableWidgetItem("[B]"));
54.     placeholdersTable->setItem(1, 1, new QTableWidgetItem("阿瑟"));
56.     placeholdersTable->setItem(2, 0, new QTableWidgetItem("[C]"));
57.     placeholdersTable->setItem(2, 1, new QTableWidgetItem("杜拉"));
59.     placeholdersTable->setItem(3, 0, new QTableWidgetItem("[D]"));
60.     placeholdersTable->setItem(3, 1, new QTableWidgetItem("伊姆斯"));
62.     // 替换按钮
63.     replaceButton = new QPushButton("执行替换", this);
64.     connect(replaceButton, &QPushButton::clicked, this, &MainWindow::replaceInWord);
67.     // 布局整合
68.     mainLayout->addLayout(templateLayout);
69.     mainLayout->addLayout(outputLayout);
70.     mainLayout->addWidget(placeholdersLabel);
71.     mainLayout->addWidget(placeholdersTable);
72.     mainLayout->addWidget(replaceButton);
74.     centralWidget->setLayout(mainLayout);
75.     setCentralWidget(centralWidget);
76.     setWindowTitle("Word 替换工具");
78.     resize(1000, 600); // 初始窗口大小
79. }
81. MainWindow::~MainWindow()
82. {
83.     // delete ui;
84. }
86. void MainWindow::browseTemplateFile() {
87.     QString filePath = QFileDialog::getOpenFileName(this, "选择模板文件", QString(), "Word 文件 (*.docx *.doc)");
88.     if (!filePath.isEmpty()) {
89.         templatePathEdit->setText(filePath);
91.          wordApp = new QAxObject("Word.Application");
92.         if (wordApp->isNull()) {
93.             qDebug() << "Failed to initialize Word.Application.";
94.             delete wordApp;
95.             return ;
96.         }
98.         // 隐藏 Word 窗口
99.         wordApp->setProperty("Visible", true);
101.         //打开指定文档
102.         QAxObject *documents = wordApp->querySubObject("Documents");
103.         QAxObject *document = documents->querySubObject("Open(const QString&)", filePath);
104.         if (document == nullptr) {
105.             QMessageBox::critical(this, "错误", "无法打开 Word 文件！");
106.             return;
107.         }
108.     }
109. }
111. void MainWindow::browseOutputFile() {
112.     QString filePath = QFileDialog::getSaveFileName(this, "选择输出文件", QString(), "Word 文件 (*.docx *.doc)");
113.     if (!filePath.isEmpty()) {
114.         outputPathEdit->setText(filePath);
115.     }
116. }
118. void MainWindow::replaceInWord() {
119.     QString templatePath = templatePathEdit->text();
120.     QString outputPath = outputPathEdit->text();
122.     if (templatePath.isEmpty() || outputPath.isEmpty()) {
123.         QMessageBox::warning(this, "错误", "请填写模板路径和输出路径！");
124.         return;
125.     }
127.     QMap<QString, QString> placeholders;
128.     for (int row = 0; row < placeholdersTable->rowCount(); ++row) {
129.         QString key = placeholdersTable->item(row, 0) ? placeholdersTable->item(row, 0)->text() : QString();
130.         QString value = placeholdersTable->item(row, 1) ? placeholdersTable->item(row, 1)->text() : QString();
131.         if (!key.isEmpty()) {
132.             placeholders.insert(key, value);
133.         }
134.     }
136.     if (placeholders.isEmpty()) {
137.         QMessageBox::warning(this, "错误", "请填写至少一个占位符和替换值！");
138.         return;
139.     }
141.     if (replaceMultiple(templatePath, outputPath, placeholders)) {
142.         QMessageBox::information(this, "成功", "替换完成！");
143.     } else {
144.         QMessageBox::critical(this, "失败", "替换失败！");
145.     }
146. }
148. bool MainWindow::replaceMultiple(const QString &templatePath, const QString &outputPath, const QMap<QString, QString> &placeholders) {
150.     qDebug() << "Received data:" << placeholders;
153.     qDebug() << "Template Path:" << templatePath;
154.     qDebug() << "Output Path:" << outputPath;
156.     if (!QFile::exists(templatePath)) {
157.         qDebug() << "Template file does not exist:" << templatePath;
158.         return false;
159.     }
160.     qDebug() << "QFile::exists ok" ;
161.    
162.     // 打开模板文件
163.     QAxObject *documents = wordApp->querySubObject("Documents");
164.     QAxObject *document = documents->querySubObject("Open(const QString&)", templatePath);
166.     // 查找占位符并替换
167.     //使用 Find.Execute 查找占位符，使用 TypeText 方法替换为新内容
168.     QAxObject *selection = wordApp->querySubObject("Selection");
170.     // 获取 Find 对象
171.     QAxObject *find = selection->querySubObject("Find");
173.     qDebug() << "start placeholde";
175.     // 遍历占位符键值对, 替换未成功，则有问题
176.     for (auto it = placeholders.begin(); it != placeholders.end(); ++it) {
177.         QString placeholder = it.key();
178.         QString newContent = it.value();
180.         bool isFound = true;
182.         //可替换多个，且重复的
183.         while (isFound) {
184.             // 查找目标文本并替换
185.             //            isFound = find->dynamicCall("Execute(const QString&)", placeholder).toBool();
186.             isFound = find->dynamicCall("Execute(QString, bool, bool, bool, bool, bool, bool, int)",
187.                                         placeholder,  // 要查找的字符串
188.                                         false,        // 区分大小写
189.                                         false,        // 完整单词
190.                                         false,        // 使用通配符
191.                                         false,        // 忽略标点符号
192.                                         false,        // 忽略空格
193.                                         true,         // 向前查找
194.                                         1).toBool();   // 查找范围：整个文档
196.             if (isFound) {
197.                 // 替换文本
198.                 selection->dynamicCall("TypeText(const QString&)", newContent);
199.             }
200.         }
201.     }
203.     qDebug() << "All Find operation succeed!";
205.     document->dynamicCall("SaveAs(const QString&)", outputPath);
207.     // 关闭文档
208.     document->dynamicCall("Close()");
209.     wordApp->dynamicCall("Quit()");
210.     delete wordApp;
212.     return true;
213. }

复制代码

mainwindow.h：

1. #ifndef MAINWINDOW_H
2. #define MAINWINDOW_H
4. #include <QMainWindow>
5. #include <QTableWidget>
6. #include <QLineEdit>
7. #include <QPushButton>
8. #include <QVBoxLayout>
9. #include <QHBoxLayout>
10. #include <QLabel>
11. #include <QMap>
12. #include <QAxObject>
13. #include <QAxWidget>
15. QT_BEGIN_NAMESPACE
16. namespace Ui {
17. class MainWindow;
18. }
19. QT_END_NAMESPACE
21. class MainWindow : public QMainWindow
22. {
23.     Q_OBJECT
25. public:
26.     MainWindow(QWidget *parent = nullptr);
27.     ~MainWindow();
29. private slots:
30.     void browseTemplateFile();
31.     void browseOutputFile();
32.     void replaceInWord();
34. private:
35.     QLineEdit *templatePathEdit;
36.     QLineEdit *outputPathEdit;
37.     QTableWidget *placeholdersTable;
38.     QPushButton *replaceButton;
39.     bool replaceMultiple(const QString &templatePath, const QString &outputPath, const QMap<QString, QString> &placeholders);
40.     QAxObject *wordApp = nullptr;
41.     QAxWidget *wordPreview = nullptr;
43. private:
44.     Ui::MainWindow *ui;
45. };
46. #endif // MAINWINDOW_H

复制代码

pro 中需要增加对 QAxObject 的支持

1. QT       += core gui axcontainer

复制代码

四、分析：

这段Qt C++代码实现了一个简朴的“Word 文件替换工具”，允许用户通过一个图形界面选择Word模板文件、设置输出路径，并在Word文档中举行占位符的替换操作。
1. 类的构造函数 (MainWindow::MainWindow)

• UI设置：
  
  
  
  • 使用 QWidget 创建中央窗口，QVBoxLayout 为主布局，内部包含多个控件（如标签、输入框、按钮等）。
    
  • 通过 QHBoxLayout 设置了模板文件选择地区（输入框和浏览按钮）、输出路径选择地区（输入框和浏览按钮）、以及键值对表格用于占位符替换。
    
  • 还创建了一个 QTableWidget 来管理占位符和替换值的键值对。初始化了5行默认数据。
    
  
  
• 控件毗连：
  
  
  
  • 点击“浏览”按钮会触发文件选择对话框，并通过信号槽机制毗连相应的函数（browseTemplateFile 和 browseOutputFile）。
    
  • 替换按钮 (replaceButton) 毗连到 replaceInWord 函数。
    
  
  
• Word预览：
  
  
  
  • wordPreview 是一个 QAxWidget 控件，允许通过 ActiveX 技术与 Word 应用举行交互。它在 browseTemplateFile 中初始化并用于打开 Word 文件。
    
  
  

2. 浏览模板文件 (​​browseTemplateFile​​ )

• 打开文件对话框 (QFileDialog::getOpenFileName) 选择模板文件，文件路径体现在 templatePathEdit 中。
  
• 使用 QAxWidget 来查询 Word 的应用对象 wordApp，并打开用户选择的文件。
  
• 通过 Word.Application 创建 ActiveX 对象，加载模板文件并将其体现在打印预览模式。
  
• 如果没有成功加载Word文件，会弹出错误提示。
  

3. 浏览输出文件 (​​browseOutputFile​​ )

• 打开保存文件对话框 (QFileDialog::getSaveFileName) 选择输出文件路径，并将路径体现在 outputPathEdit 中。
  

4. 替换操作 (​​replaceInWord​​ )

• 从 UI 中获取模板文件路径和输出文件路径，如果路径为空，弹出警告。
  
• 获取表格中的占位符及其对应替换值，并构建一个 QMap 来存储这些键值对。
  
• 调用 replaceMultiple 函数举行批量替换操作。
  

5. 替换逻辑 (​​replaceMultiple​​ )

• 文件存在性检查： 使用 QFile::exists 检查模板文件是否存在。
  
• 打开Word文档： 使用 QAxObject 打开模板文件，获取 Selection 对象和 Find 对象来查找占位符。
  
• 查找和替换： 遍历占位符的键值对，使用 Find.Execute 查找占位符，并通过 TypeText 替换为新内容。替换过程中使用了 while 循环，确保文档中全部的占位符都能被替换（即使它们重复出现）。
  
• 保存文件： 替换完成后，使用 SaveAs 保存文件到指定的输出路径。
  
• 关闭和退出： 完成替换后，关闭文档并退出Word应用。
  

总结

该程序使用 Qt 的 QAxObject 来与 Microsoft Word 举行交互，实现了以下功能：

• 用户可以选择一个模板文件，并举行占位符的批量替换。
  
• 用户可以设置替换后文档的保存路径。
  
• 支持通过界面交互实现选择文件、体现信息以及实行替换操作。
  
• 使用 QAxObject 实现了与 Word 的 COM 接口的交互，允许直接操作 Word 文档中的内容。
  

---

关于QGC地面站其它文章请点击这里:     QT Widget

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 IT评测·应用市场-qidao123.com (https://dis.qidao123.com/)

Powered by Discuz! X3.4