关于QT Widget 其它文章请点击这里:     QT Widget

---

今天在使用 Qt 的 moveToThread 实现多线程时，遇到了两个常见的坑，在这里记录一下，供自己和大家参考。

一、继承于QWidget 的控件不能在子线程中运行

Qt 的规定是：所有 UI 操作必须在主线程中执行。因此，QWidget 及其子类只能在主线程中创建和更新，不能移动到子线程中，也不能在子线程中直接操作 UI。

错误示例：

以下代码试图将继承自 QWidget 的 CompWord 移动到子线程：

class CompWorkBase : public QWidget
...
class CompWord :  public CompWorkBase
...
CompWord *_cmp_word = new CompWord(ui->wgt_Work);
QThread* _workerThread = new QThread();
_cmp_word->moveToThread(_workerThread);

运行后报错：

QObject::moveToThread: Cannot move objects with a parent

这是因为 CompWord 继承自 QWidget，而 QWidget 的实例必须在主线程中运行，因此不能将 _cmp_word 移动到子线程。

二、 QAxObject（以及 COM 组件）不能在子线程中实例化

在将 CompWord 的界面与逻辑分离后，又遇到了第二个坑：QAxObject 不能在子线程中实例化。这是由于 COM 的限制，默认情况下，COM 对象的创建和调用必须在主线程中进行。

原因：

COM 对象（如 Microsoft Word 的接口）基于单线程单元（STA，Single-Threaded Apartment）模型。STA 模型要求 COM 对象的创建和使用必须在同一个线程中进行，而该线程通常是 GUI 主线程。

如果在子线程中实例化 QAxObject，会导致 QAxBase::setControl 方法失败。

错误示例：

	...ReportWorker * _reportWorker = new ReportWorker();QThread*  _threadWorker = new QThread();_reportWorker->moveToThread(_threadWorker);// 连接信号槽connect(_threadWorker, &QThread::started, _reportWorker, &ReportWorker::reportInit);     // 线程初始化_threadWorker->start();

子线程的初始化逻辑如下：

void ReportWorker::reportInit() {wordApp = std::make_unique<QAxObject>("Word.Application");
}

运行后报错：

QAxBase::setControl: requested control Word.Application could not be instantiated
Failed to initialize Word.Application.

这说明 COM 对象（如 QAxObject）的实例化必须在主线程完成。

---

关于QT Widget 其它文章请点击这里:     QT Widget