QStandardItmeModel

表格视图控件QTableView，需要和QStandardItemModel, 配套使用，这套框架是基于MVC设计模式设计的，M(Model)是QStandardItemModel数据模型，

不能单独显示出来。V(view)是指QTableView视图，要来显示数据模型，C(controllor)控制在Qt中被弱化，与View合并到一起。

1 QTableView简单应用

QStandardItmeModel表格的数据模型，那么这个模型需要填上每一行每一列的数据，就像execl表格一样。

widget.h

1. #ifndef WIDGET_H
2. #define WIDGET_H​
4. #include <QTableView>
5. class Widget : public QTableView //继承至QTableView
6. {
7. Q_OBJECT
8. public:
9. Widget(QWidget *parent = );
10. ~Widget();
11. };
12. #endif // WIDGET_H

widget.cpp

1. #include "widget.h"
2. #include <QStandardItemModel>
3. #include <QDebug>
4. Widget::Widget(QWidget *parent)
5. : QTableView(parent)
6. {
7. QStandardItemModel* model = new QStandardItemModel(this);
8. model->setItem(, , new QStandardItem("张三"));
9. model->setItem(, , new QStandardItem(""));
10. model->setItem(, , new QStandardItem("男"));
11. this->setModel(model);
12. }
14. Widget::~Widget()
15. {
17. }

以上代码实现了在model中添加一条数据，然后通过setModel函数设置view的数据模型为model，显示出来，如图：

2 修改行列字段名

修改字段名可以使用QStandardItemModel::setHeaderData，但是在这之前你需要调用QStandardItemModel::setColumnCount和QStandardItemModel::setRowCount，例如：

1. Widget::Widget(QWidget *parent)
2. : QTableView(parent)
3. {
4. QStandardItemModel* model = new QStandardItemModel(this);
5. /*设置列字段名*/
6. model->setColumnCount();
7. model->setHeaderData(,Qt::Horizontal, "姓名");
8. model->setHeaderData(,Qt::Horizontal, "年龄");
9. model->setHeaderData(,Qt::Horizontal, "性别");
10. /*设置行字段名*/
11. model->setRowCount();
12. model->setHeaderData(,Qt::Vertical, "记录一");
13. model->setHeaderData(,Qt::Vertical, "记录二");
14. model->setHeaderData(,Qt::Vertical, "记录三");
16. /*设置一条数据*/
17. model->setItem(, , new QStandardItem("张三"));
18. model->setItem(, , new QStandardItem(""));
19. model->setItem(, , new QStandardItem("男"));
20. this->setModel(model);
21. }

把1中的构造函数换为以上代码，运行即可得出下图：

3 移除数据

移除数据的常用函数有：

1. /*移除某行数据*/
2. bool QAbstractItemModel::removeRow(int row, const QModelIndex &parent = QModelIndex())
3. /*移除某列数据*/
4. bool QAbstractItemModel::removeColumn(int column, const QModelIndex &parent = QModelIndex())

例如：

1. model->removeRow();//移除第0行数据
2. model->removeColumn();//移除第0列数据

4 插入数据

插入一行数据：

1. void QStandardItemModel::insertRow(int row, const QList<QStandardItem *> &items)
2. /*
3. * row 表示从第几行插入数据
4. * items 表示要插入的数据QStandardItem对象
5. */

例如：

1. QList<QStandardItem*> list;
2. list << new QStandardItem("王五") << new QStandardItem("") << new QStandardItem("男");
3. model->insertRow(, list); //在第0行插入一条记录

5 数据变更信号处理

当QStandardModel中的数据被更改的时候，会发射出dataChanged信号:

1. [signal] void QAbstractItemModel::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles = QVector<int> ());
2. ​
3. /*
4. *topLeft bottomRight这两索引指的是表格中被更改数据的区域，如果只有一个数据被更改，那么topLeft等于bottomRight
5. */

例如：

widget.h

1. #ifndef WIDGET_H
2. #define WIDGET_H​
3. #include <QTableView>
4. class QStandardItemModel;
5. class Widget : public QTableView
6. {
7. Q_OBJECT
8. public slots:
9. void dataChangedSlot(const QModelIndex &topLeft, const QModelIndex &bottomRight,
10. const QVector<int> &roles = QVector<int> ());
11. public:
12. Widget(QWidget *parent = );
13. QStandardItemModel* model;
14. ~Widget();
15. };
16. #endif // WIDGET_H

widget.cpp

1. #include "widget.h"
2. #include <QStandardItemModel>
3. #include <QDebug>
4. Widget::Widget(QWidget *parent)
5. : QTableView(parent)
6. {
7. model = new QStandardItemModel(this);
8. model->setColumnCount();
9. model->setHeaderData(,Qt::Horizontal, "姓名");
10. model->setHeaderData(,Qt::Horizontal, "年龄");
11. model->setHeaderData(,Qt::Horizontal, "性别");
12. model->setRowCount();
13. model->setHeaderData(,Qt::Vertical, "记录一");
14. model->setHeaderData(,Qt::Vertical, "记录二");
15. model->setHeaderData(,Qt::Vertical, "记录三");
16. model->setItem(, , new QStandardItem("张三"));
17. model->setItem(, , new QStandardItem(""));
18. model->setItem(, , new QStandardItem("男"));
19. connect(model, SIGNAL(dataChanged(QModelIndex,QModelIndex,QVector<int>)), this, SLOT(dataChangedSlot(QModelIndex,QModelIndex,QVector<int>)));
20. this->setModel(model);
21. }
22. void Widget::dataChangedSlot(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles)
23. {
24. qDebug() << model->data(topLeft).toString() << endl;
25. }
26. Widget::~Widget()
27. {
28. }

需要知道的是函数data可以获取想要的QStandardItem对象的索引：

1. [pure virtual] QVariant QAbstractItemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

返回的QVariant对象是一种泛型变量，可以转换成QString、int、double等数据类型。

6 常用函数

1. //默认显示行头，如果你觉得不美观的话，我们可以将隐藏
2. tableview->verticalHeader()->hide();
3. ​
4. //设置选中时为整行选中
5. tableview->setSelectionBehavior(QAbstractItemView::SelectRows);
7. //设置表格的单元为只读属性，即不能编辑
8. tableview->setEditTriggers(QAbstractItemView::NoEditTriggers);
9. ​
10. //返回一个被选中的所有Item的索引,一般是去遍历这个链表进行处理
11. [virtual protected] QModelIndexList QTableView::selectedIndexes() const

7 QStandardItem被点选信号

当QStandardItemModel中的某个QStandardItem被点选后，QStandardItemModel对象会发出一个信号:

1. void QAbstractItemView::clicked(const QModelIndex &index);
2. /*
3. *返回被点选的Item的索引
4. */

8 QItemDelegate代理

QTableView在处理信息显示编辑的时候比较单调，类似行编辑器，为了获得更多的灵性性，交互通过QItemDelegate执行。

​ 下面通过派生一个SpinDelegate来实现一个整数旋转框的代理器。

​ 一般我们要重写函数createEditor：

1. [virtual] QWidget *QItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
2. /*
3. *QWidget *parent一般是指哪个窗口使用了这个代理,一般用来托管内存
4. * QStyleOptionViewItem &option 样式风格
5. * const QModelIndex &index 需要更改的Item索引
6. */

widget.h

1. #ifndef WIDGET_H
2. #define WIDGET_H
3. #include <QTableView>
5. class QStandardItemModel;
7. class Widget : public QTableView
8. {
9. Q_OBJECT
10. public slots:
11. void dataChangedSlot(const QModelIndex &topLeft, const QModelIndex &bottomRight,
12. const QVector<int> &roles = QVector<int> ());
13. public:
14. Widget(QWidget *parent = );
15. QStandardItemModel* model;
16. ~Widget();
17. };
19. #endif

widget.cpp

1. #include "widget.h"
2. #include "spindelegate.h"
3. #include <QStandardItemModel>
4. #include <QDebug>
6. Widget::Widget(QWidget *parent)
7. : QTableView(parent)
8. {
9. model = new QStandardItemModel(this);
10. //设置列字段名
11. model->setColumnCount();
12. model->setHeaderData(,Qt::Horizontal,"姓名");
13. model->setHeaderData(,Qt::Horizontal,"年龄");
14. model->setHeaderData(,Qt::Horizontal,"性别");
15. //设置行字段名
16. model->setRowCount();
17. model->setHeaderData(,Qt::Vertical, "记录一");
18. model->setHeaderData(,Qt::Vertical, "记录二");
19. model->setHeaderData(,Qt::Vertical, "记录三");
20. //设置一条数据
21. model->setItem(, , new QStandardItem("张三"));
22. model->setItem(, , new QStandardItem(""));
23. model->setItem(, , new QStandardItem("男"));
24. this->setModel(model);
25. //设置代理
26. this->setItemDelegate(new SpinDelegate(this));
27. connect(model, SIGNAL(dataChanged(QModelIndex,QModelIndex,QVector<int>)),
28. this,SLOT(dataChangedSlot(QModelIndex,QModelIndex,QVector<int>)));
29. this->setModel(model);
31. }
33. void Widget::dataChangedSlot(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles)
34. {
35. qDebug() << model->data(topLeft).toString() << endl;
36. }
37. Widget::~Widget()
38. {
39. }

spinDelegate.h

1. #ifndef SPINDELEGATE_H
2. #define SPINDELEGATE_H
3. #include <QItemDelegate>
5. class SpinDelegate : public QItemDelegate
6. {
7. public:
8. SpinDelegate(QObject *parent = Q_NULLPTR);
9. QWidget* createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const;
10. };
12. #endif // SPINDELEGATE_H

spinDelegate.cpp

1. #include "spindelegate.h"
2. #include <QSpinBox>
3. SpinDelegate::SpinDelegate(QObject *parent): QItemDelegate(parent)
4. {
6. }
7. QWidget* SpinDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option,
8. const QModelIndex &index) const
9. {
10. if(index.column() == ) // 返回下拉框
11. {
12. QSpinBox* box = new QSpinBox(parent);
13. box->setMinimum();
14. box->setMaximum();
15. return box;
16. }
17. return QItemDelegate::createEditor(parent, option, index);
18. }
19. 原文