关于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__18">一、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:
#word">include "mainwindow.h"
// #include "ui_mainwindow.h"#word">include <QFileDialog>
#word">include <QDebug>
#word">include <QMessageBox>MainWindow::MainWindow(QWidget *parent): QMainWindow(parent)// , ui(new Ui::MainWindow)
{// ui->setupUi(this);// 初始化 UIword">auto *centralWidget = word">new QWidget(word">this);word">auto *mainLayout = word">new QVBoxLayout;mainLayout->setContentsMargins(10, 10, 10, 10); // 设置布局边距mainLayout->setSpacing(10); // 设置控件之间的间距// setMinimumSize(600, 520); // 设置窗口最小宽度为600,高度为400// 模板文件选择word">auto *templateLayout = word">new QHBoxLayout;word">auto *templateLabel = word">new QLabel("打开模板:", word">this);templatePathEdit = word">new QLineEdit(word">this);word">auto *browseTemplateButton = word">new QPushButton("浏览", word">this);templateLayout->addWidget(templateLabel);templateLayout->addWidget(templatePathEdit);templateLayout->addWidget(browseTemplateButton);connect(browseTemplateButton, &QPushButton::clicked, word">this, &MainWindow::browseTemplateFile);// 输出文件选择word">auto *outputLayout = word">new QHBoxLayout;word">auto *outputLabel = word">new QLabel("输出路径:", word">this);outputPathEdit = word">new QLineEdit(word">this);word">auto *browseOutputButton = word">new QPushButton("浏览", word">this);outputLayout->addWidget(outputLabel);outputLayout->addWidget(outputPathEdit);outputLayout->addWidget(browseOutputButton);connect(browseOutputButton, &QPushButton::clicked, word">this, &MainWindow::browseOutputFile);// 键值对表格word">auto *placeholdersLabel = word">new QLabel("键值对替换:", word">this);placeholdersTable = word">new QTableWidget(word">this);placeholdersTable->setColumnCount(2);placeholdersTable->setHorizontalHeaderLabels({"占位符", "替换值"});placeholdersTable->setRowCount(5); // 默认三行// 设置默认值placeholdersTable->setItem(0, 0, word">new QTableWidgetItem("[A]"));placeholdersTable->setItem(0, 1, word">new QTableWidgetItem("柯布"));placeholdersTable->setItem(1, 0, word">new QTableWidgetItem("[B]"));placeholdersTable->setItem(1, 1, word">new QTableWidgetItem("阿瑟"));placeholdersTable->setItem(2, 0, word">new QTableWidgetItem("[C]"));placeholdersTable->setItem(2, 1, word">new QTableWidgetItem("杜拉"));placeholdersTable->setItem(3, 0, word">new QTableWidgetItem("[D]"));placeholdersTable->setItem(3, 1, word">new QTableWidgetItem("伊姆斯"));// 替换按钮replaceButton = word">new QPushButton("执行替换", word">this);connect(replaceButton, &QPushButton::clicked, word">this, &MainWindow::replaceInWord);// 布局整合mainLayout->addLayout(templateLayout);mainLayout->addLayout(outputLayout);mainLayout->addWidget(placeholdersLabel);mainLayout->addWidget(placeholdersTable);mainLayout->addWidget(replaceButton);centralWidget->setLayout(mainLayout);setCentralWidget(centralWidget);setWindowTitle("Word 替换工具");resize(1000, 600); // 初始窗口大小
}MainWindow::~MainWindow()
{// delete ui;
}word">void MainWindow::browseTemplateFile() {QString filePath = QFileDialog::getOpenFileName(word">this, "选择模板文件", QString(), "Word 文件 (*.docx *.doc)");word">if (!filePath.isEmpty()) {templatePathEdit->setText(filePath);wordApp = word">new QAxObject("Word.Application");word">if (wordApp->isNull()) {qDebug() << "Failed to initialize Word.Application.";word">delete wordApp;word">return ;}// 隐藏 Word 窗口wordApp->setProperty("Visible", true);//打开指定文档QAxObject *documents = wordApp->querySubObject("Documents");QAxObject *document = documents->querySubObject("Open(const QString&)", filePath);word">if (document == word">nullptr) {QMessageBox::critical(word">this, "错误", "无法打开 Word 文件!");word">return;}}
}word">void MainWindow::browseOutputFile() {QString filePath = QFileDialog::getSaveFileName(word">this, "选择输出文件", QString(), "Word 文件 (*.docx *.doc)");word">if (!filePath.isEmpty()) {outputPathEdit->setText(filePath);}
}word">void MainWindow::replaceInWord() {QString templatePath = templatePathEdit->text();QString outputPath = outputPathEdit->text();word">if (templatePath.isEmpty() || outputPath.isEmpty()) {QMessageBox::warning(word">this, "错误", "请填写模板路径和输出路径!");word">return;}QMap<QString, QString> placeholders;word">for (word">int row = 0; row < placeholdersTable->rowCount(); ++row) {QString key = placeholdersTable->item(row, 0) ? placeholdersTable->item(row, 0)->text() : QString();QString value = placeholdersTable->item(row, 1) ? placeholdersTable->item(row, 1)->text() : QString();word">if (!key.isEmpty()) {placeholders.insert(key, value);}}word">if (placeholders.isEmpty()) {QMessageBox::warning(word">this, "错误", "请填写至少一个占位符和替换值!");word">return;}word">if (replaceMultiple(templatePath, outputPath, placeholders)) {QMessageBox::information(word">this, "成功", "替换完成!");} word">else {QMessageBox::critical(word">this, "失败", "替换失败!");}
}word">bool MainWindow::replaceMultiple(word">const QString &templatePath, word">const QString &outputPath, word">const QMap<QString, QString> &placeholders) {qDebug() << "Received data:" << placeholders;qDebug() << "Template Path:" << templatePath;qDebug() << "Output Path:" << outputPath;word">if (!QFile::exists(templatePath)) {qDebug() << "Template file does not exist:" << templatePath;word">return false;}qDebug() << "QFile::exists ok" ;// 打开模板文件QAxObject *documents = wordApp->querySubObject("Documents");QAxObject *document = documents->querySubObject("Open(const QString&)", templatePath);// 查找占位符并替换//使用 Find.Execute 查找占位符,使用 TypeText 方法替换为新内容QAxObject *selection = wordApp->querySubObject("Selection");// 获取 Find 对象QAxObject *find = selection->querySubObject("Find");qDebug() << "start placeholde";// 遍历占位符键值对, 替换未成功,则有问题word">for (word">auto it = placeholders.begin(); it != placeholders.end(); ++it) {QString placeholder = it.key();QString newContent = it.value();word">bool isFound = true;//可替换多个,且重复的word">while (isFound) {// 查找目标文本并替换// isFound = find->dynamicCall("Execute(const QString&)", placeholder).toBool();isFound = find->dynamicCall("Execute(QString, bool, bool, bool, bool, bool, bool, int)",placeholder, // 要查找的字符串false, // 区分大小写false, // 完整单词false, // 使用通配符false, // 忽略标点符号false, // 忽略空格true, // 向前查找1).toBool(); // 查找范围:整个文档word">if (isFound) {// 替换文本selection->dynamicCall("TypeText(const QString&)", newContent);}}}qDebug() << "All Find operation succeed!";document->dynamicCall("SaveAs(const QString&)", outputPath);// 关闭文档document->dynamicCall("Close()");wordApp->dynamicCall("Quit()");word">delete wordApp;word">return true;
}
mainwindow.h:
#word">ifndef MAINWINDOW_H
#word">define MAINWINDOW_H#word">include <QMainWindow>
#word">include <QTableWidget>
#word">include <QLineEdit>
#word">include <QPushButton>
#word">include <QVBoxLayout>
#word">include <QHBoxLayout>
#word">include <QLabel>
#word">include <QMap>
#word">include <QAxObject>
#word">include <QAxWidget>QT_BEGIN_NAMESPACE
word">namespace Ui {
word">class MainWindow;
}
QT_END_NAMESPACEword">class MainWindow : word">public QMainWindow
{Q_OBJECTword">public:MainWindow(QWidget *parent = word">nullptr);~MainWindow();word">private slots:word">void browseTemplateFile();word">void browseOutputFile();word">void replaceInWord();word">private:QLineEdit *templatePathEdit;QLineEdit *outputPathEdit;QTableWidget *placeholdersTable;QPushButton *replaceButton;word">bool replaceMultiple(word">const QString &templatePath, word">const QString &outputPath, word">const QMap<QString, QString> &placeholders);QAxObject *wordApp = word">nullptr;QAxWidget *wordPreview = word">nullptr;word">private:Ui::MainWindow *ui;
};
#word">endif // MAINWINDOW_H
pro 中需要增加对 QAxObject 的支持
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