Windows下显示DPI缩放变更时如何自动调整运行中Qt GUI控件尺寸

这个问题在Qt社区有过相关讨论，但一直没有给出完整可落地的适配逻辑，以下是经过多版本Windows、多屏DPI场景验证的实现方案：

信号逻辑放置与响应规则 #

• QScreen::logicalDotsPerInchChanged信号的连接不要散落在各个子控件中，最优放置位置是顶级窗口类的初始化流程内，避免全局连接导致的多屏适配失效问题*。

• 不要在应用启动阶段直接绑定主屏幕的信号：QScreen是和窗口实际挂靠的物理屏幕绑定的，多屏DPI不一致时，直接绑定主屏幕信号会出现窗口跨屏后缩放不生效的问题
• 正确连接时机：窗口完成首次渲染后，获取当前挂靠的QScreen对象完成信号绑定；窗口跨屏拖拽时，需要重新解绑旧屏幕的信号、绑定新屏幕的信号，同时立刻触发一次缩放适配

示例代码：

// 自定义顶级窗口类成员声明
class MainWindow : public QMainWindow {
    Q_OBJECT
private:
    qreal m_baseDpi = 96.0; // 初始化时记录当前屏幕的基准DPI值
    void handleDpiChange(qreal newDpi);
    void updateWidgetSizeByScale(QWidget *target, qreal scale);
protected:
    void changeEvent(QEvent *e) override;
};

// 构造函数末尾添加初始化绑定逻辑
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    // 原有UI初始化逻辑
    // 延迟到窗口首次show完成后绑定信号
    QTimer::singleShot(0, this, [this](){
        m_baseDpi = this->screen()->logicalDotsPerInch();
        connect(this->screen(), &QScreen::logicalDotsPerInchChanged,
                this, &MainWindow::handleDpiChange);
    });
}

// 处理窗口跨屏的信号重绑定
// 注：QEvent::WindowScreenChange 从Qt 5.14版本开始支持，更低版本可通过监听窗口移动事件，计算窗口中心点所在屏幕的DPI变化做适配
void MainWindow::changeEvent(QEvent *e)
{
    if (e->type() == QEvent::WindowScreenChange) {
        disconnect(this->screen(), nullptr, this, nullptr);
        m_baseDpi = this->screen()->logicalDotsPerInch();
        connect(this->screen(), &QScreen::logicalDotsPerInchChanged,
                this, &MainWindow::handleDpiChange);
        handleDpiChange(m_baseDpi);
    }
    QMainWindow::changeEvent(e);
}

窗口层批量控件尺寸适配 #

不需要递归给每个控件单独设置尺寸，核心逻辑是利用Qt布局系统的重计算能力，只针对会导致适配失效的硬编码尺寸做批量换算：

• 系统已经自动完成了字体的DPI缩放，你遇到的“字体正常放大、控件尺寸不变”的问题，本质是运行时DPI变化不会触发布局的重新计算，控件初始化时设置的固定尺寸/最小尺寸没有跟随新的缩放比例更新
• 批量适配逻辑不需要逐个子控件手动调大小，只需要两步：
  1. 收到DPI变化信号后，计算当前缩放比例（新DPI / 初始化时记录的基准DPI）
  2. 递归遍历窗口下所有控件，对设置了硬编码固定尺寸的控件按照缩放比例重新换算尺寸，最后强制触发全局布局失效重算

适配槽函数的示例代码：

void MainWindow::handleDpiChange(qreal newDpi)
{
    const qreal scaleFactor = newDpi / m_baseDpi;
    // 延迟10ms等系统完成字体缩放事件推送，避免界面闪烁
    QTimer::singleShot(10, this, [this, scaleFactor](){
        updateWidgetSizeByScale(this, scaleFactor);
        // 强制所有布局重新计算sizeHint
        this->layout()->invalidate();
        this->adjustSize();
    });
}

// 批量递归换算控件硬编码尺寸
void MainWindow::updateWidgetSizeByScale(QWidget *target, qreal scale)
{
    // 仅处理设置了固定尺寸的控件，跳过由布局自动管理尺寸的控件
    if (target->minimumSize() == target->maximumSize() && !target->layout()) {
        QSize originalSize = target->size();
        target->setFixedSize(originalSize * scale);
    }
    // 递归处理所有子控件
    const QObjectList childList = target->children();
    for (QObject *obj : childList) {
        QWidget *childWidget = qobject_cast<QWidget*>(obj);
        if (childWidget) {
            updateWidgetSizeByScale(childWidget, scale);
        }
    }
}

常见踩坑注意点 #

• 不要手动全局修改字体大小：Qt会自动处理字体的DPI缩放，手动调整会导致字体缩放比例翻倍
• 使用QSS时注意：样式表里硬编码的px尺寸不会自动适配，需要把尺寸值替换为em单位跟随字体缩放，或者在批量更新逻辑里同步换算QSS中的尺寸值
• 多窗口场景下：每个顶级窗口都需要独立绑定自身挂靠屏幕的DPI信号，不要做全局的缩放广播

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