将 Q_GADGET 作为信号参数从 C++ 传递到 QML

Question

无法在 QML 代码中获取 C++ 对象的属性。对象作为参数传递给信号。

预计在QML中，可以提取Record对象的属性text。并且该值应为 abc。 QML 将对象视为 QVariant(Record)，将其属性 text 视为 undefined.

Record 是一个类似于 QPoint 的值类型，因此它使用 Q_GADGET 声明。

hpp:

#ifndef LISTENP_HPP_
#define LISTENP_HPP_

#include <QObject>

#include "Record.hpp"

class ListenP: public QObject
{
Q_OBJECT

public:
    ListenP();
    virtual ~ListenP();

    void emitGotRecord();

signals:
    void gotRecord(Record r);
};

#endif /* LISTENP_HPP_ */

cpp:

#include "ListenP.hpp"

ListenP::ListenP() :
        QObject()
{
}

ListenP::~ListenP()
{
}

void ListenP::emitGotRecord()
{
    emit gotRecord(Record("abc"));
}

hpp 记录：

#ifndef RECORD_HPP_
#define RECORD_HPP_

#include <QObject>
#include <QMetaType>

class Record
{
Q_GADGET

Q_PROPERTY(QString text READ text WRITE setText)

public:
    Record(const QString& text = "");
    ~Record();

    QString text() const
    {
        return m_text;
    }

    void setText(const QString& text)
    {
        m_text = text;
    }

private:
    QString m_text;
};

Q_DECLARE_METATYPE(Record)

#endif /* RECORD_HPP_ */

用于记录的 cpp：

#include "Record.hpp"

Record::Record(const QString& text) :
        m_text(text)
{
}

Record::~Record()
{
}

namespace
{
const int RecordMetaTypeId = qMetaTypeId<Record>();
}

QML 片断：

Connections {
    target: listenPModel
    onGotRecord: {
        console.log(r)
        console.log(r.text)
    }
}

主要作品：

QGuiApplication app(argc, argv);

auto listenP = std::make_shared<ListenP>();
QQuickView view;
view.rootContext()->setContextProperty("listenPModel", &*listenP);
view.setSource(QStringLiteral("src/qml/main.qml"));
view.show();

QtConcurrent::run([=]
{
    QThread::sleep(3);
    listenP->emitGotRecord();
});

return app.exec();

日志显示：

qml: QVariant(Record)
qml: undefined

Answer 1

Qt 5.5 的 release notes 表示新功能：

Qt Core

You can now have Q_PROPERTY and Q_INVOKABLE within a Q_GADGET, and there is a way to query the QMetaObject of such gadget using the QMetaType system

确实，使用 Qt 5.4 编译和运行你的示例给出了与你的相同的结果而使用 Qt 5.5 我得到了 Record 正确识别，即我得到的结果是：

qml: Record(abc)
qml: abc

此外，如 Q_DECLARE_METATYPE documentation 中所述，传递给宏的类型 - Record 在这种情况下，应提供 (1) public 默认值构造函数，(2) public 复制构造函数和 (3) public 析构函数。由于 Record 是一个非常简单的 class，因此无需提供复制构造函数，默认的就足够了。

将 Q_GADGET 作为信号参数从 C++ 传递到 QML

Passing Q_GADGET as signal parameter from C++ to QML

c++

qt

qml

qtquick2

qgadget