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;
}
1
2
3
4
5
6
7
8
9
10
11

设置编辑器数据 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());
}
1
2
3
4
5
6

设置模型数据 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);

}
1
2
3
4
5
6
7

更新编辑器集合属性 updateEditorGeometry

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

部分代码如下：

#include 
#include 
#include 
/*
*
*
*	创建一个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);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133