Qt中如何处理startSystemMove/startSystemResize完成事件及控件异常？

一、捕获startSystemMove/Resize的完成事件 #

调用startSystemMove()或startSystemResize()后，窗口控制权移交系统，Qt原生的mouseReleaseEvent无法触发。可以通过窗口事件过滤器结合平台特定事件或通用定时器检测的方式，捕获移动/调整大小的完成事件：

实现代码 #

#include <QWidget>
#include <QMouseEvent>
#include <QDebug>
#include <QTimer>
#include <QWindow>
#ifdef Q_OS_WIN
#include <QWinEventAct>
#endif

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget* parent = nullptr)
        : QWidget(parent)
    {
        setWindowFlags(Qt::Window | Qt::FramelessWindowHint);
        // 给窗口句柄安装事件过滤器
        if (windowHandle()) {
            windowHandle()->installEventFilter(this);
        }
        // 初始化单触发定时器，用于通用移动完成检测
        m_moveTimer.setSingleShot(true);
        connect(&m_moveTimer, &QTimer::timeout, this, &Widget::onMoveCompleted);
    }
    ~Widget() override = default;

protected:
    void mouseMoveEvent(QMouseEvent* event) override
    {
        if (event->buttons() & Qt::LeftButton) {
            windowHandle()->startSystemMove();
        }
        QWidget::mouseMoveEvent(event);
    }

    void mouseReleaseEvent(QMouseEvent* event) override
    {
        // 系统接管窗口期间此方法不会触发，仅作保留
        qDebug() << "mouse is release";
        QWidget::mouseReleaseEvent(event);
    }

    bool eventFilter(QObject* watched, QEvent* event) override
    {
        if (watched == windowHandle()) {
            // Windows平台：监听WM_EXITSIZEMOVE事件，直接捕获移动/调整结束
#ifdef Q_OS_WIN
            if (event->type() == QEvent::WinEventAct) {
                auto winEvent = static_cast<QWinEventAct*>(event);
                MSG* msg = winEvent->message();
                if (msg->message == WM_EXITSIZEMOVE) {
                    qDebug() << "Move/Resize completed (Windows)";
                    onMoveCompleted();
                }
            }
#endif

            // 通用方案：监听窗口Move事件，用定时器延迟判断移动是否停止
            if (event->type() == QEvent::Move) {
                m_moveTimer.start(100); // 100ms延迟，避免频繁触发
            }
        }
        return QWidget::eventFilter(watched, event);
    }

private slots:
    void onMoveCompleted()
    {
        qDebug() << "Move/Resize completed (generic)";
        // 此处添加移动完成后的自定义逻辑
        // 同步修复控件hover异常
        activateWindow();
        update();
    }

private:
    QTimer m_moveTimer;
};

二、修复移动后按钮Hover失效问题 #

移动后按钮hover不生效，是因为系统接管窗口期间，Qt的事件循环未正确更新控件状态。在移动完成的回调中调用activateWindow()和update()，强制窗口激活并刷新控件即可解决：

测试用main函数 #

#include <QApplication>
#include <QPushButton>

int main(int argc, char* argv[])
{
    QApplication app(argc, argv);

    auto mainWindow = new Widget();
    auto button = new QPushButton("Hover Me", mainWindow);
    button->setStyleSheet("QPushButton:hover{background-color: red;}");
    button->resize(100, 50);
    button->move(50, 50);

    mainWindow->resize(300, 200);
    mainWindow->show();

    return QApplication::exec();
}

关键修复说明 #

在onMoveCompleted()中调用：

• activateWindow()：让窗口重新获取焦点，确保鼠标事件正常传递
• update()：强制刷新所有子控件，恢复hover状态的渲染逻辑

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