如何解决QML调用C++对象时出现的ReferenceError问题

看起来你遇到的问题是QML无法识别C++上下文对象，同时信号绑定也报错了，我来帮你拆解下问题根源和解决办法：

首先看你给出的错误信息：ReferenceError: connection is not defined 和 QML Connections: Cannot assign to non-existent property "onTimeChanged"，核心问题是QML没有正确获取到你设置的connection上下文属性，同时还有一个隐藏的C++语法错误可能导致信号槽机制失效。

1. 先修复C++类的语法错误 #

你的MainWindow类定义末尾少了分号，这会导致编译错误，而且moc工具无法正确生成信号槽相关的代码，这是很多人容易忽略的细节：

class MainWindow : public QObject {
    Q_OBJECT
private:
    QString _windowPrefix;
    const QString _mainWindowName = "MainWindow.qml";
    QQuickWidget *_window;
    QTimer _timer;
public:
    explicit MainWindow(QObject *parent = nullptr);
    void Show();
    Q_INVOKABLE void secreetButtonPressed();
    Q_INVOKABLE void secreetButtonReleased();
    Q_INVOKABLE void onTimeChanged();
signals:
    void timeChanged(QString formatted_time);
    void dataChanged(QString formatted_data);
}; // 这里必须加上分号！

2. 确保上下文属性在QML加载前设置 #

你的main函数顺序其实是对的，但要明确：必须在调用setSource()加载QML文件之前，完成rootContext的属性设置。现有代码没问题，但如果之前调整过顺序可能出问题，保持这个顺序：

int main(int argc, char *argv[]) {
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QApplication app(argc, argv);
    QQuickView wdg;
    MainWindow mywnd;
    // 先把C++对象注册到QML全局上下文
    wdg.engine()->rootContext()->setContextProperty("connection", &mywnd);
    // 再加载QML文件
    wdg.setSource(QUrl("qrc:/qml_vertical_7p/MainWindow.qml"));
    wdg.show();
    return app.exec();
}

3. 修复QML中的信号绑定问题 #

虽然你的Connections组件写法本身没问题，但可以做一些优化避免作用域问题：

• 先验证connection是否存在：在根Item里加个初始化日志，确认QML能拿到这个对象
• 如果存在作用域屏蔽，可以把上下文属性绑定到根Item的属性上再传递

修改后的QML代码：

import QtQuick 2.4
import QtQuick.Controls 2.0
Item {
    id:wnd
    visible: true
    width: form.height
    height: form.width

    // 验证connection是否存在，方便调试
    Component.onCompleted: console.log("connection对象是否存在:", connection)

    Page {
        rotation: 90
        MainWindowForm {
            id: form
            x: 0
            y: -800
            mouseArea.onPressed: { connection.secreetButtonPressed() }
            mouseArea.onReleased: { connection.secreetButtonReleased() }
        }
        Connections {
            target: connection
            // 确保这里的信号名和C++的信号完全对应（on+首字母大写的信号名）
            onTimeChanged: {
                console.log("收到C++的timeChanged信号:", formatted_time)
                // 在这里写你的UI修改逻辑，比如更新文本框内容
            }
        }
    }
}

4. 确保C++端正确发射信号 #

最后要确认你在C++代码中确实发射了timeChanged信号，比如在定时器槽函数里：

MainWindow::MainWindow(QObject *parent) : QObject(parent) {
    // 绑定定时器触发槽函数
    connect(&_timer, &QTimer::timeout, this, &MainWindow::onTimeChanged);
    _timer.start(1000); // 每秒触发一次
}

void MainWindow::onTimeChanged() {
    QString currentTime = QTime::currentTime().toString("hh:mm:ss");
    emit timeChanged(currentTime); // 必须显式发射信号
    qDebug() << "已发射timeChanged信号:" << currentTime;
}

额外注意事项 #

• 修改完带有Q_OBJECT宏的类后，一定要重新运行qmake，再编译项目，否则moc生成的代码不会更新，信号槽机制会失效。
• 确认mywnd的生命周期：它是main函数里的栈变量，在程序运行期间会一直存在，没问题；如果是堆上创建的对象，要确保不会提前被销毁。

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