QML 中使用 QAbstractListModel 作为 ListView 的 model 实例

本文对应的源码地址：
https://github.com/imtoby/CppModelForQMLExample

程序运行效果：

运行效果

我们需要注意的是我们在使用 QAbstractListModel 时至少要实现的方法：

int rowCount(const QModelIndex &parent) const;
QVariant data(const QModelIndex &index, int role) const;
virtual QHash<int, QByteArray> roleNames() const;

我们定义一个继承自 QAbstractListModel 的类 ObjectModel 用于管理 QObject 对象列表，并将其作为 ListView 的 model 传给 QML 端使用。

下面是其头文件的内容：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: ObjectModel.h
 ***************************************************************************/
#ifndef OBJECTMODEL_H_2DBDF593_DAA2_5084_8BE0_A727A0C68256
#define OBJECTMODEL_H_2DBDF593_DAA2_5084_8BE0_A727A0C68256

#include <QAbstractListModel>

class ObjectModelPrivate;

class ObjectModel : public QAbstractListModel
{
    Q_OBJECT
public:
    explicit ObjectModel(QObject *parent = 0);
    ~ObjectModel();

    int rowCount(const QModelIndex &parent) const;
    int columnCount(const QModelIndex &parent) const;
    QVariant data(const QModelIndex &index, int role) const;
    bool setData(const QModelIndex &index, const QVariant &value, int role);
    virtual QHash<int, QByteArray> roleNames() const;

    void insert(int index, QObject* object);
    void append(QObject* object);
    void push_front(QObject* object);
    void push_back(QObject* object);

    void replace(int index, QObject* object);
    void set(QObjectList * objectList);

    void remove(QObject* object);
    void remove(int index);
    void clear();

    QObject * get(int index);
    QObjectList* getAll();

private:
    QScopedPointer<ObjectModelPrivate> d_ptr;
    Q_DECLARE_PRIVATE(ObjectModel)
};

#endif // OBJECTMODEL_H_2DBDF593_DAA2_5084_8BE0_A727A0C68256

然后是实现文件：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: ObjectModel.cpp
 ***************************************************************************/
#include "ObjectModel.h"
#include <QMutex>

#include "Config.h"

namespace {

enum {
    ObjectModelRole = Qt::UserRole + 1
};

}

class ObjectModelPrivate
{
public:
    ObjectModelPrivate(ObjectModel * parent)
        : q_ptr(parent)
        , mutex(NULL)
    {
    }

    void init();
    void uninit();

private:
    ObjectModel * const q_ptr;
    Q_DECLARE_PUBLIC(ObjectModel)

    QHash<int, QByteArray> rolesNames;
    QObjectList objectList;
    QMutex *mutex;
};

ObjectModel::ObjectModel(QObject *parent) :
    QAbstractListModel(parent),
    d_ptr(new ObjectModelPrivate(this))
{
    Q_D(ObjectModel);
    d->init();
    d->rolesNames[ObjectModelRole] = "objectModelRole";
}

ObjectModel::~ObjectModel()
{
    Q_D(ObjectModel);
    d->uninit();
}

int ObjectModel::rowCount(const QModelIndex &parent) const
{
    C_D(ObjectModel);
    Q_UNUSED(parent);
    return d->objectList.size();
}

int ObjectModel::columnCount(const QModelIndex &parent) const
{
    Q_UNUSED(parent);
    return 1;
}

QVariant ObjectModel::data(const QModelIndex &index, int role) const
{
    C_D(ObjectModel);
    if (index.row() >= 0 && index.row() < d->objectList.size() ) {
        if (role == ObjectModelRole) {
            QObject *object = d->objectList.at(index.row());
            return QVariant::fromValue(object);
        }
    }
    return QVariant(0);
}

bool ObjectModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    Q_D(ObjectModel);
    if (index.row() >= 0 && index.row() < d->objectList.size() ) {
        if (role == ObjectModelRole) {
            d->mutex->lock();
            d->objectList.replace(index.row(), value.value<QObject *>());
            d->mutex->unlock();
            return true;
        }
    }
    return false;
}

QHash<int, QByteArray> ObjectModel::roleNames() const
{
    C_D(ObjectModel);
    return d->rolesNames;
}

void ObjectModel::insert(int index, QObject *object)
{
    Q_D(ObjectModel);
    if (index >= 0  && index <= d->objectList.size()) {
        d->mutex->lock();
        beginInsertRows(QModelIndex(), index, index);
        d->objectList.insert(index, object);
        endInsertRows();
        d->mutex->unlock();
    }
}

void ObjectModel::append(QObject *object)
{
    Q_D(ObjectModel);
    insert(d->objectList.size(), object);
}

void ObjectModel::push_front(QObject *object)
{
    insert(0, object);
}

void ObjectModel::push_back(QObject *object)
{
    append(object);
}

void ObjectModel::replace(int index, QObject *object)
{
    Q_D(ObjectModel);
    if (index >= 0  && index < d->objectList.size()) {
        d->mutex->lock();
        d->objectList.replace(index, object);
        d->mutex->unlock();
        emit dataChanged(createIndex(index, 0), createIndex(index, 0));
    }
}

void ObjectModel::set(QObjectList *objectList)
{
    Q_D(ObjectModel);
    d->mutex->lock();
    beginResetModel();
    d->objectList = *objectList;
    endResetModel();
    d->mutex->unlock();
}

void ObjectModel::remove(QObject *object)
{
    Q_D(ObjectModel);
    d->mutex->lock();
    const int index = d->objectList.indexOf(object);
    if (index >= 0) {
        beginRemoveRows(QModelIndex(), index, index);
        d->objectList.removeAt(index);
        endRemoveRows();
    }
    d->mutex->unlock();
}

void ObjectModel::remove(int index)
{
    Q_D(ObjectModel);
    if (index >= 0 && index < d->objectList.size()) {
        d->mutex->lock();
        beginRemoveRows(QModelIndex(), index, index);
        QObject* object = d->objectList.at(index);
        d->objectList.removeAt(index);
        object->deleteLater();
        endRemoveRows();
        d->mutex->unlock();
    }
}

void ObjectModel::clear()
{
    Q_D(ObjectModel);
    d->mutex->lock();
    beginResetModel();
    qDeleteAll(d->objectList.begin(), d->objectList.end());
    d->objectList.clear();
    endResetModel();
    d->mutex->unlock();
}

QObject *ObjectModel::get(int index)
{
    Q_D(ObjectModel);
    if (index >= 0 && index < d->objectList.size()) {
        d->mutex->lock();
        QObject * object = d->objectList.at(index);
        d->mutex->unlock();
        return object;
    }
    return NULL;
}

QObjectList *ObjectModel::getAll()
{
    Q_D(ObjectModel);
    d->mutex->lock();
    QObjectList * objectList = &(d->objectList);
    d->mutex->unlock();
    return objectList;
}


void ObjectModelPrivate::init()
{
    rolesNames.clear();
    objectList.clear();
    if (mutex == NULL) {
        mutex = new QMutex(QMutex::Recursive);
    }
}

void ObjectModelPrivate::uninit()
{
    qDeleteAll(objectList.begin(), objectList.end());
    objectList.clear();
    rolesNames.clear();
    if (mutex) {
        delete mutex;
        mutex = NULL;
    }
}

这里定义一个继承自 QObject 的子类 TestItem，用于作为实际的数据结构存储类。
其头文件如下：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: TestItem.h
 ***************************************************************************/
#ifndef TESTITEM_H_B3E135CE_37B2_5BA7_B57A_AD850A413E91
#define TESTITEM_H_B3E135CE_37B2_5BA7_B57A_AD850A413E91

#include <QObject>

class TestItemPrivate;

class TestItem : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
public:
    explicit TestItem(QObject *parent = 0);
    ~TestItem();

    TestItem(const TestItem &other, QObject *parent = 0);
    TestItem& operator=(const TestItem &other);

    QString name() const;
    void setName(const QString& name);

signals:
    void nameChanged();

private:
    QScopedPointer<TestItemPrivate> d_ptr;
    Q_DECLARE_PRIVATE(TestItem)
};

#endif // TESTITEM_H_B3E135CE_37B2_5BA7_B57A_AD850A413E91

实现文件如下：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: TestItem.cpp
 ***************************************************************************/
#include "TestItem.h"

#include "Config.h"

class TestItemPrivate
{
public:
    TestItemPrivate(TestItem *parent)
        : q_ptr(parent)
        , name("test")
    {}

private:
    TestItem * const q_ptr;
    Q_DECLARE_PUBLIC(TestItem)

    QString name;
};

TestItem::TestItem(QObject *parent) :
    QObject(parent) ,
    d_ptr(new TestItemPrivate(this))
{
}

TestItem::~TestItem()
{
}

TestItem::TestItem(const TestItem &other, QObject *parent) :
    QObject(parent) ,
    d_ptr(new TestItemPrivate(this))
{
    d_ptr.swap(const_cast< QScopedPointer<TestItemPrivate>&>(other.d_ptr));
}

TestItem &TestItem::operator=(const TestItem &other)
{
    d_ptr.swap(const_cast< QScopedPointer<TestItemPrivate>&>(other.d_ptr));
    return *this;
}

QString TestItem::name() const
{
    C_D(TestItem);
    return d->name;
}

void TestItem::setName(const QString& name)
{
    Q_D(TestItem);
    if (name != d->name) {
        d->name = name;
        emit nameChanged();
    }
}

接下来我们定义一个数据管理类 ModelManager，其头文件如下：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: ModelManager.h
 ***************************************************************************/
#ifndef MODELMANAGER_H_0E42B205_5B88_5E39_84B8_6A36CED83E8A
#define MODELMANAGER_H_0E42B205_5B88_5E39_84B8_6A36CED83E8A

#include <QObject>

#include "ObjectModel.h"

class ModelManagerPrivate;

class ModelManager : public QObject
{
    Q_OBJECT
public:
    explicit ModelManager(QObject *parent = 0);
    ~ModelManager();

    Q_INVOKABLE void initData();
    Q_INVOKABLE ObjectModel* objectModel();
    Q_INVOKABLE void testInsert();

private:
    QScopedPointer<ModelManagerPrivate> d_ptr;
    Q_DECLARE_PRIVATE(ModelManager)
};

#endif // MODELMANAGER_H_0E42B205_5B88_5E39_84B8_6A36CED83E8A

实现文件如下：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: ModelManager.cpp
 ***************************************************************************/
#include "ModelManager.h"
#include <QThread>
#include <QDateTime>

#include "TestItem.h"

class ModelManagerPrivate
{
public:
    ModelManagerPrivate(ModelManager *parent)
        : q_ptr(parent)
        , objectModel(NULL)
    {
    }

    void init();
    void uninit();

private:
    ModelManager * const q_ptr;
    Q_DECLARE_PUBLIC(ModelManager)

    ObjectModel* objectModel;
    QThread workerThread;
};

ModelManager::ModelManager(QObject *parent) :
    QObject(parent),
    d_ptr(new ModelManagerPrivate(this))
{
    Q_D(ModelManager);
    d->init();
}

ModelManager::~ModelManager()
{
    Q_D(ModelManager);
    d->uninit();
}

void ModelManager::initData()
{
    Q_D(ModelManager);
    QObjectList testItemList;
    for (int i=0; i<5; ++i) {
        TestItem* newTestItem = new TestItem(this);
        testItemList.append(newTestItem);
    }
    d->objectModel->set(&testItemList);
}

ObjectModel *ModelManager::objectModel()
{
    Q_D(ModelManager);
    return d->objectModel;
}

void ModelManager::testInsert()
{
    Q_D(ModelManager);
    TestItem* newTestItem = new TestItem(this);
    newTestItem->setName(QString::number(QDateTime::currentMSecsSinceEpoch()));
    d->objectModel->append(newTestItem);
}

void ModelManagerPrivate::init()
{
    Q_Q(ModelManager);
    if (objectModel == NULL) {
        objectModel = new ObjectModel(q);
    }
}

void ModelManagerPrivate::uninit()
{
    if (objectModel) {
        objectModel->deleteLater();
        objectModel = NULL;
    }
}

接下来是用于测试的 main.cpp 文件的内容：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: main.cpp
 ***************************************************************************/
#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQmlContext>
#include <QQmlEngine>
#include <QQuickItem>

#include "ModelManager.h"
#include "ObjectModel.h"

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

    QQmlApplicationEngine engine;

    // 向 QML 域注册 ObjectModel 类
    qmlRegisterUncreatableType<ObjectModel, 1>("com.test.model", 1, 0,
                                               "ObjectModel",
                                               "Cannot create ObjectModel");

    ModelManager* modelMgr = new ModelManager(&app);
    engine.rootContext()->setContextProperty("modelMgr", modelMgr);

    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));

    // 初始化数据
    modelMgr->initData();

    int r = app.exec();

    if (modelMgr) {
        modelMgr->deleteLater();
        modelMgr = NULL;
    }

    return r;
}

至于 QML 文件就相对很简单了：

/***************************************************************************
    Copyright (C) 2017 by ZhaoDongshuang
    Author: ZhaoDongshuang
    Email: imtoby@126.com
    Date: 2017/11/07
    File: main.qml
 ***************************************************************************/
import QtQuick 2.3
import QtQuick.Window 2.2
import "qml/dialog"

Window {
    id: rootWindow
    visible: true
    width: 240
    height: 360

    ListView {
        anchors.fill: parent

        model: modelMgr.objectModel()

        delegate: Text {
            width: rootWindow.width
            height: 40
            text: model.modelData.name + index
        }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: {
            modelMgr.testInsert()
        }
    }
}

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 215,539评论 6赞 497
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 91,911评论 3赞 391
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 161,337评论 0赞 351
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 57,723评论 1赞 290
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 66,795评论 6赞 388
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 50,762评论 1赞 294
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 39,742评论 3赞 416
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 38,508评论 0赞 271
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 44,954评论 1赞 308
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 37,247评论 2赞 331
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 39,404评论 1赞 345
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 35,104评论 5赞 340
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 40,736评论 3赞 324
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 31,352评论 0赞 21
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 32,557评论 1赞 268
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 47,371评论 2赞 368
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 44,292评论 2赞 352

QML 中使用 QAbstractListModel 作为 ListView 的 model 实例

推荐阅读更多精彩内容