Qt无框窗口最大化后拖动恢复位置异常问题求解

问题根源 #

原代码仅在窗口最大化时记录了鼠标相对于窗口的位置，但恢复窗口时，窗口的初始位置与最大化前一致，此时鼠标的全局位置和窗口恢复后的位置不匹配，直接沿用旧的相对位置计算移动会导致窗口位置跳动。

修复方案 #

需要记录最大化前窗口的完整几何信息（位置+大小），同时在拖动恢复时，根据当前鼠标的全局位置和最大化前鼠标相对窗口的位置，重新计算窗口的初始位置，确保拖动时坐标匹配。

修改步骤 #

1. 添加成员变量存储最大化前的窗口几何：

QRect mWindowGeometryBeforeMaximize;

2. 双击最大化时，同时记录窗口几何和鼠标相对位置：
   修改mouseDoubleClickEvent逻辑：

void mouseDoubleClickEvent(QMouseEvent* event)
{
    if (!titlebar_widget->underMouse() || event->button() != Qt::LeftButton)
        return;

    maximized = !maximized;
    if (maximized)
    {
        mWindowGeometryBeforeMaximize = this->geometry(); // 记录窗口原本的位置和大小
        mLastMousePositionBeforeMaximize = event->pos(); // 记录鼠标相对于窗口的位置
        slot_maximized();
    }
    else
    {
        slot_restored();
    }
}

3. 修复mouseMoveEvent中的恢复拖动逻辑：
   当从最大化状态开始拖动时，先恢复窗口，再根据当前鼠标全局位置和之前的相对位置计算窗口初始位置，保证拖动连贯性：

void mouseMoveEvent(QMouseEvent* event)
{
    if (!titlebar_widget->underMouse())
        return;

    if (maximized && event->buttons().testFlag(Qt::LeftButton) && mMoving)
    {
        slot_restored();
        maximized = false;
        
        // 计算窗口初始位置：鼠标全局位置 - 最大化前鼠标相对窗口的位置
        QPoint globalMousePos = event->globalPos();
        QPoint windowTopLeft = globalMousePos - mLastMousePositionBeforeMaximize;
        this->setGeometry(QRect(windowTopLeft, mWindowGeometryBeforeMaximize.size()));
        
        // 更新当前鼠标相对位置，确保后续拖动正常
        mLastMousePosition = event->pos();
        return;
    }

    if (event->buttons().testFlag(Qt::LeftButton) && mMoving)
        this->move(this->pos() + (event->pos() - mLastMousePosition));
}

完整修改后的类代码 #

class MainWindow: public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = 0);
    ~MainWindow() {};

    QWidget *titlebar_widget;

    bool mMoving;
    bool maximized;

    QPoint mLastMousePosition;
    QPoint mLastMousePositionBeforeMaximize;
    QRect mWindowGeometryBeforeMaximize; // 新增：存储最大化前窗口几何

    void mousePressEvent(QMouseEvent* event) 
    {
        if (!titlebar_widget->underMouse())
            return;

        if (event->button() == Qt::LeftButton) 
        {
            mMoving = true;
            mLastMousePosition = event->pos();
        }
    }

    void mouseMoveEvent(QMouseEvent* event)
    {
        if (!titlebar_widget->underMouse())
            return;

        if (maximized && event->buttons().testFlag(Qt::LeftButton) && mMoving)
        {
            slot_restored();
            maximized = false;
            
            QPoint globalMousePos = event->globalPos();
            QPoint windowTopLeft = globalMousePos - mLastMousePositionBeforeMaximize;
            this->setGeometry(QRect(windowTopLeft, mWindowGeometryBeforeMaximize.size()));
            
            mLastMousePosition = event->pos();
            return;
        }

        if (event->buttons().testFlag(Qt::LeftButton) && mMoving)
            this->move(this->pos() + (event->pos() - mLastMousePosition));
    }

    void mouseReleaseEvent(QMouseEvent* event) 
    {
        if (!titlebar_widget->underMouse())
            return;

        if (event->button() == Qt::LeftButton)
            mMoving = false;
    }

    void mouseDoubleClickEvent(QMouseEvent* event)
    {
        if (!titlebar_widget->underMouse() || event->button() != Qt::LeftButton)
            return;

        maximized = !maximized;
        if (maximized)
        {
            mWindowGeometryBeforeMaximize = this->geometry();
            mLastMousePositionBeforeMaximize = event->pos();
            slot_maximized();
        }
        else
            slot_restored();
    }

    void slot_minimized() { setWindowState(Qt::WindowMinimized); }
    void slot_restored() { setWindowState(Qt::WindowNoState); }
    void slot_maximized() { setWindowState(Qt::WindowMaximized); }

private:
    Ui::MainWindowClass ui;
};

原理说明 #

• 记录最大化前的窗口几何，确保恢复时窗口大小与最大化前一致。
• 拖动恢复时，用当前鼠标全局位置减去最大化前鼠标相对窗口的位置，得到窗口左上角坐标，让窗口直接跟随鼠标当前位置，避免位置跳动。
• 更新mLastMousePosition为当前鼠标相对窗口的位置，保证后续拖动操作的坐标计算连续无断层。

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