模型视图(04)：【类】QAbstractListModel[官翻]

QAbstractListModel 类

QAbstractListModel类提供了一个抽象模型，可以通过子类化创建一维列表模型。

Header:	#include < QAbstractListModel >
qmake:	QT += core
Inherits:	QAbstractItemModel
Inherited By:	QStringListModel

详述

QAbstractListModel为模型提供了一个标准接口，该模型将其数据表示为简单的非层次结构的项序列。它不直接使用，但必须被子类化。

由于该模型提供了一个比QAbstractItemModel更专门的接口，因此它不适合与树视图一起使用;如果您想为此目的提供一个模型，那么您将需要子类化QAbstractItemModel。如果您需要使用许多列表模型来管理数据，那么使用QAbstractTableModel子类可能更合适。

通过子类化这个类并实现所需函数的最小数量，可以创建简单的模型。例如，我们可以实现一个简单的只读的基于qstringlist的模型，它为QListView小部件提供一个字符串列表。在这种情况下，我们只需要实现rowCount()函数来返回列表中的项数，以及data()函数来从列表中检索项。

因为模型表示一维结构，所以rowCount()函数返回模型中的项目总数。columnCount()函数是为了与所有类型的视图互操作性而实现的，但是默认情况下，它通知视图模型只包含一列。

子类化

在子类化QAbstractListModel时，必须提供rowCount()和data()函数的实现。行为良好的模型还提供了headerData()实现。

如果您的模型是在QML中使用的，并且需要roleNames()函数提供的默认角色以外的角色，那么您必须覆盖它。

对于可编辑列表模型，您还必须提供setData()的实现，并实现flags()函数，以便它返回包含Qt::ItemIsEditable的值。
注意，QAbstractListModel提供了columnCount()的默认实现，它通知视图该模型中只有一列项。

为可调整大小的类列表数据结构提供接口的模型可以提供insertRows()和removeRows()的实现。当实现这些函数时，调用适当的函数是很重要的，这样所有连接的视图都能意识到任何变化:

• insertRows()实现必须在向数据结构中插入新行之前调用beginInsertRows()，之后必须立即调用endInsertRows()。
• removeRows()实现必须在从数据结构中删除行之前调用beginRemoveRows()，它必须在随后立即调用endRemoveRows()。

注意:在模型子类化参考中有一些关于模型子类化的一般指南。

请参阅模型类、模型子类化引用、QAbstractItemView、QAbstractTableModel和项目视图的谜题示例。

公共函数

1. QAbstractListModel(QObject *parent = nullptr)
2. virtual ~QAbstractListModel()

重新实现的公用函数

1. virtual bool dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override
2. virtual Qt::ItemFlags flags(const QModelIndex &index) const override
3. virtual QModelIndex index(int row, int column = 0, const QModelIndex &parent = QModelIndex()) const override
4. virtual QModelIndex sibling(int row, int column, const QModelIndex &idx) const override

总结

该模型适合QListView视图类使用，另外Qt提供了该类的子类 QStringListModel。