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。

相关推荐
奔跑吧邓邓子8 小时前
【C++实战⑦】C++函数实战:从基础到项目应用
c++·实战·函数
HMBBLOVEPDX8 小时前
C++(静态函数)
开发语言·c++
张晓~183399481218 小时前
短视频矩阵源码-视频剪辑+AI智能体开发接入技术分享
c语言·c++·人工智能·矩阵·c#·php·音视频
dpxiaolong9 小时前
RK3588 Android12默认移除导航栏
开发语言·python
Pocker_Spades_A9 小时前
Python快速入门专业版(二十九):函数返回值:多返回值、None与函数嵌套调用
服务器·开发语言·python
良木林9 小时前
浅谈原型。
开发语言·javascript·原型模式
烈风9 小时前
004 Rust控制台打印输出
开发语言·后端·rust
一枝小雨10 小时前
【C++】list 容器操作
开发语言·c++·笔记·list·学习笔记
HMBBLOVEPDX10 小时前
C++(继承和多态)
开发语言·c++·继承和多态
yvya_10 小时前
JVM介绍
java·开发语言·jvm