Qt的委托代理机制

• 委托是Qt中的一种机制，用于在Qt模型/视图架构中处理特定类型的数据。委托提供了一种方便的方法来定制特定类型的数据的显示和编辑。
• 委托可以做以下事情:

编辑特定类型的数据: 通过创建编辑器来编辑特定类型的数据,例如日期,数值等。

渲染特定类型的数据: 通过定制单元格的外观来渲染特定类型的数据,例如颜色,字体等；

支持不同类型的编辑器: 支持不同类型的编辑器,例如文本编辑器,下拉列表编辑器等；

处理编辑器的事件: 通过实现eventFilter()方法来处理编辑器的事件,如键盘事件；

更新编辑器的尺寸: 通过实现sizeHint()方法来更新编辑器的尺寸；

数据验证: 通过实现editorEvent()来验证编辑器中的数据是否合法。

• 委托的常见应用场景包括:

表格和列表视图: 在表格和列表视图中使用委托可以方便地编辑单元格中的数据,并定制单元格的外观

属性编辑器: 使用委托可以创建自定义属性编辑器来编辑特定类型的属性

文件对话框: 使用委托可以定制文件对话框中的文件列表的外观

以QTableView为例子：

1. 需要为QTableView设置一个model

• 也可以自定义model，继承QStandardItemModel；

2. 为QTableView设置Delegate

• 继承QStandardItemModel、QItemDelegate或者QStyledItemDelegate；
• QItemDelegate是QAbstractItemDelegate的子类，它提供了一种通用的委托类；
• QStyledItemDelegate是QItemDelegate的子类，它使用Qt Style Sheets来渲染单元格中的数据，这样可以更好地与应用程序的外观保持一致。它还提供了一些额外的功能，如支持自定义编辑器和支持编辑器工厂，这样可以更好地管理编辑器；

3. 委托类需要重写对应的函数，比如：

1. QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option,const QModelIndex &index) const;
2. void setEditorData(QWidget *editor, const QModelIndex &index) const;
3. void setModelData(QWidget *editor, QAbstractItemModel *model,const QModelIndex &index) const;
4. void updateEditorGeometry(QWidget *editor,const QStyleOptionViewItem &option, const QModelIndex &index) const;
5. void paint(QPainter *painter, const QStyleOptionViewItem &option,const QModelIndex & index) const;
6. QSize sizeHint(const QStyleOptionViewItem &option,const QModelIndex &index) const;
7. bool eventFilter(QObject *object, QEvent *event) ;
8. bool editorEvent(QEvent *event, QAbstractItemModel *model,
   const QStyleOptionViewItem &option, const QModelIndex &index) override;

创建编辑器

QWidget* TableViewDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
	QSpinBox *sbox = new QSpinBox(parent);
	sbox->setRange(sboxMinValue, sboxMaxValue);
	sbox->setSuffix(sboxSuffixStr);
	sbox->setPrefix(sboxPrefixStr);
	sbox->setSingleStep(sboxSingleStep);
	sbox->setStepType(sboxStepType);
	sbox->setValue(sboxInitValue);
	return  sbox;
}

设置编辑器数据 setEditorData

void TableViewDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
	auto value = index.model()->data(index, Qt::EditRole);
	QSpinBox *spinBox = static_cast<QSpinBox*>(editor);
	spinBox->setValue(value.toInt());
}

设置模型数据 setModelData

void TableViewDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index)const
{
	QSpinBox *spinBox = static_cast<QSpinBox*>(editor);
	QVariant value = spinBox->value();
	model->setData(index, value, Qt::EditRole);

}

更新编辑器集合属性 updateEditorGeometry

void TableViewDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index)const
{
	editor->setGeometry(option.rect);
}

部分代码如下：

#include <QStyledItemDelegate>
#include <QItemDelegate>
#include <QStandardItemModel>
/*
*
*
*	创建一个QSpinBox设置相关参数函数
*
*
*/
class TableViewDelegate  : public QStyledItemDelegate
{
	Q_OBJECT

public:
	TableViewDelegate(QObject *parent = nullptr);
	~TableViewDelegate();

	// editing
	QWidget *createEditor(QWidget *parent,const QStyleOptionViewItem &option,const QModelIndex &index)const;
	void setEditorData(QWidget *editor, const QModelIndex &index) const ;
	void setModelData(QWidget *editor,QAbstractItemModel *model,const QModelIndex &index)const;
	void updateEditorGeometry(QWidget *editor,const QStyleOptionViewItem &option,const QModelIndex &index)const;
private:
	void init();
public:
	/*QSpinBox设置相关参数函数*/
	void setSboxMaxValue(const int max);
	void setSboxMinValue(const int min);
	void setSboxPrefixStr(const QString &prefix);
	void setSboxSuffixStr(const QString &suffix);
	void setSboxSingleStep(const int SingleStep);
	void setSboxInitValue(const int initValue);
	void setSboxStepType(QAbstractSpinBox::StepType st);
private:
	/*QSpinBox相关参数*/
	int sboxMaxValue;/*微调框的最大值*/
	int sboxMinValue;/*微调框的最小值*/

	QString sboxPrefixStr;/*微调框前缀*/
	QString sboxSuffixStr;/*微调框后缀*/

	int sboxSingleStep;/*微调框步长*/
	int sboxInitValue;/*微调框初始值*/

	QAbstractSpinBox::StepType sboxStepType;/*微调框步长类型*/
};

Delegate.cpp
TableViewDelegate::TableViewDelegate(QObject *parent): QStyledItemDelegate(parent)
{
}
TableViewDelegate::~TableViewDelegate()
{
}
QWidget* TableViewDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
	QSpinBox *sbox = new QSpinBox(parent);
	sbox->setRange(sboxMinValue, sboxMaxValue);
	sbox->setSuffix(sboxSuffixStr);
	sbox->setPrefix(sboxPrefixStr);
	sbox->setSingleStep(sboxSingleStep);
	sbox->setStepType(sboxStepType);
	sbox->setValue(sboxInitValue);
	return  sbox;
}

//将模型中的数据赋值给编辑器
void TableViewDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
	auto value = index.model()->data(index, Qt::EditRole);
	QSpinBox *spinBox = static_cast<QSpinBox*>(editor);
	spinBox->setValue(value.toInt());
}
void TableViewDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index)const
{
	QSpinBox *spinBox = static_cast<QSpinBox*>(editor);
	QVariant value = spinBox->value();
	model->setData(index, value, Qt::EditRole);
}
void TableViewDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index)const
{
	editor->setGeometry(option.rect);
}
/*QSpinBox设置相关参数函数*/
void TableViewDelegate::setSboxMaxValue(const int max)
{
	sboxMaxValue = max;
}
void TableViewDelegate::setSboxMinValue(const int min)
{
	sboxMinValue = min;
}
void TableViewDelegate::setSboxPrefixStr(const QString &prefix) 
{
	sboxPrefixStr = prefix;
}
void TableViewDelegate::setSboxSuffixStr(const QString &suffix)
{
	sboxSuffixStr = suffix;
}
void TableViewDelegate::setSboxSingleStep(const int SingleStep)
{
	sboxSingleStep = SingleStep;
}
void TableViewDelegate::setSboxInitValue(const int initValue)
{
	sboxInitValue = initValue;
}
void TableViewDelegate::setSboxStepType(QAbstractSpinBox::StepType st)
{
	sboxStepType = st;
}
void TableViewDelegate::init()
{
}
//在QTableView中使用
void init() 
{
	QStringList columnNames;
	columnNames << "QSpinBox" << "QComboBox" << "QCheckBox" << ".....";
	model = new QStandardItemModel;
	model->setRowCount(10);
	model->setHorizontalHeaderLabels(columnNames);
	ui->tableView->setModel(model);
	TableViewDelegate * tabDelegate = new TableViewDelegate;
	tabDelegate->setSboxMinValue(0);
	tabDelegate->setSboxMaxValue(100);
	tabDelegate->setSboxSingleStep(2);
	tabDelegate->setSboxInitValue(10);
	//设置第一列为TableViewDelegate 样式
	ui->tableView->setItemDelegateForColumn(0, tabDelegate);
}