QStyledItemDelegate Class

QItemEditorFactory *editorFactory = new QItemEditorFactory;
QItemEditorCreatorBase *creator = new QStandardItemEditorCreator<MyFancyDateTimeEdit>();
editorFactory->registerEditor(QMetaType::QDateTime, creator);

QItemEditorFactory::setDefaultFactory(editorFactory);

成员函数文档

[explicit] QStyledItemDelegate::QStyledItemDelegate(QObject *parent = nullptr)

使用给定的parent 构建一个项目委托。

[virtual noexcept] QStyledItemDelegate::~QStyledItemDelegate()

销毁项目委托。

[override virtual] QWidget *QStyledItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const

重实现：QAbstractItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const.

返回用于编辑index 所指定项目的 widget。parent widget 和样式option 用于控制编辑器 widget 的显示方式。

另请参阅 QAbstractItemDelegate::createEditor().

[virtual] QString QStyledItemDelegate::displayText(const QVariant &value, const QLocale &locale) const

此函数返回委托将用于在locale 中显示模型的Qt::DisplayRole 的字符串。value 是模型提供的Qt::DisplayRole 的值。

默认实现使用QLocale::toString 将value 转换为QString 。

空模型索引（即模型返回无效QVariant 的索引）不会调用此函数。

另请参阅 QAbstractItemModel::data() 。

[override virtual protected] bool QStyledItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index)

重实现：QAbstractItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index).

[override virtual protected] bool QStyledItemDelegate::eventFilter(QObject *editor, QEvent *event)

重实现：QObject::eventFilter(QObject *watched, QEvent *event)。

如果给定的editor 是有效的QWidget ，且给定的event 已处理，则返回true ；否则返回false 。默认处理以下按键事件：

• Tab
• Backtab
• Enter
• Return
• Esc

如果editor 的类型是QTextEdit 或QPlainTextEdit ，则不处理Tab,Backtab,Enter 和Return 按键。

对于Tab,Backtab,Enter 和Return 按键事件，editor 的数据将保存到模型中，编辑器关闭。如果event 是Tab 按键，视图将打开视图中下一个项目的编辑器。同样，如果event 是Backtab 按键，视图将打开视图中上一个项目的编辑器。

如果事件是Esc 按键按下事件，则editor 将关闭，不会提交数据。

另请参阅 commitData() 和closeEditor()。

[virtual protected] void QStyledItemDelegate::initStyleOption(QStyleOptionViewItem *option, const QModelIndex &index) const

使用索引index 将option 的值初始化。当子类需要QStyleOptionViewItem ，但又不想自己填写所有信息时，该方法非常有用。

另请参阅 QStyleOption::initFrom()。

QItemEditorFactory *QStyledItemDelegate::itemEditorFactory() const

返回项目委托所使用的编辑器工厂。如果未设置编辑器工厂，函数将返回 null。

另请参见 setItemEditorFactory()。

[override virtual] void QStyledItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

重实现：QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const.

使用给定的painter 和样式option 为index 指定的项目渲染委托。

该函数使用视图的QStyle 绘制项目。

在子类中重新实现绘制时。使用initStyleOption() 设置option 的方式与QStyledItemDelegate 相同。

尽可能在绘制时使用option 。尤其是它的rect 变量来决定绘制的位置，以及它的state 来确定是否启用或选中。

绘制完成后，应确保绘制器返回到调用此函数时的状态。例如，在绘制前调用QPainter::save() 和在绘制后调用QPainter::restore() 可能会有帮助。

另请参阅 QItemDelegate::paint()、QStyle::drawControl() 和QStyle::CE_ItemViewItem 。

[override virtual] void QStyledItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const

重实现：QAbstractItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const.

从模型index 指定的数据模型项中设置editor 要显示和编辑的数据。

默认实现将数据存储在editor widget 的用户属性中。

另请参阅 QMetaProperty::isUser().

void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

将项目委托使用的编辑器工厂设置为指定的factory 。如果未设置编辑器工厂，项目委托将使用默认编辑器工厂。

另请参阅 itemEditorFactory().

[override virtual] void QStyledItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const

重实现：QAbstractItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const.

从editor widget 获取数据并存储到指定的model 项目index 中。

默认实现是从editor widget 的用户属性中获取要存储在数据模型中的值。

另请参阅 QMetaProperty::isUser() 。

[override virtual] QSize QStyledItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

重实现：QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) 常量。

返回委托显示index 指定的项目所需的大小，同时考虑option 提供的样式信息。

此函数使用视图的QStyle 来确定项目的大小。

另请参阅 QStyle::sizeFromContents() 和QStyle::CT_ItemViewItem 。

[override virtual] void QStyledItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const

重实现：QAbstractItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const.

根据给定的样式option 更新index 指定的项目的editor 。