【Qt QObject::connect: Cannot queue arguments of type ‘your class‘】

(Make sure ‘your class’ is registered using qRegisterMetaType().)

最近开发过程中恰好遇到了这个问题，记录一下：

在Qt框架中，如果你需要在QObject派生类的信号（signals）或槽（slots）机制中传递自定义类型的数据，或者需要将这些数据存储在QObject的属性（properties）中，你需要确保这些类型已被注册，以便Qt的元对象系统能够识别和处理它们。

qRegisterMetaType()函数用于注册一个自定义类型，使其可以在Qt的元对象系统中使用。这包括在跨线程的信号和槽通信中传递该类型的实例，或者在Qt属性系统中使用。

如果你在代码中看到这样的提示（可能来自Qt Creator的编译器插件或静态分析工具），这意味着你的代码中使用了类型your class，但在使用之前没有进行注册。

以下是如何注册your class类型的示例：

// 假设 yourclass 是一个自定义结构或类
struct yourclass {
    // ...
};

// 在 main 函数或任何初始化代码中注册该类型
qRegisterMetaType<yourclass>("yourclass");

// 现在你可以在信号和槽中使用 yourclass类型
// 例如：
// signals:
// void imageReceived(const yourclass& yourclass);

// slots:
// void processImage(const yourclass& classInfo);
// {
//     // 处理图像信息
// }

请注意，qRegisterMetaType()宏需要类型名称作为字符串参数，这在运行时用于识别类型。如果你的类型是包含在命名空间中的，那么需要包含完整的命名空间路径。

此外，如果你使用的是C++11或更新的版本，并且你的编译器支持auto类型推断和decltype关键字，你可以使用Q_DECLARE_METATYPE宏和qRegisterMetaType()函数来注册类型，如下所示：

struct yourclass{
    // ...
};

Q_DECLARE_METATYPE(yourclass)

// 在 main 函数或任何初始化代码中注册该类型
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    qRegisterMetaType<yourclass>("yourclass");
    // ...
    return app.exec();
}

确保在程序的任何其他代码使用yourclass类型之前完成注册。通常，这是在main函数中的程序启动逻辑的一部分。