QAbstractTableModel 类

详细描述

QAbstractTableModel 为将数据表示为二维元素数组的模型提供了一种标准接口。它不直接使用，但必须被子类化。

由于模型提供的接口比 QAbstractItemModel 更专用，因此它不适用于使用树视图，尽管它可以用来提供数据给 QListView。如果您需要表示一个简单的项目列表，并且只需要一个包含单个数据列的模型的，可能更适合继承 QAbstractListModel。

函数rowCount() 和 columnCount() 返回表的维度。要检索对应于模型中项目的模型索引，请使用 index()，并只提供行和列号。

子类化

在子类化 QAbstractTableModel 时，您必须实现 rowCount()、columnCount() 和 dataindex() 和 parent() 函数。表现良好的模型还会实现 headerData().

可编辑模型需要实现 setData()，并实现 flags() 以返回包含 Qt::ItemIsEditable 的值。

提供对可调整大小的数据结构接口的模型可以提供 insertRows()、removeRows()、insertColumns() 和 removeColumns() 的实现。实现这些函数时，调用适当的函数非常重要，以确保所有已连接的视图都能意识到任何更改。

• insertRows() 实现必须在将新行插入到数据结构之前调用 beginInsertRows()，并且必须在插入新行后立即调用 endInsertRows()。
• insertColumns() 实现必须在将新列插入到数据结构之前调用 beginInsertColumns()，并且必须在插入新列后立即调用 endInsertColumns()。
• removeRows() 实现必须在从数据结构中删除行之前调用 beginRemoveRows()，并且必须在删除行之后立即调用 endRemoveRows()。
• removeColumns() 实现必须在从数据结构中删除列之前调用 beginRemoveColumns()，并且必须在删除列之后立即调用 endRemoveColumns()。

线程安全

作为 QObject 子类，QAbstractTableModel 不是 线程安全的。应仅在模型对象所在的线程中调用与 QAbstractTableModel 模型相关的 API。如果 QAbstractTableModel 与视图连接，这意味着 GUI 线程，因为这是视图所在的地方，并且它将从这个 GUI 线程调用到模型。使用后台线程填充或修改模型的内 容是可能的，但需要小心，因为后台线程不能直接调用任何模型相关的 API。相反，您应排队更新并将它们在主线程中应用。这可以通过 队列连接 来完成。