文章目录
- 详述
-
- 子类化
- 公共函数
- 重新实现的公用函数
- 总结
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和项目视图的谜题示例。
公共函数
- QAbstractListModel(QObject *parent = nullptr)
- virtual ~QAbstractListModel()
重新实现的公用函数
- virtual bool dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override
- virtual Qt::ItemFlags flags(const QModelIndex &index) const override
- virtual QModelIndex index(int row, int column = 0, const QModelIndex &parent = QModelIndex()) const override
- virtual QModelIndex sibling(int row, int column, const QModelIndex &idx) const override
总结
该模型适合QListView视图类使用，另外Qt提供了该类的子类 QStringListModel。