QT中QFileDialog跨分辨率窗口过大问题及解决方法求助

问题描述 #

基于Qt 5.15.10 + Windows 10开发的应用中，通过以下代码实现文件选择功能：

QString file_name = QFileDialog::getOpenFileName(this, "Open a file", QDir::homePath(), "JSON File (*.json)");

为适配4K显示器，启用高DPI缩放：

QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);

但出现以下异常：

• 在1080p显示器启动应用并调用文件浏览器时，窗口尺寸过大
• 将应用窗口从4K显示器拖拽至1080p显示器后，文件浏览器窗口尺寸仍异常

原因分析 #

1. 原生对话框的DPI适配缺陷：Windows平台下QFileDialog默认调用系统原生对话框，其缩放逻辑绑定对话框创建时所在显示器的DPI值。跨DPI显示器拖拽时，Windows不会自动重新计算缩放比例；在低DPI显示器启动时，原生对话框可能错误套用高DPI缩放系数，导致窗口尺寸失调。
2. Qt与系统原生控件缩放逻辑不统一：Qt::AA_EnableHighDpiScaling仅对Qt自身控件生效，无法控制系统原生控件的缩放行为，二者适配逻辑不一致引发冲突。

解决办法 #

1. 强制使用Qt自定义文件对话框 #

使用Qt自研的文件对话框替代系统原生版本，其缩放逻辑与应用高DPI配置完全对齐，跨显示器可自动适配：

QFileDialog dialog(this, "Open a file", QDir::homePath(), "JSON File (*.json)");
dialog.setOption(QFileDialog::DontUseNativeDialog);
if (dialog.exec() == QDialog::Accepted) {
    QString file_name = dialog.selectedFiles().first();
    // 业务逻辑处理
}

2. 补充高DPI属性配置 #

在QApplication初始化前添加额外高DPI配置，优化跨显示器缩放行为：

QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
QApplication::setAttribute(Qt::AA_UseHighDpiPixmaps);
// 设置缩放系数取整策略，避免跨DPI时的尺寸异常
QApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::RoundPreferFloor);

3. 配置应用高DPI感知清单 #

确保应用的manifest文件包含正确的高DPI感知声明，让Windows正确识别应用的高DPI适配能力：

<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
    <asmv3:application>
        <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">
            <dpiAware>true/pm</dpiAware>
        </asmv3:windowsSettings>
    </asmv3:application>
</assembly>

Qt Creator构建时，可在项目构建设置中启用「Add application manifest」选项，或手动嵌入上述配置。

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