Qt 6.5中QML窗口OnClicked事件无响应问题求助

基于Qt 6.5开发的C++应用，打开包含Map组件的QML窗口后，鼠标点击操作无任何响应。相关代码如下：

QML代码 #

import QtQuick
import QtQuick.Window
import QtLocation
import QtPositioning

Window {
    visible: true
    width: 640
    height: 480
    title: qsTr("Карта")

    Plugin {
        id: mapPlugin
        name: "osm"
    }

    Map {
        anchors.fill: parent
        plugin: mapPlugin
        center: QtPositioning.coordinate(59.91, 10.75) // Oslo
        zoomLevel: 14
        Component.onCompleted: console.log("Text onCompleted map.")

        MouseArea {
            id: m1
            anchors.fill: parent
            //propagateMouseEvent: true
            acceptedButtons: Qt.LeftButton | Qt.RightButton
            onClicked: console.log("click ")

            Rectangle {
                anchors.fill: parent
                color: "transparent"
                border.color: "black"
            }
        }
    }
}

C++调用代码 #

void MainWindow::on_pushButton_2_clicked()
{
    QQmlEngine engine;
    QQmlComponent component(&engine);
    QQuickWindow::setDefaultAlphaBuffer(true);
    component.loadUrl(QUrl("map.qml"));
    if (component.isReady())
        component.create();
    else
        qWarning() << component.errorString();
}

原因分析 #

1. Map组件事件拦截：Map组件本身会处理鼠标事件（如拖拽、缩放），默认会拦截事件，导致内部嵌套的MouseArea无法接收到点击信号。
2. 对象生命周期问题：C++代码中QQmlEngine是局部变量，函数执行完毕后会被销毁，连带其创建的QML窗口对象也会被回收，可能导致窗口虽显示但无法正常响应事件。

解决方案 #

1. 调整MouseArea层级，避免被Map拦截 #

将MouseArea移到Map组件外部，作为Window的直接子元素，覆盖整个窗口，确保优先接收鼠标事件：

import QtQuick
import QtQuick.Window
import QtLocation
import QtPositioning

Window {
    visible: true
    width: 640
    height: 480
    title: qsTr("Карта")

    Plugin {
        id: mapPlugin
        name: "osm"
    }

    Map {
        anchors.fill: parent
        plugin: mapPlugin
        center: QtPositioning.coordinate(59.91, 10.75) // Oslo
        zoomLevel: 14
        Component.onCompleted: console.log("Text onCompleted map.")
    }

    // 移到Map外部，确保优先接收鼠标事件
    MouseArea {
        id: m1
        anchors.fill: parent
        acceptedButtons: Qt.LeftButton | Qt.RightButton
        onClicked: console.log("click ")

        Rectangle {
            anchors.fill: parent
            color: "transparent"
            border.color: "black"
        }
    }
}

2. 修复C++代码的对象生命周期问题 #

将QQmlEngine和创建的窗口对象交由MainWindow管理，避免局部变量销毁导致窗口异常：

// 在MainWindow类声明中添加成员变量：
// private:
//     QObject* m_mapWindow = nullptr;
//     QQmlEngine* m_mapEngine = nullptr;

void MainWindow::on_pushButton_2_clicked()
{
    // 避免重复创建窗口
    if (m_mapWindow) {
        auto window = qobject_cast<QQuickWindow*>(m_mapWindow);
        if (window) {
            window->show();
            window->raise();
        }
        return;
    }

    m_mapEngine = new QQmlEngine(this);
    QQmlComponent component(m_mapEngine);
    QQuickWindow::setDefaultAlphaBuffer(true);
    // 建议使用资源文件路径，避免运行时路径问题
    component.loadUrl(QUrl("qrc:/map.qml"));

    if (component.isReady()) {
        m_mapWindow = component.create();
        if (auto window = qobject_cast<QQuickWindow*>(m_mapWindow)) {
            window->show();
        }
    } else {
        qWarning() << component.errorString();
        delete m_mapEngine;
        m_mapEngine = nullptr;
    }
}

3. 确保模块依赖正确链接 #

在项目构建文件中确认已添加QtLocation和QtPositioning模块：

CMakeLists.txt

find_package(Qt6 REQUIRED COMPONENTS Quick Window Location Positioning)
target_link_libraries(your_app_name PRIVATE
    Qt6::Quick
    Qt6::Window
    Qt6::Location
    Qt6::Positioning
)

.pro文件

QT += quick window location positioning

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