使用 QAxObject 进行 Word 文档生成：基于子线程的导出任务
在使用 Qt 开发应用时，有时需要生成 Word 文档。在这篇文章中，我们将讨论如何通过子线程使用 QAxObject 生成 Word 文档。以下代码演示了如何在子线程中处理文档导出任务。
成品演示
代码结构
首先，我们有一个 ExportTask 类，继承自 QObject，并且包含了以下功能：
- 初始化：将
QVariantMap数据作为参数传递给构造函数。 - 文档处理：在
process()函数中创建和编辑 Word 文档。 - 书签替换：
replaceBookmarkText()函数用于替换文档中的书签文本。 - 表格行添加：
addRowToTable()函数用于在指定的表格中添加行。 - 合并单元格：
MergeCells()函数用于合并表格中的单元格。 - 合并相同值单元格：
mergeSameRefResCells()函数用于合并相同值的单元格。
关键部分分析
1. 构造函数与 QVariantMap 数据
ExportTask::ExportTask(const QVariantMap& data) : data(data) {}
这个构造函数接受一个 QVariantMap，它包含了所需的所有数据。确保传递的 QVariantMap 包含所有必要的键和值。
2. process() 函数：文档处理的核心
void ExportTask::process() {
CoInitialize(NULL);
QAxObject* word = new QAxObject("Word.Application");
word->setProperty("Visible", false);
QAxObject *documents = word->querySubObject("Documents");
documents->dynamicCall("Add(QString)", data["templatePath"].toString());
QAxObject *document = word->querySubObject("ActiveDocument");
// 替换书签文本
replaceBookmarkText(document, "lineEdit1", data["lineEdit1"].toString());
replaceBookmarkText(document, "reportNum", data["reportNum"].toString());
// ...
// 添加表格行
QAxObject* table = document->querySubObject("Tables(int)", 2);
QAxObject* rows = table->querySubObject("Rows");
foreach (const QVariant& row, data["tableRows"].toList()) {
addRowToTable(rows, row.toMap());
}
// 清理对象
delete rows;
delete table;
// 创建和填充新的表格
// ...
// 合并相同值的单元格
mergeSameRefResCells(newTable, data["measurements"].toList());
// 保存文档
QString tempPath = QDir::tempPath() + "/TempDoc_" + timestamp + ".docx";
document->dynamicCall("SaveAs(const QString&)", QDir::toNativeSeparators(tempPath));
document->dynamicCall("Close (boolean)", false);
word->dynamicCall("Quit()");
emit finished(timestamp, tempPath);
CoUninitialize();
}
注意点：
- CoInitialize：调用
CoInitialize(NULL)进行 COM 初始化，并在最后调用CoUninitialize()进行清理。 - QAxObject：用于操控 Word 应用程序和文档。需要创建 Word 实例，加载模板文档，编辑文档内容，并最终保存文档。
- 动态调用方法：使用
dynamicCall动态调用 Word 方法，如Add,SaveAs,Close等。
3. replaceBookmarkText() 函数：书签文本替换
void ExportTask::replaceBookmarkText(QAxObject* document, const QString &bookmarkName, const QString &text) {
QAxObject *bookmark = document->querySubObject("Bookmarks(QVariant)", bookmarkName);
if (!bookmark->isNull()) {
bookmark->dynamicCall("Select(void)");
QAxObject *range = bookmark->querySubObject("Range");
range->setProperty("Text", text);
// 设置字体样式
QAxObject *font = range->querySubObject("Font");
font->setProperty("Name", "宋体");
font->setProperty("Size", 9);
font->setProperty("Bold", false);
delete font;
delete range;
}
delete bookmark;
}
注意点：
- 检查书签是否存在：通过
isNull检查书签是否存在。 - 设置字体样式：可以自定义书签文本的字体和样式。
4. addRowToTable() 函数：表格行添加
void ExportTask::addRowToTable(QAxObject* rows, const QVariantMap& rowData) {
QAxObject* row = rows->querySubObject("Add()");
if (row) {
QAxObject* cell1 = row->querySubObject("Cells(int)", 1);
if (cell1) {
cell1->querySubObject("Range")->setProperty("Text", rowData["checkBoxText"].toString());
cell1->querySubObject("Range")->setProperty("Style", "...");
delete cell1;
}
delete row;
}
}
注意点：
- 检查行和单元格是否存在：确保
row对象存在再添加数据。 - 设置单元格属性：可以为单元格设置文本和样式。
5. MergeCells() 函数：单元格合并
void ExportTask::MergeCells(QAxObject *table, int nStartRow, int nStartCol, int nEndRow, int nEndCol) {
QAxObject* StartCell = table->querySubObject("Cell(int, int)", nStartRow, nStartCol);
QAxObject* EndCell = table->querySubObject("Cell(int, int)", nEndRow, nEndCol);
StartCell->dynamicCall("Merge(LPDISPATCH)", EndCell->asVariant());
}
注意点：
- 合并单元格：通过
dynamicCall("Merge")合并单元格。 - 设置合并后单元格样式：可以设置合并后的单元格样式，如对齐方式和字体。
6. mergeSameRefResCells() 函数：合并某一列连续相同值的单元格
void ExportTask::mergeSameRefResCells(QAxObject* table, const QVariantList& measurements) {
QString prevRefRes;
int startRow = 2;
int currentRow = 2;
foreach (const QVariant& measurementVariant, measurements) {
QVariantMap measurement = measurementVariant.toMap();
QString currentRefRes = measurement["refRes"].toString();
if (currentRefRes == prevRefRes) {
QAxObject* currentCell = table->querySubObject("Cell(int, int)", currentRow, 2);
QAxObject* currentRange = currentCell->querySubObject("Range");
currentRange->setProperty("Text", "");
delete currentRange;
delete currentCell;
currentRow++;
} else {
if (startRow < currentRow) {
MergeCells(table, startRow, 2, currentRow - 1, 2);
}
startRow = currentRow;
currentRow++;
}
prevRefRes = currentRefRes;
}
if (startRow < currentRow) {
MergeCells(table, startRow, 2, currentRow - 1, 2);
}
}
注意点：
- 遍历测量数据：通过遍历测量数据找到相同值的单元格。
- 条件合并：如果发现相同值，将这些单元格合并。
注意事项
QAxBase: Error calling IDispatch member Add: Exception thrown by server
QAxBase::dynamicCallHelper: Object does not support automation
...
如果遇到以上错误，请尝试执行以下操作：
QAxObject在多线程中的初始化及调用代码必须放在同一个线程中。- 不能在子线程中使用
QAxWidget,QAxWidget继承至QWidget类，不能在子线程中执行有关主线程的UI界面的操作。 - 在操作模板时，有些格式会影响
QAxObject的正常使用，如合并单元格时，需要原始表格含有边框，否则会报错。
总结
通过子线程和 QAxObject 生成 Word 文档，能够提高应用的响应速度，并避免阻塞主线程。在实际应用中，注意处理异常情况，并确保所有 QAxObject 对象在使用后适时删除，以避免资源泄漏。