QStyledItemDelegate 类

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

QItemEditorFactory::setDefaultFactory(editorFactory);

成员函数文档

[显式] QStyledItemDelegate::QStyledItemDelegate(QObject *parent = nullptr)

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

[虚 无异常] QStyledItemDelegate::~QStyledItemDelegate()

销毁项目委托。

[重载虚] QWidget *QStyledItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const

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

返回用于编辑由 index 指定项目的控件，用于编辑。控件 parent 和样式 option 用于控制编辑器控件的外观。

参见QAbstractItemDelegate::createEditor。

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

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

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

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

另请参阅 QAbstractItemModel::data。

[重写虚受保护] bool QStyledItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index)

重写: QAbstractItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &ldash;option, const QModelIndex &rdash;index)

[重写虚受保护] bool QStyledItemDelegate::eventFilter(QObject *editor, QEvent *event)

重写: QObject::eventFilter(QObject *watched, QEvent *event)

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

• Tab
• Backtab
• Enter
• Return
• Esc

如果编辑器的类型是QTextEdit或QPlainTextEdit，则Tab、Backtab、Enter和Return按键不被处理。

在Tab、Backtab、Enter和Return按键事件的情形下，编辑器的数据将提交给模型，并关闭编辑器。如果事件是Tab按键的按下，视图将在视图中下一个项目上打开编辑器。同样地，如果事件是Backtab按键的按下，视图将在视图中上一个项目上打开编辑器。

如果事件是Esc按键的按下事件，则编辑器关闭而不会提交其数据。

另请参阅 commitData()和closeEditor。

[虚受保护] void QStyledItemDelegate::initStyleOption(QStyleOptionViewItem *option, const QModelIndex &index) const

使用索引index的值初始化option。此方法对于子类很有用，当它们需要QStyleOptionViewItem但不想自己填写所有信息时。

另请参阅 QStyleOption::initFrom。

QItemEditorFactory *QStyledItemDelegate::itemEditorFactory() const

返回项目代理使用的编辑器工厂。如果没有设置编辑器工厂，则函数将返回null。

另请参阅 setItemEditorFactory。

[重写虚] 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 来绘制项目。

在子类中重写 paint。使用 initStyleOption() 来设置 option，与 QStyledItemDelegate 相同。

在可能的情况下，在绘制时使用 option。特别是其 rect 变量来确定绘制位置，以及其 state 来确定是否启用或选中。

绘制后，您应该确保绘图器返回到调用此函数时提供的状态。例如，在绘制之前调用 QPainter::save() 并绘制后调用 QPainter::restore() 可能很有用。

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

[覆盖虚函数] void QStyledItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const

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

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

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

另请参阅 QMetaProperty::isUser。

void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

设置项目代理要使用的编辑器工厂为指定的 factory。如果没有设置编辑器工厂，则项目代理将使用默认的编辑器工厂。

另请参阅 itemEditorFactory。

[覆盖虚函数] void QStyledItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const

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

从 editor 小部件获取数据并将其存储在指定的 model 中 index 所指的项目中。

默认实现从 editor 小部件的 用户属性 获取要存储的数据模型中的值。

另请参阅 QMetaProperty::isUser。

[覆盖虚函数] QSize QStyledItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

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

返回代理用于显示指定 index 的项目所需的大小，考虑了 option 提供的样式信息。

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

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

[覆盖虚函数] 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。