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()。