如何避免QAxWidget抢占客户端焦点及GUI变更致调用方失焦？

这个问题我在做嵌入COM控件的Qt项目时深有体会——QAxWidget里的COM对象总是会偷偷把焦点从主窗口抢走，尤其是调用那些修改GUI的方法时，主窗口突然失焦的体验真的很差。下面几个方案都是我亲测有效的，你可以根据自己的场景选择：

1. 设置Windows窗口扩展样式WS_EX_NOACTIVATE #

这是最直接的方案，通过修改QAxWidget对应的原生窗口属性，阻止它被激活从而抢占焦点。代码如下：

// 在QAxWidget初始化完成后调用
HWND axNativeHandle = reinterpret_cast<HWND>(ui->axWidget->winId());
LONG existingExStyle = GetWindowLong(axNativeHandle, GWL_EXSTYLE);
// 添加WS_EX_NOACTIVATE标志
SetWindowLong(axNativeHandle, GWL_EXSTYLE, existingExStyle | WS_EX_NOACTIVATE);

WS_EX_NOACTIVATE会让这个窗口永远不会成为激活窗口，不管是点击它还是内部操作触发，焦点都会一直保留在原来的主窗口上。

2. 用队列调用方式执行GUI修改函数 #

同步调用COM对象的GUI方法时，COM会立即处理并激活自身窗口，改用Qt的队列连接方式延迟执行，能避免这种即时的焦点抢夺：

// 不要直接同步调用：ui->axWidget->dynamicCall("UpdateUI()");
// 改用队列连接，让调用进入事件循环后再执行
QMetaObject::invokeMethod(ui->axWidget, "dynamicCall", Qt::QueuedConnection,
                          Q_ARG(QString, "UpdateUI()"));

这样当前的事件处理流程不会被打断，等主窗口的事件处理完再执行COM的GUI操作，焦点就不会被突然抢走。

3. 拦截QAxWidget的焦点事件 #

自定义一个继承自QAxWidget的子类，重写焦点进入事件，强制把焦点还给主窗口：

class NonFocusAxWidget : public QAxWidget
{
protected:
    void focusInEvent(QFocusEvent* event) override
    {
        // 优先把焦点转回主窗口
        if (QWidget* mainWin = window()) {
            mainWin->setFocus();
        }
        // 如果不需要QAxWidget处理焦点，也可以忽略事件
        // event->ignore();
    }
};

之后用这个子类代替原生的QAxWidget，就能拦截所有试图抢占焦点的操作。

4. 设置COM对象的OLEMISC_NOACTIVATEACTIVATE标志 #

从COM层面入手，告诉控件不要激活自身窗口。在初始化QAxWidget的控件后设置misc标志：

ui->axWidget->setControl("{你的COM控件CLSID或ProgID}");
// 获取当前的misc标志并添加NOACTIVATEACTIVATE
DWORD currentMisc = ui->axWidget->miscFlags();
ui->axWidget->setMiscFlags(currentMisc | OLEMISC_NOACTIVATEACTIVATE);

这个标志是COM规范里的，直接阻止控件激活窗口，属于从根源上解决问题的方案。

总结 #

优先推荐方案1和4，这两个是从底层窗口属性和COM控件本身的设置出发，效果最稳定。如果遇到特殊场景（比如某些顽固的COM控件），可以搭配方案2或3一起使用。

内容的提问来源于stack exchange，提问作者jaba