外接高分辨率显示器运行QML程序出现异常画面，窗口操作后恢复

问题场景 #

在Qt 6.3.1环境下运行QML程序时出现以下异常：

• 笔记本显示器（分辨率2560x1440，缩放比例125%）运行示例程序显示正常；
• 外接同分辨率显示器（2560x1440，缩放比例100%）时，程序初始画面显示异常，仅在触发窗口事件（如移动、调整尺寸）后才恢复正常；
• 若将笔记本缩放比例设为100%，外接显示器运行程序则显示正常。

示例代码：

main.cpp #

#include <QGuiApplication>
#include <QQmlApplicationEngine>

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

    QQmlApplicationEngine engine;
    const QUrl url(QStringLiteral("qrc:/main.qml"));
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                     &app, [url](QObject *obj, const QUrl &objUrl) {
        if (!obj && url == objUrl)
            QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

main.qml #

import QtQuick

Window {
    id: appWindow

    width: 1920
    height: 1080

    visible: true
    title: qsTr("Test")
    color: "red"

    Rectangle {
        id: topBar

        width: appWindow.width
        height: 60
        color: "grey"
    }

    Rectangle {
        anchors.top: topBar.bottom
        anchors.right: parent.right
        anchors.bottom: parent.bottom
        anchors.left: parent.left

        color: "black"
    }
}

解决方案 #

1. 调整高DPI缩放策略 #

Qt 6.3.x在多显示器不同缩放比例场景下的高DPI适配存在缺陷，可通过设置缩放策略强制统一处理逻辑。在main.cpp的QGuiApplication初始化后添加以下代码：

// 尝试取整缩放因子，适配整数缩放场景
QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::Round);

或使用PassThrough策略避免缩放因子取整导致的渲染偏差：

QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::PassThrough);

2. 手动触发窗口重绘 #

初始渲染异常通常是因为高DPI环境下窗口未正确触发初始绘制，可在QML窗口加载完成后手动调用重绘：
修改main.qml，添加Component.onCompleted信号处理：

Window {
    id: appWindow

    width: 1920
    height: 1080

    visible: true
    title: qsTr("Test")
    color: "red"

    Component.onCompleted: {
        appWindow.update()
        // 或强制触发窗口显示状态刷新
        appWindow.show()
    }

    // 原有控件代码...
}

3. 升级Qt版本 #

Qt 6.3.x系列存在已知的多显示器高DPI渲染bug，升级到Qt 6.4及以上版本可修复此类问题。新版本对高DPI多屏场景的适配逻辑更完善，优先推荐版本升级。

4. 显式指定窗口所属屏幕 #

在多显示器场景下，显式指定窗口显示的屏幕可避免自动适配时的缩放混乱。在C++中获取目标屏幕并传递给QML：

// main.cpp中加载QML前添加
QList<QScreen*> screens = QGuiApplication::screens();
if (screens.size() > 1) {
    // 假设外接显示器是第二个屏幕（索引1），可根据实际情况调整
    QScreen* externalScreen = screens.at(1);
    engine.rootContext()->setContextProperty("externalScreen", externalScreen);
}

然后在QML中设置窗口的screen属性：

Window {
    id: appWindow
    screen: externalScreen // 使用C++传入的屏幕对象
    // 原有属性...
}

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