如何在QtWidgets项目中叠加Qml Widget到UI窗体顶层？

问题根源 #

1. 崩溃原因：将QQuickWidget添加到布局后，布局会接管控件的尺寸与位置管理，此时手动调用setGeometry会触发布局逻辑冲突，导致程序崩溃。
2. 位置限制：使用垂直/水平布局时，控件位置由布局规则自动分配，无法通过setGeometry自由指定坐标。

可行方案 #

核心是跳过布局管理，直接将QQuickWidget作为centralWidget的子控件，手动控制其位置与层级，同时修正QML代码中的层级错误。

修改后的代码示例

mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 初始化QQuickWidget并加载QML文件
    qmlWidget = new QQuickWidget(this);
    qmlWidget->setSource(QUrl(QStringLiteral("qrc:/Overlay.qml")));
    
    // 设置父控件为centralWidget，坐标基于centralWidget左上角
    qmlWidget->setParent(ui->centralWidget);
    // 自由指定位置与尺寸
    qmlWidget->setGeometry(50, 50, 50, 50);
    
    // 将QML控件置于顶层，确保叠加在其他QtWidgets控件上方
    qmlWidget->raise();
    qmlWidget->show();
}

MainWindow::~MainWindow()
{
    delete ui;
}

Overlay.qml

import QtQuick 2.15
import QtQuick.Controls 2.15

Rectangle {
    id: overlayRect
    // 移除parent: Overlay.overlay，避免脱离QtWidgets窗口层级
    width: 50; height: 50
    color: "red"
}

额外注意事项 #

• 窗口 resize 适配：若需窗口大小变化时保持QML控件相对位置，可重写MainWindow的resizeEvent，在事件内重新计算并设置qmlWidget->setGeometry。
• 透明背景设置：若需要QML控件背景透明，添加qmlWidget->setClearColor(Qt::transparent)，同时在QML根元素设置color: "transparent"。
• resizeMode 配置：默认SizeViewToRootObject模式会让QQuickWidget尺寸跟随QML根元素，适合固定尺寸的叠加场景；若需动态调整，可切换为SizeRootObjectToView。

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