在 QML 中使 QList<QObject*> C++ 模型动态化

Question

我有一个 QList<QObject*> C++ 模型，其中包含自定义对象并暴露给 QML。

我的自定义对象如下所示：

class CustomObject : public QObject
{
  Q_OBJECT

    Q_PROPERTY(QString name READ getName NOTIFY nameChanged)
    Q_PROPERTY(QQmlListProperty<CustomObject READ getChildren NOTIFY childrenChanged)

    [...]

}

我的模型像这样暴露于 QML：

qmlEngine->rootContext()->setContextProperty("internalModel", QVariant::fromValue(m_internalModel));

到目前为止一切顺利。我可以使用视图，显示我的所有元素并递归地显示它们的子元素。

问题在于 QList 无法通知 QML 模型已更改。如关于 QObjectList-based model 的文档中所述：

注意：视图无法知道 QList 已更改。如果 QList 发生变化，则需要重新设置 再次调用 QQmlContext::setContextProperty() 进行建模。

所以每次我添加或删除一个项目时，我都会调用：

qmlEngine->rootContext()->setContextProperty("internalModel", QVariant::fromValue(m_internalModel));

这非常慢。

如果我理解正确，我需要改用QAbstractItemModel。

那么，是否可以在不更改 QML 部分的情况下从 QList<QObject*> 迁移到 QAbstractItemModel？特别是，我应该将所有 Q_PROPERTY 从 CustomObject 迁移到角色还是可以“重用它们”？

Answer 1

是的，这是可能的，您只需稍微更改 QML

C++ 模型类

#pragma once
#include <QAbstractListModel>
#include <QVector>

class Model : public QAbstractListModel {
  Q_OBJECT
public:
  int rowCount(const QModelIndex&) const override;
  QVariant data(const QModelIndex& index, int role) const override;

public slots:
  void insert(QObject* item);
  void remove(QObject* item);

protected:
  QHash<int, QByteArray> roleNames() const override;

private:
  QVector<QObject*> mItems;
};

它适用于从QObject 继承的任何类型。您可以使用 insert() 和 remove() 插入和删除项目，这在 C++ 和 QML 中都可以使用。实现很简单

#include "model.h"

int Model::rowCount(const QModelIndex&) const {
  return mItems.size();
}

QVariant Model::data(const QModelIndex& index, int /*role*/) const {
  QObject* item = mItems.at(index.row());
  return QVariant::fromValue(item);
}

void Model::insert(QObject* item) {
  beginInsertRows(QModelIndex(), 0, 0);
  mItems.push_front(item);
  endInsertRows();
}

void Model::remove(QObject* item) {
  for (int i = 0; i < mItems.size(); ++i) {
    if (mItems.at(i) == item) {
      beginRemoveRows(QModelIndex(), i, i);
      mItems.remove(i);
      endRemoveRows();
      break;
    }
  }
}

QHash<int, QByteArray> Model::roleNames() const {
  QHash<int, QByteArray> roles;
  roles[Qt::UserRole + 1] = "item";
  return roles;
}

注意roleNames() 和"item" 角色的使用。我们将在 QML 中使用它。您无需将CustomObject 属性迁移到角色，只需使用单个角色并从Model::data() 返回QObject* 指针。

模型注册

Model internalModel;
qmlEngine->rootContext()->setContextProperty("internalModel", &internalModel);

终于

ListView {
  model: internalModel
  delegate: Text {
    text: model.item.name
  }
}

您需要在 QML 中做的唯一一件事就是将 name 和 getChildren 替换为 model.item.name 和 model.item.getChildren。听起来很简单？