Qt Widget如何捕获Windows虚拟桌面切换信号以隐藏QDockWidget

由于Qt本身没有封装Windows虚拟桌面切换的专属事件，你需要结合Windows原生API来实现需求，以下是两种可靠的实现方式：

方案一：通过NativeEvent监听窗口状态+公开API检查桌面归属 #

这种方式依赖Windows公开的IVirtualDesktopManager接口，稳定性高，适合大多数场景：

1. 首先在QDockWidget子类中引入Windows头文件，实现nativeEvent方法捕获系统消息，同时用IVirtualDesktopManager检查当前窗口是否在激活的虚拟桌面上：

#include <Windows.h>
#include <ShObjIdl.h>
#include <QDockWidget>

class PopupDockWidget : public QDockWidget
{
    Q_OBJECT
public:
    explicit PopupDockWidget(QWidget *parent = nullptr) : QDockWidget(parent)
    {
        // 初始化COM环境与虚拟桌面管理器
        CoInitialize(nullptr);
        HRESULT hr = CoCreateInstance(CLSID_VirtualDesktopManager, nullptr, CLSCTX_ALL, IID_PPV_ARGS(&m_desktopManager));
        if (FAILED(hr)) m_desktopManager = nullptr;
    }

    ~PopupDockWidget()
    {
        if (m_desktopManager) m_desktopManager->Release();
        CoUninitialize();
    }

protected:
    bool nativeEvent(const QByteArray &eventType, void *message, long *result) override
    {
        MSG* winMsg = static_cast<MSG*>(message);
        // 监听窗口位置变化/激活状态变化的系统消息
        if (winMsg->message == WM_WINDOWPOSCHANGED || winMsg->message == WM_ACTIVATE)
        {
            if (m_desktopManager)
            {
                BOOL isOnCurrentDesktop = FALSE;
                HRESULT hr = m_desktopManager->IsWindowOnCurrentVirtualDesktop((HWND)winId(), &isOnCurrentDesktop);
                if (SUCCEEDED(hr) && !isOnCurrentDesktop)
                {
                    hide();
                }
            }
        }
        return QDockWidget::nativeEvent(eventType, message, result);
    }

private:
    IVirtualDesktopManager* m_desktopManager = nullptr;
};

2. 编译时需要链接shell32.lib和ole32.lib（在Qt项目文件中添加LIBS += -lshell32 -lole32）。

方案二：注册虚拟桌面切换回调（精准触发） #

如果需要在虚拟桌面切换的瞬间立即触发隐藏，可以通过Windows内部的IVirtualDesktopNotification接口注册切换通知：

1. 先实现虚拟桌面通知的回调类：

#include <Windows.h>
#include <ShObjIdl.h>
#include <functional>

class DesktopSwitchNotification : public IVirtualDesktopNotification
{
public:
    DesktopSwitchNotification(std::function<void()> switchCallback) : m_callback(switchCallback) {}

    // IUnknown接口实现
    HRESULT __stdcall QueryInterface(REFIID riid, void** ppv) override
    {
        if (riid == IID_IUnknown || riid == IID_IVirtualDesktopNotification)
        {
            *ppv = this;
            AddRef();
            return S_OK;
        }
        *ppv = nullptr;
        return E_NOINTERFACE;
    }

    ULONG __stdcall AddRef() override { return InterlockedIncrement(&m_refCount); }
    ULONG __stdcall Release() override
    {
        ULONG count = InterlockedDecrement(&m_refCount);
        if (count == 0) delete this;
        return count;
    }

    // 仅关注切换完成的事件
    HRESULT __stdcall VirtualDesktopSwitchFinished(IVirtualDesktop*, IVirtualDesktop*) override
    {
        if (m_callback) m_callback();
        return S_OK;
    }

    // 其他接口方法默认返回S_OK
    HRESULT __stdcall VirtualDesktopCreated(IVirtualDesktop*) override { return S_OK; }
    HRESULT __stdcall VirtualDesktopDestroyBegin(IVirtualDesktop*, IVirtualDesktop*) override { return S_OK; }
    HRESULT __stdcall VirtualDesktopDestroyFailed(IVirtualDesktop*, IVirtualDesktop*) override { return S_OK; }
    HRESULT __stdcall VirtualDesktopDestroyed(IVirtualDesktop*, IVirtualDesktop*) override { return S_OK; }
    HRESULT __stdcall VirtualDesktopNameChanged(IVirtualDesktop*, LPCWSTR) override { return S_OK; }
    HRESULT __stdcall VirtualDesktopSwitchBegin(IVirtualDesktop*, IVirtualDesktop*) override { return S_OK; }
    HRESULT __stdcall VirtualDesktopSwitchFailed(IVirtualDesktop*, IVirtualDesktop*) override { return S_OK; }

private:
    LONG m_refCount = 0;
    std::function<void()> m_callback;
};

2. 在QDockWidget子类中注册通知并实现检查逻辑：

#include <QDockWidget>

class PopupDockWidget : public QDockWidget
{
    Q_OBJECT
public:
    explicit PopupDockWidget(QWidget *parent = nullptr) : QDockWidget(parent)
    {
        CoInitialize(nullptr);
        // 初始化内部虚拟桌面管理器用于注册通知
        HRESULT hr = CoCreateInstance(CLSID_VirtualDesktopManagerInternal, nullptr, CLSCTX_ALL, IID_PPV_ARGS(&m_internalManager));
        if (SUCCEEDED(hr))
        {
            m_notification = new DesktopSwitchNotification([this](){ checkDesktopAndHide(); });
            m_internalManager->RegisterNotification(m_notification);
        }
        // 初始化公开管理器用于检查桌面归属
        hr = CoCreateInstance(CLSID_VirtualDesktopManager, nullptr, CLSCTX_ALL, IID_PPV_ARGS(&m_desktopManager));
        if (FAILED(hr)) m_desktopManager = nullptr;
    }

    ~PopupDockWidget()
    {
        if (m_internalManager && m_notification) m_internalManager->UnregisterNotification(m_notification);
        if (m_desktopManager) m_desktopManager->Release();
        if (m_internalManager) m_internalManager->Release();
        CoUninitialize();
    }

private:
    void checkDesktopAndHide()
    {
        if (!m_desktopManager) return;
        BOOL isOnCurrent = FALSE;
        HRESULT hr = m_desktopManager->IsWindowOnCurrentVirtualDesktop((HWND)winId(), &isOnCurrent);
        if (SUCCEEDED(hr) && !isOnCurrent) hide();
    }

private:
    IVirtualDesktopManager* m_desktopManager = nullptr;
    IVirtualDesktopManagerInternal* m_internalManager = nullptr;
    DesktopSwitchNotification* m_notification = nullptr;
};

注意事项 #

• 两种方案均为Windows平台专属实现，跨平台场景需要针对Linux/macOS做额外适配；
• 方案二使用的IVirtualDesktopManagerInternal是Windows内部接口，存在版本兼容风险，若追求稳定性优先选择方案一。

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