类QabstractItemModel,QabstractListModel,QAbstractTableModel不保存数据,用户需要从这些类派生出子类,并在子类中定义某种数据结构来保存数据。与此不同,类QStandardItemModel负责保存数据,每个数据项被表示为类QStandardItem的对象。
创新新互联,凭借十载的网站建设、成都网站建设经验,本着真心·诚心服务的企业理念服务于成都中小企业设计网站有上千多家案例。做网站建设,选创新互联公司。
我们首先阐述如何使用类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定义的接口函数,以使其他视图类能够访问模型中的数据项。 如果数据集被表示为一个列表,我们可以调用类QStandardItemModel的成员函数appendRow()向列表中添加一个数据项,使用item()读取一个数据项,如代码段13 10所示。
行①获取模型最顶层的根节点,
行②创建一个QStandardItem对象,表示一个数据项,
行③将该数据项作为根节点的子节点添加到列表中。行②的构造函数在内部调用该类的setData()函数,将行②的QString对象作为Qt::DisplayRole对应的数据子项存入新构造的对象。由于数据集本身是一个列表,所以我们使用QListView显示该数据集,读者可以运行该例子查看显示结果。 代码段13 10,使用QStandardItemModel处理列表,取自z:\examples\mvc\QStandardItemModel_demo\main.cpp
QStandardItemModel listModel; QStandardItem *rootItem = listModel.invisibleRootItem();//1 for (int row = 0; row < 4; ++row) { QStandardItem *item = new QStandardItem(QString("%0").arg(row) );//2 rootItem->appendRow( item );//3 } QListView listView; listView.setModel ( & listModel );
如果数据集被表示为一个表格,可以调用类QStandardItemModel的成员函数setItem()设定表格中的某个数据项,如代码段13 11所示。由于这个代码段中的数据集是一个表格,所以使用QTableView显示该数据集。 代码段13 11,使用QStandardItemModel处理表格,取自z:\examples\mvc\QStandardItemModel_demo\main.cpp
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 );
如果数据集被表示为一个树,可以调用类QStandardItemModel的成员函数appendRow()向某个树节点添加子节点。通过多次调用该函数,可以构建一棵复杂的树。代码段13 12构建一棵简单的树:最顶层的根节点有一个文字内容为“0”的子节点,该子节点有一个文字内容为“1”的子节点。依此类推,“1”子节点有一个“2”子节点,“2”子节点有一个“3”子节点,形成一棵深度为4的树。这棵树的每个节点都没有兄弟节点(具有相同父节点的多个节点被相互称为兄弟节点),感兴趣的读者可以修改这段代码,以使其中某些节点具有兄弟节点。由于数据集是一棵树,我们使用QTreeView显示它。 代码段13 12,使用QStandardItemModel处理树,取自z:\examples\mvc\QStandardItemModel_demo\main.cpp
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
使用QStandardItemModel表示数据集具有以下优点:该类使用QStandardItem存放数据项,用户不必定义任何数据结构来存放数据项;QStandardItem使用自关联关系,能够表达列表、表格、树甚至更复杂的数据结构,能够涵盖各种各样的数据集;QStandardItem本身存放着多个『角色,数据子项』,视图类、委托类或者其他用户定义的类能够方便地依据角色访问各个数据子项。 然而,这种表示方法也有局限性:当数据集中的数据项很多时,施加在数据集上的某些操作的执行效率会很低。比如,设数据集是一个1万行、20列的表格,其中第10列存放的是浮点数。如果我们想计算这一列的平均值,按照图13 14,这需要遍历所有行,取得第10列的QStandardItem对象,再依据角色“Qt::DisplayRole”取得对应的数据子项。由于这个数据子项的类型为QString,还需要将其转换为浮点数,最后求所有浮点数的平均值。这些操作会耗费较长的时间。 因此,对于数据量不是很大、对性能要求不是很高的场合,我们可以使用类QStandardItemModel来表示一个数据集。否则,用户应该从QAbstractItemModel、QAbstractListModel或者QAbstractTableModel派生新类,自行管理数据集的存放与访问。