当前位置 博文首页 > Allen Roson:QT QAbstractListModel
QAbstractListModel类提供了一个抽象模型,可以将其子类化以创建一维列表模型。
Header: #include <QAbstractListModel>
qmake: QT += core
Inherits: QAbstractItemModel.
Inherited By:
QStringListModel.
QAbstractListModel类提供了一个抽象模型,可以将其子类化以创建一维列表模型。
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()。
注意:模型子类化参考中提供了一些关于模型子类化的一般指导原则。
另请参见?Model Classes、?Model Subclassing Reference、QAbstractItemView、QAbstractTableModel和Item Views Puzzle Example。
?
QAbstractListModel::QAbstractListModel(QObject * parent = 0)
构造具有给定父级的抽象列表模型。
QAbstractListModel::~QAbstractListModel()
破坏抽象列表模型。
[virtual] bool QAbstractListModel::dropMimeData(const QMimeData * data, Qt::DropAction action, int row, int column, const QModelIndex & parent)
从QAbstractItemModel::dropMimeData()重新实现。
[virtual] Qt::ItemFlags QAbstractListModel::flags(const QModelIndex & index) const
从QAbstractItemModel::flags()重新实现。
[virtual] QModelIndex QAbstractListModel::index(int row, int column = 0, const QModelIndex & parent = QModelIndex()) const
从QAbstractItemModel::index()重新实现。
返回具有父级的行和列中数据的索引。
另请参见parent()。.