Qt模型/视图架构——委托（delegate）

一、为什么需要委托

模型（model） 用来数据存储，视图（view） 用来展示数据。因此，模型/视图架构是一种将数据存储和界面展示分离的编程方法。具体如下图所示：

由图可知，模型向视图提供数据是单向的，一般仅用于显示数据。当我们需要在视图上编辑数据时，就需要用到**委托（delegate）**来提供一个临时的编辑器。这个编辑器既能获取模型的数据，又能在接受用户编辑的数据后提交给模型。

注：delegate有的书上直接翻译为代理。个人认为这个翻译不太准确，因为在Qt中，代理（Proxy）和委托（Delegate）是两个不同的概念。Proxy用于数据模型和视图之间的一些中介操作，包括对数据进行过滤、排序和转换。而Delegate则用于自定义视图项的显示和编辑行为，主要用于定制单元格的外观和编辑控件。

二、自定义委托

1.为什么自定义委托

如果我们没有提前进行任何设置，在默认情况下，委托提供的临时编辑器是QLineEdit编辑框。而我们知道，QLineEdit不仅可以输入文字，还能输入数组，字母，符号等任何数据。但是更多情况下，我们希望根据数据类型使用不同的编辑器。

2.如何自定义委托

QStyledItemDelegate是视图组件使用的默认委托类。因此，在创建好自定义委托类后，必须首先将自定义的委托类实现QStyledItemDelegate中定义的4个虚函数（右键选择重构可自动生成）。而这4个虚函数是模型/视图系统自动调用的。

1）creareEditor()

这个函数用来创建编辑模型数据的界面组件，称为代理编辑器。函数定义如下：

cpp 复制代码

QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const;

parent：创建组件的父组件，一般就是窗口对象。
option：一些显示选项，包含字体、对齐方式、背景色等。
index：模型索引，用来获取模型数据。

函数实现如下：

cpp 复制代码

QWidget *TSpinBoxDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QSpinBox *editor = new QSpinBox(parent); 
    editor->setFrame(false); 
    editor->setMinimum(0);
    editor->setMaximum(50000);
    return editor;  
}

注：这里并没有返回QWidget类型，而是返回了它的派生类QSpinBox类型。因此后面要注意类型转换。

2）setEditorData()

这个函数会从数据模型获取数据，然后显示到代理组件中。函数定义如下：

cpp 复制代码

void setEditorData(QWidget *editor, const QModelIndex &index) const;

editor：前面函数 creareEditor() 返回的代理编辑器
index：用 index.model() 可以从数据模型获取数据

函数实现如下：

cpp 复制代码

void TSpinBoxDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    int value = index.model()->data(index, Qt::EditRole).toInt();  
    QSpinBox *spinBox = static_cast<QSpinBox*>(editor);   // 类型转换
    spinBox->setValue(value);   
}

3）setModelData()

这个函数会将代理组件的数据，保存到数据模型中。函数定义如下：

cpp 复制代码

void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const;

model：需要保存数据的数据模型

函数实现如下：

cpp 复制代码

void TSpinBoxDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    QSpinBox *spinBox = static_cast<QSpinBox*>(editor);     //强制类型转换
    int value = spinBox->value();   //获取spinBox的值
    model->setData(index, value, Qt::EditRole);     //更新到数据模型
}

4） updateEditorGeometry()

这个函数用来更新代理编辑组件的大小，一般写法比较固定。函数实现如下：

cpp 复制代码

void TFloatSpinDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    editor->setGeometry(option.rect);  // 设置代理编辑器大小为建议大小
}

写到这里，委托类就设置完了。接下来，我们还需要在mainwindow.cpp中的构造函数初始化列表添加如下代码完成对相关组件的委托。

cpp 复制代码

TSpinBoxDelegate intSpinDelegate = new TSpinBoxDelegate(this);
ui->tableView->setItemDelegateForColumn(0, intSpinDelegate);

这时当我们修改某项数据时，就会自动产生一个QSpinBox的组件编辑器，而不是默认的QLineEdit。