[转]QT Model View框架学习（三）
一、Model类
在model/view构架中，model为view和delegates使用数据提供了标准接口。在Qt中，标准接口QAbstractItemModel 类中被定义。不管数据在底层以何种数据结构存储，QAbstractItemModel 的子类会以层次结构的形式来表示数据，结构中包含了数据项表。我们按这种约定来访问model中的数据项，但这个约定不会对如何显示这些数据有任何限制。数据发生改变时，model通过信号槽机制来通知关联的views。
QAbstractItemModel *model = index.model ();
3、行与列
在最基本的形式中，一个model可作为一个简单的表来访问，每个数据项由行，列数来定位。这必不意味着底层的数据用数组结构来存储。行和列的使用仅仅是一种约定，它允许组件之间相互通讯。可以通过指定model中的行列数来获取任一项数据，可以得到与数据项一一对应的那个index。
QModelIndex index = model->index (row, column, ...);
Model为简单的，单级的数据结构如list与tables提供了接口，它们如上面代码所显示的那样，不再需要别的信息被提供。当我们在获取一个model index时，我们需要提供另外的信息。
QModelIndex indexA = model->index (0, 0, QModelIndex ());
QModelIndex indexB = model->index (1, 1, QModelIndex ());
QModelIndex indexC = model->index (2, 1, QModelIndex ());
一个model的顶级项,由QModelIndex()取得，它们上式被用作父项。
类似于表的接口在搭配使用table或list view时理想的，这种行列系统与view显示的方式是确切匹配的。
然则，像tree views这种结构需要model提供更为灵活的接口来访问数据项。每个数据项可能是别的项的父项，上级的项可以获取下级项的列表。
当获取model中数据项的index时，我们必须指定关于数据项的父项的信息。在model外部，引用一个数据项的唯一方法就是通过model index,因此需要在求取model index时指定父项的信息。
QModelIndex index = model->index (row, column, parent);
上图中，A项和C项作为model中顶层的兄弟项：
QModelIndex indexA = model->index (0, 0, QModelIndex());
QModelIndex indexC = model->index (2, 1, QModelIndex());
A有许多孩子，它的一个孩子B用以下代码获取：
QModelIndex indexB = model->index (1, 0, indexA);
5、项角色
model 中的项可以作为各种角色来使用，这允许为不同的环境提供不同的数据。举例来说，Qt::DisplayRole被用于访问一个字符串，它作为文本会在 view中显示。典型地，每个数据项都可以为许多不同的角色提供数据，标准的角色在Qt::ItemDataRole中定义。我们可以通过指定model index与角色来获取我们需要的数据：
QVariant value = model->data (index, role);
6、概念总结：
1，Model indexes为views与delegages提供model中数据项定位的信息，它与底层的数据结构无关。
2，通过指定行，列数，父项的model index来引用数据项。
3，依照别的组件的要求，model indexes被model构建。
4，使用index()时，如果指定了有效的父项的model index,那么返回得到的model index对应于父项的某个孩子。
5，使用index()时，如果指定了无效的父项的model index,那么返回得到的model index对应于顶层项的某个孩子。
6， 角色对一个数据项包含的不同类型的数据给出了区分。
QDirModel *model = new QDirModel ; QModelIndex parentIndex = model->index (QDir::currentPath()); int numRows = model->rowCount (parentIndex); for (int row = 0; row < numRows; ++row) { QModelIndex index = model->index (row, 0, parentIndex); tring text = model->data (index, Qt::DisplayRole).toString(); // Display the text in a widget. }
1，model的尺寸可以从rowCount ()与columnCount ()中得出。这些函数通常都需要一个表示父项的model index。
2，model indexes用来从model中访问数据项，数据项用行，列，父项model index定位。
3，为了访问model顶层项，可以使用QModelIndex ()指定。
4，数据项为不同的角色提供不同的数据。为了获取数据，除了model index之外，还要指定角色。
二、创建新的Models
1、介绍
model/view组件之间功能的分离，允许创建model利用现成的views。这也可以使用标准的功能 图形用户接口组件像QListView,QTableView和QTreeView来显示来自各种数据源的数据为。
QAbstractListModel类提供了非常灵活的接口，允许数据源以层次结构的形式来管理信息，也允许以某种
方式对数据进行插入、删除、修改和存储。它也提供了对拖拽操作的支持。
QAbstractListModel 与QAbstractTableModel 为简单的非层次结构的数据提供了接口，对于比较简单的list和table models来说，这是不错的一个开始点。
2、设计一个Model
当我们为存在的数据结构新建一个model时，首先要考虑的问题是应该选用哪种model来为这些数据提供接口。
假如数据结构可以用数据项的列表或表来表示，那么可以考虑子类化QAbstractListModel 或QAbstractTableModel
,既然这些类已经合理地对许多功能提供缺省实现。
然而，假如底层的数据结构只能表示成具有层次结构的树型结构，那么必须得子类化QAbstractItemModel 。
无论底层的数据结构采取何种形式，在特定的model中实现标准的QAbstractItemModel API总是一个不错的主意，这使得可以使用更自然的方式对底层的数据结构进行访问。这也使得用数据构建model 更为容易，其他
的model/view组件也可以使用标准的API与之进行交互。
3、一个只读model示例
这个示例实现了一个简单的，非层次结构的，只读的数据model,它基于QStringistModel 类。它有一个QStringList 作为它内部的数据源，只实现了一些必要的接口。为了简单化，它子类化了QAbstractListModel ,这个基类提供了合理的缺省行为，对外提供了比QAbstractItemModel 更为简单的接口。当我们实现一个model时，不要忘了QAbstractItemModel 本身不存储任何数据，它仅仅提供了给views访问
数据的接口。
class StringListModel : public QAbstractListModel
{
Q_OBJECT
public:
StringListModel (const QStringList &strings, QObject *parent = 0)
: QAbstractListModel (parent), stringList(strings) {}
int rowCount (const QModelIndex &parent = QModelIndex()) const;
QVariant data (const QModelIndex &index, int role) const;
QVariant headerData (int section, Qt::Orientation orientation,
int role = Qt::DisplayRole) const;
private:
QStringList stringList;
};
除了构造函数，我们仅需要实现两个函数：rowCount ()返回model中的行数，data ()返回与特定model index对应的数据项。具有良好行为的model也会实现headerData ()，它返回tree和table views需要的，在标题中显示的数据。
因为这是一个非层次结构的model,我们不必考虑父子关系。假如model具有层次结构，我们也应该实现index ()与parent ()函数。
4、Model的尺寸
我们认为model中的行数与string list中的string数目一致：
int StringListModel ::rowCount (const QModelIndex &parent) const
{
return stringList.count();
}
在缺省情况下，从QAbstractListModel 派生的model只具有一列，因此不需要实现columnCount()。
5、Model 标题与数据
QVariant StringListModel ::data (const QModelIndex &index, int role) const { if (!index.isValid()) return QVariant(); if (index.row() >= stringList.size()) return QVariant(); if (role == Qt::DisplayRole) return stringList.at(index.row()); else return QVariant(); } QVariant StringListModel ::headerData (int section, Qt::Orientation orientation, int role) const { if (role != Qt::DisplayRole) return QVariant(); if (orientation == Qt::Horizontal) return QString("Column %1").arg(section); else return QString("Row %1").arg(section); }
一个数据项可能有多个角色，根据角色的不同输出不同的数据。上例中，model中的数据项只有一个角色 ，
DisplayRole,然而我们也可以重用提供给DisplayRole的数据，作为别的角色使用，如我们可以作为ToolTipRole来用。
6、可编辑的model
上面我们演示了一个只读的model,它只用于向用户显示，对于许多程序来说，可编辑的list model可能更有用。我们只需要给只读的model提供另外两个函数flags()与setData()的实现。下列函数声明被添加到类定义中：
Qt::ItemFlags flags (const QModelIndex &index) const;
bool setData (const QModelIndex &index, const QVariant &value,
int role = Qt::EditRole);
6.1 让model可编辑
delegate会在创建编辑器之前检查数据项是否是可编辑的。model必须得让delegate知道它的数据项是可编辑的。这可以通过为每一个数据项返回一个正确的标记得到，在本例中，我们假设所有的数据项都是可编辑可选择的：
Qt::ItemFlags StringListModel ::flags (const QModelIndex &index) const { if (!index.isValid()) return Qt::ItemIsEnabled; return QAbstractItemModel ::flags(index) | Qt::ItemIsEditable; }
我们不必知道delegate执行怎样实际的编辑处理过程，我们只需提供给delegate一个方法，delegate会使用它对model中的数据进行设置。这个特殊的函数就是setData():
bool StringListModel ::setData (const QModelIndex &index, const QVariant &value, int role) { if (index.isValid() && role == Qt::EditRole) { stringList.replace(index.row(), value.toString()); emit dataChanged (index, index); return true; } return false; }
因为只有一个数据项发生了变化，因此在信号中说明的变化范围只限于一个model index。
6.2 插入，删除行
在model中改变行数与列数是可能的。当然在本列中，只考虑行的情况，我们只需要重新实现插入、删除
的函数就可以了，下面应在类定义中声明：
bool insertRows (int position, int rows, const QModelIndex &index = QModelIndex());
bool removeRows (int position, int rows, const QModelIndex &index = QModelIndex());
既然model中的每行对应于列表中的一个string,因此，insertRows()函数在string list 中指定位置插入一个空string，父index通常用于决定model中行列的位置，本例中只有一个单独的顶级项，因此只需要在list中插入空string。
bool StringListModel ::insertRows(int position, int rows, const QModelIndex &parent) { beginInsertRows (QModelIndex(), position, position+rows-1); for (int row = 0; row < rows; ++row) { stringList.insert(position, ""); } endInsertRows (); return true; }
删除操作与插入操作类似：
bool StringListModel ::removeRows(int position, int rows, const QModelIndex &parent) { beginRemoveRows (QModelIndex(), position, position+rows-1); for (int row = 0; row < rows; ++row) { stringList.removeAt(position); } endRemoveRows (); return true; }
浙公网安备 33010602011771号