QMdiSubWindow的restoreGeometry()方法行为异常问题排查

问题现象 #

在MDI区域中使用QMdiSubWindow嵌套QDialog作为子窗口，调用saveGeometry()和restoreGeometry()保存恢复窗口位置尺寸时，出现异常行为：

• 首次打开窗口置于(0,0)，关闭后再次打开会偏移到(0, y)，y值近似标题栏高度
• 每次将窗口移至MDI区域顶部附近，恢复时都会自动下移一段距离，其他位置恢复完全正常

测试代码 #

#include <QApplication>
#include <QtWidgets>

int main(int argc,char *argv[]) {
    QApplication app(argc,argv);
    QMainWindow  win;
    QMenu        *mnu;
    QAction      *act;
    QMdiArea     mdi;
    QByteArray   abt;
    mnu=win.menuBar()->addMenu("test");
    act=mnu->addAction("open");
    mnu->addAction(act);
    QObject::connect(
        act,
        &QAction::triggered,
        [&]() {
            if(!mdi.subWindowList().count()) {
                QDialog       dlg;
                QMdiSubWindow *sub=mdi.addSubWindow(&dlg);
                if(abt.isEmpty())
                    sub->resize(200,200);
                else
                    sub->restoreGeometry(abt);
                dlg.exec();
                abt=sub->saveGeometry();
            }
        }
    );
    win.setCentralWidget(&mdi);
    win.show();
    return app.exec();
}

原因解析 #

这个异常是Qt内部窗口布局与可见性校验逻辑导致的：

• QMdiSubWindow的标题栏可见性校验：QMdiSubWindow自带标题栏区域，restoreGeometry()恢复位置时，Qt会自动检查子窗口的客户区（即嵌套的QDialog显示区域）是否会被MDI区域的顶部边界遮挡。当检测到客户区可能被遮挡时，会自动向下偏移窗口位置，确保客户区完全显示在MDI区域内。
• 几何信息的存储与恢复逻辑差异：saveGeometry()保存的是包含标题栏的整个QMdiSubWindow的完整几何数据，但恢复时Qt的布局逻辑优先保证客户区可见，而非严格还原原始位置。当原始位置让标题栏覆盖MDI顶部时，就会触发偏移，偏移距离恰好等于标题栏的高度。
• 模态对话框的额外校验：代码中使用dlg.exec()以模态方式显示对话框，模态窗口的显示逻辑会强制要求窗口完全可见，这会进一步触发Qt的位置调整机制，导致偏移行为更明显。

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