如何创建用于 QML 的通用对象模型？

Question

我想知道是否有任何宏或方法如何将 Qt 模型注册为 QObject 的属性。

比如我有AnimalModel (http://doc.qt.io/qt-5/qtquick-modelviewsdata-cppmodels.html#qabstractitemmodel)。

我知道我可以将它传递给 QuickView 的根上下文

QuickView view;
view.rootContext()->setContextProperty("myModel", &model);

如果我通过 Qml 宏注册了 QObject，我也可以传递这个对象来查看：

view.rootContext()->setContextProperty("obj", pDataObject);

但是如果我想要拥有任何数据模型的 QObject 怎么办？

例如：

class DataObject : public QObject
{
    Q_OBJECT

    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
    Q_PROPERTY(QString color READ color WRITE setColor NOTIFY colorChanged)
    ...

    AnimalModel m_modelAnimals;

    //Is this possible in any way?
    //Q_PROPERTY(AnimalModel modelAnimals READ modelAnimals NOTIFY modelAnimalsChanged)
};

到目前为止，我找到的每个示例都展示了如何将 QAbstractListModel 传递给根上下文。但是 none 如何将它用作 QObject 属性.

（我知道有QQmlListProperty但是QQmlListProperty不支持局部刷新，总是需要重建所有Qml对象）

Answer 1

//Is this possible in any way?
//Q_PROPERTY(AnimalModel modelAnimals READ modelAnimals NOTIFY modelAnimalsChanged)

是的，你没有试过吗？当然不会是AnimalModel而是AnimalModel *，但是只要模型继承了QAbstractListModel就可以了。您甚至不需要 NOTIFY 部分，因为模型内部的更改无论如何都会自动反映出来。 modelAnimalsChanged 仅当您用不同的模型替换整个模型时才有意义，并且自然而然地关闭 QML 关于在没有通知信号的情况下使用属性的警告。当模型 object 没有改变时，一种更简洁的方法是从插槽中 return 一个 AnimalModel * 或 Q_INVOKABLE.

如果您想要一个真正灵活的模型，您可以制作一个存储 QObject * 的模型，然后您可以从 QML 创建具有任意属性的任意 objects，并添加到模型中。然后从模型中你有一个 object 角色，它 return 是 object，你可以查询并使用 object 来检索它拥有的属性。 "classical" 列表模型实现将定义一个具有静态、固定模式的模型，使用这种方法允许在模型中有 "amorphous" object 具有不同的属性。

当然，这需要一些类型安全，例如在这样的模型中每个 object 都有一个 property int type，并且基于它您可以确定 [=72= 的可用属性].我通常的方法是为委托设置一个 Loader，并将 object 作为数据源传递给不同的 QML UI 实现，可视化它实例化的 object 类型.这样，您在模型中既有不同的 object，也有不同的 QML 项作为视图委托。

制作终极 "jack of all trades" list/model object 的最后一步是为它实现 QQmlListProperty 和 Q_CLASSINFO("DefaultProperty", "container") list/model 动态地，或使用 QML 的声明性语法。另请注意，使用此解决方案，您可以在此类模型中添加或删除，甚至删除声明实例化的 objects.

此外，根据您的使用场景，您可能需要 qmlRegisterType() 或 qmlRegisterUncreatableType() 模型。

好吧，再一看，"model of any data" 似乎不是指 schema-less 模型，而只是不同的模式模型。在这种情况下，您可以使用 QAbstractListModel * 甚至 QObject * 而不是 returning AnimalModel * - 它无论如何都可以在 QML 中工作，因为它通过元系统。但无论如何，schema-less 模型更加强大和灵活，而且它们不需要定义 C++ 代码，它可以单独从 QML 工作。

class List : public QAbstractListModel {
    Q_OBJECT
    QList<QObject *> _data;

    Q_PROPERTY(int size READ size NOTIFY sizeChanged)
    Q_PROPERTY(QQmlListProperty<QObject> content READ content)
    Q_PROPERTY(QObject * parent READ parent WRITE setParent)
    Q_CLASSINFO("DefaultProperty", "content")
public:
    List(QObject *parent = 0) : QAbstractListModel(parent) { }
    int rowCount(const QModelIndex &p) const { Q_UNUSED(p) return _data.size(); }
    QVariant data(const QModelIndex &index, int role) const {
        Q_UNUSED(role)
        return QVariant::fromValue(_data[index.row()]);
    }
    QHash<int, QByteArray> roleNames() const {
        static QHash<int, QByteArray> roles = { { Qt::UserRole + 1, "object" } };
        return roles;
    }
    int size() const { return _data.size(); }
    QQmlListProperty<QObject> content() { return QQmlListProperty<QObject>(this, _data); }

public slots:
    void add(QObject * o) { insert(o, _data.size()); }

    void insert(QObject * o, int i) {
        if (i < 0 || i > _data.size()) i = _data.size();
        beginInsertRows(QModelIndex(), i, i);
        _data.insert(i, o);
        o->setParent(this);
        sizeChanged();
        endInsertRows();
    }

    QObject * take(int i) {
        if ((i > -1) && (i < _data.size())) {
            beginRemoveRows(QModelIndex(), i, i);
            QObject * o = _data.takeAt(i);
            o->setParent(0);
            sizeChanged();
            endRemoveRows();
            return o;
        } else qDebug() << "ERROR: take() failed - object out of bounds!";
        return 0;
    }

    QObject * get(int i) {
        if ((i > -1) && (i < _data.size())) return _data[i];
        else  qDebug() << "ERROR: get() failed - object out of bounds!";
        return 0;
    }

    void internalChange(QObject * o) { // added to force sort/filter reevaluation
      int i = _data.indexOf(o);
      if (i == -1) {
        qDebug() << "internal change failed, obj not found";
        return;
      } else {
        dataChanged(index(i), index(i));
      }
    }

signals:
    void sizeChanged();
};

然后，在你 qmlRegisterType<List>("Core", 1, 0, "List"); 之后，你几乎可以以任何你想要的方式使用它 - 它可以容纳任何 QObject 或派生的，自然包括 QMLs QtObject 它可以直接用作模型来驱动 ListView。您可以使用插槽或声明动态填充它，如下所示：

List {
    QtObject { ... }
    QtObject { ... }
    List {
        QtObject { ... }
        QtObject { ... }
    }
}

它还将处理 object 所有权，您可以轻松地嵌套它，本质上生成一个分隔的树模型 - 请注意，您不能使用 QML 的 ListModel 以声明方式做到这一点。如果你想绑定一个变化的 parent，你可能想要添加一个 parentChanged 信号并实现一个发出它的 setter，在我的例子中没有必要。

关于如何在视图中使用它，您可以使用 objectName 属性或 int type 属性或基本上任何方法来区分不同的object 类型，并使用 Loader 代表：

Loader {
    // using component in order to capture context props and present to the variable delegate
    sourceComponent: Qt.createComponent(obj.objectName + ".qml")
    // if that is not needed simply use
    // source: obj.objectName + ".qml"
    // or setSource to pass specific properties to delegate properties
    // Component.onCompleted: setSource(obj.objectName + ".qml", {/*prop list*/})
}

更新：

用于简单且同样动态和通用的排序和过滤代理以与此模型一起使用以增强可用性。

如何创建用于 QML 的通用对象模型？

How to create a generic object model for use in QML?

c++

qt

generics

model

qtquick2