Qt开发用于表格QTableView的模型

　　如果想使用表格来呈现数据，Qt提供了一个方便的部件QTableWidget，但是直接用它实现一些功能可能比较困难。这里将介绍一种强大、灵活的方式来操作表格。  一、模型/视图架构
　　在这个架构中，  模型  用于存储数据，  视图  用于呈现数据，除此之外，还有一个称为  委托  的部分，委托显示视图中的每一项，并为可编辑的项提供合适的编辑器。
　　三者的关系如下图所示——
　　这篇博客只介绍模型/视图的部分，接下来用一个简单的例子来说明如何使用。  二、要实现的功能
　　以网易云音乐为例，它的部分搜索界面是这样的：
　　现在，我们依照网易云音乐做一个下面的窗口，并实现额外的一些功能。
　　要实现的功能：
　　1.  网上搜索  ：从网上搜索歌曲的数据并呈现在左边的表格中；
　　2.  本地搜索并选中  ：在左边的表格中进行搜索，  选中  与关键字相匹配的行；
　　3.  本地搜索并过滤  ：在左边的表格中进行搜索，只显示与关键字相匹配的行，过滤隐藏不匹配的行。  三、联网搜索1.准备工作
　　左边的表格使用   QTableView   。
　　为了存储数据，需要使用合适的模型，在这里我们使用   QStandardItemModel   。
　　同时为了实现过滤，需要另一个代理模型   QSortFilterProxyModel   。//数据模型 class MusicInfoModel : public QStandardItemModel { public: void loadData(const QString &strKeyword);//用于加载网上搜索得到的数据 } //主窗口 class MainWidget : public QWidget { private slots: void searchOnlineSlot(); //网上搜索 void searchAndSelcLocalSlot(); //本地搜索并选择 void searchAndFilterLocalSlot(); //本地搜索并过滤 private: MusicInfoModel *m_pInfoModel; //数据模型 QSortFilterProxyModel *m_pFilterModel; //过滤代理模型 }
　　以上只列出重要的成员变量和成员函数。
　　为了方便加载数据，我们将QStandardItemModel  子类化  ，在子类中声明一个加载数据的函数   loadData   。
　　在主窗口的构造函数中初始化视图和模型——  m_pInfoModel = new MusicInfoModel(this); m_pFilterModel = new QSortFilterProxyModel(this); m_pFilterModel->setSourceModel(m_pInfoModel); ui.musicInfoTblView->setModel(m_pFilterModel);
　　从上面可以看到，表格的视图模型是代理模型filterModel，而不是实际包含数据的模型infoModel。  2.加载数据
　　接下来网上搜索，获得数据并加载到表格中
　　首先定义歌曲信息的数据结构  //歌曲信息的数据结构 struct SongInfo { public: QString strName; //歌曲标题 QString strSinger; //歌手名字 QString strAlbum; //专辑名称 };
　　完成数据模型中加载数据的函数：  void MusicInfoModel::loadData(const QString &strKeyword) { QList listSongInfo; //歌曲信息的list //...省略的步骤 //根据关键字strKeyword从网上搜索 //并将搜索结果存储到listSongInfo中 //清除数据模型中之前存在的数据，并重新设置表头（因为clear会把表头也清除掉） clear(); setHorizontalHeaderLabels(QStringList() << QString::fromLocal8Bit(＂音乐标题＂) << QString::fromLocal8Bit(＂歌手＂) << QString::fromLocal8Bit(＂专辑＂)); //遍历list，将数据存在表中 for (SongInfo songItem : listSongInfo) { QList listItems; QStandardItem *pTitle = new QStandardItem(songItem.strName); QStandardItem *pSinger = new QStandardItem(songItem.strSinger); QStandardItem *pAlbum = new QStandardItem(songItem.strAlbum); listItems << pTitle << pSinger << pAlbum; appendRow(listItems);//加载一行数据 } } 注意：表中的每一项是一个QStandardItem，在加载一行之前，需要先把他们存储在一个QList中，然后调用appendRow函数，一次完成加载3列。
　　接下来，我们在主界面中调用数据模型对象的loadData函数，即可将数据全部填到表格中。  四、本地搜索并过滤
　　过滤很简单，只需要使用  QSortFilterProxyModel  中的相关函数。  void MainWidget::searchAndFilterLocalSlot() { QString strKeyword = ui.textEdit->text(); m_pFilterModel->setFilterFixedString(strKeyword);//根据字符串过滤 }
　　一些有用的函数：
　　void setFilterKeyColumn(int column)   ：设置根据表的哪一列进行过滤，默认值为0，如果设置成-1，则会根据所有列进行搜索。
　　setFilterFixedString(const QString &)   ：根据固定的字符串进行过滤。
　　setFilterRegExp(const QRegExp &)   ：根据正则表达式进行过滤。五、本地搜索并选中void MainWidget::searchAndSelcLocalSlot() { QItemSelection selection; int iFirstSelcRow = -1; for (int i = 0; i < m_pFilterModel->rowCount(); ++i) { //获得每一行的歌名、歌手名、专辑名 QModelIndex songIndex = m_pFilterModel->index(i, 0); QModelIndex singerIndex = m_pFilterModel->index(i, 1); QModelIndex albumnIndex = m_pFilterModel->index(i, 2); QString strSong = m_pFilterModel->data(songIndex).toString(); QString strSinger = m_pFilterModel->data(singerIndex).toString(); QString strAlbumn = m_pFilterModel->data(albumnIndex).toString(); //判断是否符合条件 if (strSong.contains(strKeyword) || strSinger.contains(strKeyword) || strAlbumn.contains(strKeyword)) { if (iFirstSelcRow == -1) { iFirstSelcRow = i; } //增加选中项 QItemSelection rowSelc(songIndex, songIndex); selection.merge(rowSelc, QItemSelectionModel::Select); } } //清除之前所有选中项，并选中现在的所有匹配项 QItemSelectionModel *pSelcModel = ui.musicInfoTblView->selectionModel(); pSelcModel->clearSelection(); pSelcModel->select(selection, QItemSelectionModel::Rows | QItemSelectionModel::Select); //视图滚动到第一个选中项的位置 if (iFirstSelcRow != -1) { ui.musicInfoTblView->scrollTo(m_pFilterModel->index(iFirstSelcRow, 0)); } }
　　最终的简陋窗口：
　　以上只是视图/模型的使用作简单介绍，更多用法还请在实践中自行查找官方文档。
　　点击领取Qt学习资料+视频教程~「链接」