QML的screenshot信号连接C++的take_screenshot槽无法触发如何解决？

问题原因 #

1. 信号槽签名不匹配：你在QML中定义的screenshot()信号是无返回值的，而C++侧的take_screenshot()槽函数返回值为int，使用旧版SIGNAL()/SLOT()宏连接时，要求信号和槽的返回值、参数列表完全匹配，因此连接直接失败，不会触发槽函数。
2. 连接时机错误：如果你在QQmlApplicationEngine执行load()加载QML文件之前就创建了MyClass实例，此时engine->rootObjects()列表为空，你获取的根对象指针无效，连接自然不会生效。
3. 旧版信号槽语法无编译检查：SIGNAL()/SLOT()宏的连接错误只会在运行时输出控制台警告，不会在编译期报错，很容易忽略问题。
4. 额外隐含问题：你当前用的时间格式包含冒号:，Windows系统不允许文件名出现冒号，后续槽函数触发后也会出现图片保存失败的问题。

修复方案 #

第一步：修改槽函数签名，适配信号

把take_screenshot()槽的返回值改为void，同时修改时间格式避免非法文件名：

public slots:
// 改为void返回值，和QML信号匹配
void take_screenshot()
{
    // 时间格式把冒号换成横杠，避免Windows文件名非法问题
    QString currentDateTime = QDateTime::currentDateTime().toString( "MMMM d, yyyy, HH-mm-ss");
    QScreen *screen = QGuiApplication::primaryScreen();
    QPixmap pixmap = screen->grabWindow(0);
    QString screenshotPath = QDir::currentPath();
    QString screenShotFileName = QString("%1/%2.png").arg(screenshotPath).arg(currentDateTime);
    if (!screenShotFileName.isEmpty())
    {
        pixmap.save(screenShotFileName);
    }
}

第二步：调整创建MyClass的时机，确保QML加载完成后再连接

你的main函数执行顺序必须是先加载QML，再创建MyClass实例：

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;
    const QUrl url(u"qrc:/main.qml"_qs);
    engine.load(url);
    // 先判断QML加载成功，再创建MyClass实例
    if (engine.rootObjects().isEmpty())
        return -1;
    MyClass myClass(std::make_shared<QQmlApplicationEngine>(engine));
    return app.exec();
}

可选优化：换用更稳妥的注册上下文方案

避免信号槽连接时机的问题，你可以直接把MyClass实例注册到QML上下文，在QML侧直接调用槽函数，不需要手动连接：

1. 修改main函数，注册实例到上下文：

// 加载QML之前注册上下文
MyClass myClass(std::make_shared<QQmlApplicationEngine>(engine));
engine.rootContext()->setContextProperty("MyClass", &myClass);
engine.load(url);

2. QML里直接调用槽函数，不需要额外定义screenshot信号：

onSourceChanged: {
    console.log("onSourceChanged_source :", pageLoader.source)
    MyClass.take_screenshot()
}
Component.onCompleted:{
    console.log("onCompleted!", pageLoader.source)
    MyClass.take_screenshot()
}

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