如何在 QML 中访问 C++ 对象的列表属性

Question

我已经开始学习 Qt 5 并在很长一段时间内陷入困境。

我有两节课。 ScoreHandler 处理一个 ScoreRecords 列表。 我在 C++ 中创建了这两个类，并将 ScoreHandler 的一个实例设置为上下文属性。 现在在 QML 中我可以分配模型，但委托人看不到 ScoreRecord 的属性。 我必须在某处注册一些东西吗？ 请帮帮我。

成绩记录.h

class ScoreRecord : public QObject
{
    Q_OBJECT

    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
    Q_PROPERTY(QString date READ date WRITE setDate NOTIFY dateChanged)
    Q_PROPERTY(QString score READ score WRITE setScore NOTIFY scoreChanged)
public:
    ScoreRecord(QObject *parent = 0);
    ScoreRecord(const QString& n, const QString &d, const QString &s, QObject *parent = 0);
    QString name() const;
    void setName(const QString &str);
    QString date() const;
    void setDate(const QString &str);
    QString score() const;
    void setScore(const QString &str);


signals:
    void nameChanged();
    void dateChanged();
    void scoreChanged();

public slots:

private:
    QString m_name;
    QString m_date;
    QString m_score;
};

分数处理程序.h

class ScoreHandler : public QObject
{
    Q_OBJECT
private:
    const char* SCORE_TABLE_FILENAME;

    struct scoreRow {
        char name[128];
        char date[32];
        char score[16];
    };


public:
    explicit ScoreHandler(QObject *parent = 0);
    QList<ScoreRecord *> scoreList;

signals:

public slots:
    void SaveScore(const QString &name, const QString &date, const QString &score);
    void LoadScore();
};

主文件

int main(int argc, char *argv[])
{

    QGuiApplication app(argc, argv);
    QtQuick2ApplicationViewer viewer;

    ScoreHandler* scoreHandler = new ScoreHandler();
    QQmlContext* ctx = viewer.rootContext();
    ctx->setContextProperty("MyScoreModel", QVariant::fromValue(scoreHandler->scoreList));
    viewer.setMainQmlFile(QStringLiteral("qml/qmlListView/main.qml"));

    viewer.showExpanded();

    return app.exec();
}

QML文件

import QtQuick 2.0

Rectangle {
    width: 360
    height: 360

    ListView {
        width: 100; height: 100
        anchors.fill: parent

        model: MyScoreModel
        delegate: Text {
            text: name
        }
    }
}

请有人解释一下，为什么下面的代码有效？ 原因是什么？

主文件

int main(int argc, char *argv[])
{

    QGuiApplication app(argc, argv);
    QtQuick2ApplicationViewer viewer;

    ScoreHandler* scoreHandler = new ScoreHandler();
    QList<QObject *> scoreList;

    scoreList.append(new ScoreRecord("Jmeno1", "datum1", "score1"));
    scoreList.append(new ScoreRecord("Jmeno2", "datum2", "score2"));
    scoreList.append(new ScoreRecord("Jmeno3", "datum3", "score3"));

    QQmlContext* ctx = viewer.rootContext();
    ctx->setContextProperty("MyScoreModel", QVariant::fromValue(scoreList));
    viewer.setMainQmlFile(QStringLiteral("qml/qmlListView/main.qml"));

    viewer.showExpanded();

    return app.exec();
}

Answer 1

我相信有一种更清洁的方法。 您需要在 ScoreHandler 上定义一个属性 scoreList：

Q_PROPERTY(QQmlListProperty<ScoreRecord> scoreList READ scoreList)

还有一个私有变量，用于保存您的 ScoreRecord 指针：

QList _scoreRecords;

然后你需要实现访问器方法：

// ScoreHandler.h
QQmlListProperty<ScoreRecord> scoreList();

// ScoreHandler.cpp
QQmlListProperty<ScoreRecord> ScoreHandler::scoreList()
{
    return QQmlListProperty<ScoreRecord>(this, _scoreRecords);
}

然后您可以从 qml 访问它。

QtCreator 上有一个关于此的示例。 它被称为扩展 QML - 对象和列表属性类型示例

Answer 2

我坚信

ctx->setContextProperty("MyScoreModel", QVariant::fromValue(scoreHandler->scoreList));

执行当前列表的副本，在给定的示例中为空，并且在您修改scoreList时不会更新。 Qt 文档说：

注意：视图无法知道 QList 的内容已更改。 如果 QList 发生变化，则需要再次调用 QQmlContext::setContextProperty() 来重置模型。

如果您需要真实的数据模型，请从QAbstractListModel派生并实现必要的覆盖： data(...) 、 rowCount()和count属性、 roleNames() 。

最后一个示例有效，因为它将静态列表分配给上下文变量。 与 JavaScript 相同：

[{name: Jmeno1, date: datum1, score: score1},
{name: Jmeno2, date: datum3, score: score2},
{name: Jmeno3, date: datum3, score: score3}]

Answer 3

Nuno Santos 的回答很好，我还要指出您可能需要的两个重要修改：

请注意，ScoreRecord 必须使用 QML 类型系统注册，例如： qmlRegisterType<ScoreRecord>("com.mycompany.database", 1, 0, "ScoreRecord");

如果 ScoreRecord 在命名空间中，则必须像这样定义属性：

Q_PROPERTY(QQmlListProperty<myNamespace::ScoreRecord> scoreList READ scoreList)

Answer 4

请注意，如果ScoreRecord在命名空间中，您可能必须像这样声明 Q_PROPERTY。

Q_PROPERTY(QQmlListProperty<myNamespace::ScoreRecord> scoreList READ scoreList)