概念
不一样于模型 - 视图 - 控制器模式,模型/视图设计不包括用于管理与用户交互的一个彻底独立的组件。通常状况,视图负责将模型数据呈现给用户以及处理用户输入。为了输入更加具备灵活性,则由委托来执行交互。这些组件提供输入功能,且在一些视图中还负责渲染个别项目。控制委托的标准接口在QAbstractItemDelegate类中定义。
委托可以经过实现的paint()和sizeHint()函数来展现它们的内容。然而,简单基础部件的委托能够继承QItemDelegate而不是QAbstractItemDelegate,并使用这些函数的默认实现。
委托编辑器能够经过使用小工具来管理编辑过程或直接处理事件来实现。
使用现有委托
Qt提供的标准视图中使用QItemDelegate提供编辑功能。委托接口的默认实现以一向风格来呈现项目为每一个标准视图:QListView、QTableView、QTreeView。
全部标准角色由所使用的标准视图中的默认委托处理。
视图使用委托是由itemDelegate()函数返回。setItemDelegate()函数容许你为标准视图设定一个自定义委托,为自定义视图设定委托时,有必要使用此功能。
一个简单的委托
这里实现的委托使用QSpinBox来提供编辑功能,主要用于模型处理整数。虽然为了这个目的咱们设置了一个自定义的基于整数的表模型,咱们能够很容易地使用QStandardItemModel来代替,由于自定义委托控制数据输入。咱们构造了一个表视图来显示模型的内容,可使用自定义的委托来进行编辑。
咱们的委托继承于QItemDelegate,由于咱们不想编写自定义显示功能。然而,仍然必须提供管理编辑器窗口小部件的功能:
class SpinBoxDelegate : public QStyledItemDelegate
{
Q_OBJECT
public:
SpinBoxDelegate(QObject *parent = 0);
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;
};
提供了一个编辑器
在这个例子中,当表视图须要提供一个编辑器时,它将要求委托提供一个编辑器部件适用于修改该项目。createEditor()函数提供一切,委托须要可以创建一个合适的窗口小部件:
QWidget *SpinBoxDelegate::createEditor(QWidget *parent,
const QStyleOptionViewItem &,
const QModelIndex &) const
{
QSpinBox *editor = new QSpinBox(parent);
editor->setFrame(false);
editor->setMinimum(0);
editor->setMaximum(100);
return editor; }
注意,咱们不须要一个指向编辑器的部件,由于当再也不须要时,视图负责销毁它。
在编辑器上安装代理的默认事件过滤器,以确保它提供了用户所指望的标准编辑快捷方式。编辑器中能够添加额外的快捷键,以容许更复杂的行为。
能够根据视图提供的模型索引建立不一样的编辑器。例如,若是有一个整数列和字符串列,咱们能够返回一个QSpinBox或QLineEdit,这取决于哪一列正在被编辑。
委托必须提供一个函数将模型中的数据复制到编辑器中。在这个例子中,咱们读出存储在显示角色中的数据,并在QSpinBox中设置的值相应。
void SpinBoxDelegate::setEditorData(QWidget *editor,
const QModelIndex &index) const
{
int value = index.model()->data(index, Qt::EditRole).toInt();
QSpinBox *spinBox = static_cast<<span style=" color:#800080;">QSpinBox*>(editor);
spinBox->setValue(value);
}
在这个例子中,咱们知道编辑器部件是一个QSpinBox,但能够为模型中不一样类型的数据提供不一样的编辑器,在这种状况下,则须要在访问它的成员函数以前设置部件为适当的类型。
void SpinBoxDelegate::setModelData(QWidget *editor, QAbstractItemModel *model,
const QModelIndex &index) const
{
QSpinBox *spinBox = static_cast<<span style=" color:#800080;">QSpinBox*>(editor);
spinBox->interpretText();
int value = spinBox->value();
model->setData(index, value, Qt::EditRole);
}
因为视图为委托管理编辑器部件,因此只须要以编辑器提供的内容来更新模型。在这种状况下,咱们确QSpinBox是最新更新,并使用指定的索引包含的值来更新模型。
标准的QItemDelegate类经过发射closeEditor()信号来完成编辑视图。视图可确保编辑器部件被关闭和销毁。在这个例子中,咱们只提供简单的编辑功能,因此咱们须要永远不会发出这个信号。
全部的数据操做经过QAbstractItemModel提供的接口执行。这使得委托大多独立于它操纵的数据的类型,但为了使用某些类型的编辑器部件,则必须作出一些假设。在这个例子中,咱们假设模型老是包含整数值,但咱们仍然在不一样类型的模型中使用此委托,由于的QVariant为意想不到的数据提供了合理的默认值。
更新编辑器的几何形状
管理编辑器的几何形状是委托的责任。当编辑器被建立,或者当项目视图的的位置、大小在视图中改变时,几何形状必须被设置。幸运的是,视图提供了视图选项物体内部全部必要的几何信息。
void SpinBoxDelegate::updateEditorGeometry(QWidget *editor,
const QStyleOptionViewItem &option, const QModelIndex &) const
{
editor->setGeometry(option.rect);
}
这种状况下,咱们仅在项目区域中使用视图选项提供的位置信息。使用一些元素展示项目的委托不会直接使用该项目矩形。根据这个项目中的其余元素来设定编辑器的位置。
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QStandardItemModel model(4, 2);
QTableView tableView;
tableView.setModel(&model);
SpinBoxDelegate delegate;
tableView.setItemDelegate(&delegate);
tableView.horizontalHeader()->setStretchLastSection(true);
for (int row = 0; row <<span style=" color:#c0c0c0;"> 4; ++row) {
for (int column = 0; column <<span style=" color:#c0c0c0;"> 2; ++column) {
QModelIndex index = model.index(row, column, QModelIndex());
model.setData(index, QVariant((row + 1) * (column + 1)));
}
}
tableView.setWindowTitle(QObject::tr("Spin Box Delegate"));
tableView.show();
return app.exec();
}app