Qt-Model/View基础概念和最简单例子

基本概念

模型/视图是一种用于将数据与处理数据集的控件的视图分离的技术。Qt中的标准控件不是为从视图中分离数据而设计的，这就是 Qt 有两种不同类型的控件的原因。两种类型的控件看起来相同，但它们与数据的交互方式不同。

使用标准控件时数据作为控件一部分

视图控件对外部数据（模型）进行操作

使用标准控件存在一个问题，就是如果我们的底层数据时常发生增删改查，那么每次发生变动时，我们都要去手动更新界面中的数据，并且通常我们需要维护两份数据，一份是底层数据，一份是控件内数据，保持数据一致性也是个麻烦事。

视图控件不在表格单元格后面存储数据，它们直接根据你的数据进行操作。由于视图控件不知道你的数据结构，你需要提供一个包装器以使你的数据符合QAbstractItemModel接口，视图使用此接口读取和写入你的数据。实现QAbstractItemModel的类被称为模型(Model)。

Model/View入门

Table View例子

// main.cpp
#include <QApplication>
#include <QTableView>
#include "mymodel.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QTableView tableView;
    MyModel myModel;
    tableView.setModel(&myModel);
    tableView.show();
    return a.exec();
}

我们创建一个 MyModel实例并使用tableView.setModel(&myModel); 将它的指针传递给tableView。tableView将调用指针的方法来获取两个信息：

1. 应该显示多少行和列。
2. 每个单元格中应该打印什么内容。

MyModel继承于QAbstractTableModel，重写了三个虚函数

// mymodel.cpp
#include "mymodel.h"

MyModel::MyModel(QObject *parent)
    : QAbstractTableModel(parent)
{
}

int MyModel::rowCount(const QModelIndex & /*parent*/) const
{
   return 2;
}

int MyModel::columnCount(const QModelIndex & /*parent*/) const
{
    return 3;
}

QVariant MyModel::data(const QModelIndex &index, int role) const
{
    if (role == Qt::DisplayRole)
       return QString("Row%1, Column%2")
                   .arg(index.row() + 1)
                   .arg(index.column() +1);

    return QVariant();
}

行数和列数由MyModel:😗*rowCount()**和MyModel::columnCount() 提供。当视图需要知道单元格的文本是什么时，它调用方法MyModel::data()

如果要设置表头内容，需要重写headerData方法

QVariant MyModel::headerData(int section, Qt::Orientation orientation, int role) const
{
    if (role == Qt::DisplayRole && orientation == Qt::Horizontal) {
        switch (section) {
        case 0:
            return QString("first");
        case 1:
            return QString("second");
        case 2:
            return QString("third");
        }
    }
    return QVariant();
}

这个例子展示了模型的被动特性。该模型不知道何时使用它或需要哪些数据。它只是在每次视图请求时提供数据。

Table View例子扩展

模型除了控制视图显示的文本外，还控制文本的外观

// mymodel.cpp
QVariant MyModel::data(const QModelIndex &index, int role) const
{
    int row = index.row();
    int col = index.column();
    // generate a log message when this method gets called
    qDebug() << QString("row %1, col%2, role %3")
            .arg(row).arg(col).arg(role);

    switch (role) {
    case Qt::DisplayRole:
        if (row == 0 && col == 1) return QString("<--left");
        if (row == 1 && col == 1) return QString("right-->");

        return QString("Row%1, Column%2")
                .arg(row + 1)
                .arg(col +1);
    case Qt::FontRole:
        if (row == 0 && col == 0) { //change font only for cell(0,0)
            QFont boldFont;
            boldFont.setBold(true);
            return boldFont;
        }
        break;
    case Qt::BackgroundRole:
        if (row == 1 && col == 2)  //change background only for cell(1,2)
            return QBrush(Qt::red);
        break;
    case Qt::TextAlignmentRole:
        if (row == 1 && col == 1) //change text alignment only for cell(1,1)
            return int(Qt::AlignRight | Qt::AlignVCenter);
        break;
    case Qt::CheckStateRole:
        if (row == 1 && col == 0) //add a checkbox to cell(1,0)
            return Qt::Checked;
        break;
    }
    return QVariant();
}

每个格式化属性都将通过调用data()方法从模型中获取。role参数用于让模型知道正在请求哪个属性，这里可以看到支持哪些属性。

数据改变信号

当模型中数据发生改变时，我们需要通知视图

void MyModel::timerHit()
{
    //we identify the top left cell
    QModelIndex topLeft = createIndex(0,0);
    //emit a signal to make the view reread identified data
    emit dataChanged(topLeft, topLeft, {Qt::DisplayRole});
}

此时视图将重新请求指定位置、指定属性的数据。注意，在我们调用setModel()时会自动连接模型的**dataChanged()**信号到视图。

编辑数据

模型决定编辑功能是否可用。我们只需修改模型即可启用可用的编辑功能。这是通过重新实现以下虚拟方法来完成的：setData()和flags()。

// mymodel.h
#include <QAbstractTableModel>
#include <QString>

const int COLS= 3;
const int ROWS= 2;

class MyModel : public QAbstractTableModel
{
    Q_OBJECT
public:
    MyModel(QObject *parent = nullptr);
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;
    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;
    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override;
    Qt::ItemFlags flags(const QModelIndex &index) const override;
private:
    QString m_gridData[ROWS][COLS];  //holds text entered into QTableView
signals:
    void editCompleted(const QString &);
};

这里通过m_gridData变量来保存真正的数据，这是MyModel的核心，该类的其他部分则是对m_gridData的封装，使其适配QAbstractItemModel接口。

bool MyModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (role == Qt::EditRole) {
        if (!checkIndex(index))
            return false;
        //save value from editor to member m_gridData
        m_gridData[index.row()][index.column()] = value.toString();
        //for presentation purposes only: build and emit a joined string
        QString result;
        for (int row = 0; row < ROWS; row++) {
            for (int col= 0; col < COLS; col++)
                result += m_gridData[row][col] + ' ';
        }
        emit editCompleted(result);
        return true;
    }
    return false;
}

每次用户编辑单元格时都会调用setData()。index参数告诉我们哪个字段正在被编辑，value参数告知编辑的结果，这里的role总是Qt::EditRole，因为我们的单元格仅包含文本，如果是一个checkBox，role将会是Qt::CheckStateRole。
单元格的属性通过flags方法调整

Qt::ItemFlags MyModel::flags(const QModelIndex &index) const
{
    return Qt::ItemIsEditable | QAbstractTableModel::flags(index);
}