Qt 常用类——QStandardItemModel

转载：落叶知秋时

类QabstractItemModel，QabstractListModel，QAbstractTableModel不保存数据，用户需要从这些类派生出子类，并在子类中定义某种数据结构来保存数据。

与此不同，类QStandardItemModel负责保存数据，每个数据项被表示为类QStandardItem的对象。接下来，我们主要从两个方面介绍类QStandardItemMode的内容。

首先阐述如何使用类QStandardItem保存一个数据项，
再阐述如何使用类QStandardItemModel将这些数据项组织起来，形成列表、表格或者树，以供其他视图类显示。

首先来看第一方面：

如前文所述，一个数据项由若干个『角色，数据子项』对组成。类QStandardItem负责保存、访问这些数据。该类的内部定义了一个类型为QVector的容器，

每个容器元素本质上存放一个『角色，数据子项』对。由于各个角色对应的数据子项可能具有不同的类型，Qt使用QVariant来存放每个数据子项。

当用户希望将一些数据存放在一个QStandardItem对象中时，可以调用其成员函数：

void setData ( const QVariant & value, int role)    //将『role, value』对存入。

当用户希望读取该对象中的数据时，可以调用另外一个成员函数：

QVariant data ( int role = ) const    //读取角色role对应的数据子项。

以上两个函数是QStandardItem的核心。有了这两个函数，我们就可以访问该类所表示数据项的任何一个『角色，数据子项』对。然而，对于一些常用角色，

该类提供了更加简洁、容易记忆的成员函数。例如，当一个数据项被显示在视图中时，它往往包含一些文字、一个图标，还可能包含一个复选框。

常用角色：

Qt::BackgroundRole控制显示背景，
Qt::FontRole控制文字字体，
Qt::ForegroundRole控制文字颜色，
Qt::CheckStateRole控制复选框的状态。

该类提供的一组成员函数可以方便地访问这些常用角色对应的数据子项：

成员函数setBackground()、background()分别设置/返回背景刷子。
函数setFont()、font()分别设置/返回文字字体。
函数setForeground()、foreground()分别设置/返回字体颜色。
函数setCheckState()、checkState()分别设置/返回复选框状态。

然后再来看第二方面：

类QStandardItemModel将类QStandardItem表示的数据项组织起来，形成列表、表格、树甚至更复杂的数据结构。

该类提供了一组成员函数，向这些数据结构添加新的数据项，更改已经存在的数据项，或者删除已有的数据项。
另一方面，作为一个模型类，它实现了QAbstractItemModel定义的接口函数，以使其他视图类能够访问模型中的数据项。

1：如果数据集被表示为一个列表，我们可以调用类QStandardItemModel的成员函数appendRow()向列表中添加一个数据项，使用item()读取一个数据项。

如代码段13-10所示。

行①获取模型最顶层的根节点，
行②创建一个QStandardItem对象，表示一个数据项，
行③将该数据项作为根节点的子节点添加到列表中。

行②的构造函数在内部调用该类的setData()函数，将行②的QString对象作为Qt::DisplayRole对应的数据子项存入新构造的对象。

由于数据集本身是一个列表，所以我们使用QListView显示该数据集，读者可以运行该例子查看显示结果。

代码段13-10：使用QStandardItemModel处理列表

    QStandardItemModel listModel;QStandardItem *rootItem = listModel.invisibleRootItem();    //    行1for (int row = 0; row < 4; ++row){
QStandardItem *item = new QStandardItem(QString("%1").arg(row) );    //    行2rootItem->appendRow( item );    //行3}QListView listView;listView.setModel ( & listModel );

2：如果数据集被表示为一个表格，可以调用类QStandardItemModel的成员函数setItem()设定表格中的某个数据项，如代码段13-11所示。

由于这个代码段中的数据集是一个表格，所以使用QTableView显示该数据集。

代码段13-11：使用QStandardItemModel处理表格

    QStandardItemModel tableModel(4, 4);for (int row = 0; row < 4; ++row){for (int column = 0; column < 4; ++column) {QStandardItem *item = new QStandardItem(QString("%0,%1").arg(row).arg(column));tableModel.setItem(row, column, item);}}QTableView tableView;tableView.setModel( & tableModel );

3：如果数据集被表示为一个树，可以调用类QStandardItemModel的成员函数appendRow()向某个树节点添加子节点。

通过多次调用该函数，可以构建一棵复杂的树。代码段13-12构建一棵简单的树：最顶层的根节点有一个文字内容为“0”的子节点，

该子节点有一个文字内容为“1”的子节点。依此类推，“1”子节点有一个“2”子节点，“2”子节点有一个“3”子节点，形成一棵深度为4的树。

这棵树的每个节点都没有兄弟节点（具有相同父节点的多个节点被相互称为兄弟节点），感兴趣的读者可以修改这段代码，以使其中某些节点具有兄弟节点。

由于数据集是一棵树，我们使用QTreeView显示它。

代码段13-12，使用QStandardItemModel处理树：

QStandardItemModel treeModel;
QStandardItem *parentItem = treeModel.invisibleRootItem();
for (int i = 0; i < 4; ++i) {QStandardItem *item = new QStandardItem(QString("%0").arg(i));parentItem->appendRow(item);parentItem = item;
}
QTreeView treeView;
treeView.setModel( & treeModel );

类QStandardItemModel之所以能够表示列表、表格、树甚至更复杂的数据结构，得益于类QStandardItem在其内部定义了一个类型为

QVector<QStandardItem*>的容器，可以将每个容器元素所指的QStandardItem对象设定为子对象。表现在如图13-13所示的类图上，类QStandardItem和自身具有“children”关系。一个类和自身发生关联，在UML中被称为自关联（self association）。类QStandardItemModel定义了一个名为root的数据成员，逻辑上是一个指向QStandardItem对象的指针。这个对象可以设定多个QStandardItem的对象作为自己的子对象，而其中每个子对象又可以包含其他的子对象。依此类推，这棵树可以具有任意深度，每个父对象可以包含任意多个子对象。

很自然地，QStandardItemModel可以使用QStandardItem表示具有树状数据结构的数据集，如图13-14所示。

图中的每个小方框表示类QStandardItem的一个对象。如果小方框的边线为虚，相应的QStandardItem对象并不表示数据集中的任何数据，仅被用来表示某种数据结构。如果小方框的边线为实，相应的QStandardItem对象就表示数据集中的一个数据项。在右侧的图中，QStandardItemModel的数据成员root所指的对象表示一个不可见的根，而数据集的根（图中结点G）被表示为这个不可见根的一个子节点。