QAbstractItemDelegate 类

void WidgetDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option,
                           const QModelIndex &index) const
{
    if (index.column() == 1) {
        int progress = index.data().toInt();

        QStyleOptionProgressBar progressBarOption;
        progressBarOption.rect = option.rect;
        progressBarOption.minimum = 0;
        progressBarOption.maximum = 100;
        progressBarOption.progress = progress;
        progressBarOption.text = QString::number(progress) + "%";
        progressBarOption.textVisible = true;

        QApplication::style()->drawControl(QStyle::CE_ProgressBar,
                                           &progressBarOption, painter);
    } else
        QStyledItemDelegate::paint(painter, option, index);

成员函数文档

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

创建一个具有给定 parent 的新抽象项目代理。

[虚拟 noexcept] QAbstractItemDelegate::~QAbstractItemDelegate()

销毁抽象项代理。

[信号] void QAbstractItemDelegate::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint = NoHint)

当用户使用指定的 editor 完成编辑项目时，此信号会被发出。

hint 为代理提供了一个影响模型和视图编辑完成后行为的方式。它指示了这些组件接下来应该执行什么操作，以提供给用户舒适的编辑体验。例如，如果指定了 EditNextItem，视图应通过代理打开模型中下一项的编辑器。

另请参阅EndEditHint。

[信号] void QAbstractItemDelegate::commitData(QWidget *editor)

当 editor 小部件完成数据编辑并将它写回模型时，必须发出此信号。

[虚函数] QWidget *QAbstractItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const

返回用于编辑给定 index 数据项的编辑器。注意，索引包含有关正在使用的模型的信息。编辑器的父小部件由 parent 指定，项选项由 option 指定。

基本实现返回 nullptr。如果您需要自定义编辑，则需要重新实现此函数。

返回的编辑器小部件应具有 Qt::StrongFocus；否则，小部件收到的 QMouseEvent 将传播到视图。除非编辑器绘制自己的背景（例如，使用 setAutoFillBackground()），否则视图的背景将发光。

另请参阅destroyEditor，setModelData 和 setEditorData。

[虚函数] void QAbstractItemDelegate::destroyEditor(QWidget *editor, const QModelIndex &index) const

当不再需要用于编辑给定 index 数据项的 editor 进行编辑时，此函数将被调用以销毁它。默认行为是对编辑器调用 deleteLater。例如，通过重新实现此函数可以避免此删除。

另请参阅createEditor。

[虚函数] bool QAbstractItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index)

在开始编辑项时，此函数将使用触发的编辑的 event，model，项的 index 和用于渲染项的 option 调用。

即使事件没有开始编辑项，鼠标事件也会发送到editorEvent()。例如，当您在项上按下鼠标右键时打开上下文菜单时，这可能会很有用。

基本实现返回false（表示它没有处理事件）。

[虚拟] bool QAbstractItemDelegate::helpEvent(QHelpEvent *event, QAbstractItemView *view, const QStyleOptionViewItem &option, const QModelIndex &index)

每当发生帮助事件时，此函数都会使用事件event、视图view、选项option以及与事件发生项相对应的索引index被调用。

如果代理可以处理事件，则返回true；否则返回false。返回值为true表示使用索引获得的数据具有所需的角色。

对于处理成功的QEvent::ToolTip和QEvent::WhatsThis事件，根据用户的系统配置，可能会显示相关的弹出窗口。

另请参阅QHelpEvent。

[纯虚拟] void QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

如果您想自定义渲染，则需要重新实现此纯抽象函数。使用painter和风格option来渲染由项索引确定的项。

如果您重新实现了此方法，还必须重新实现sizeHint。

[虚拟] void QAbstractItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const

将给定editor的内容设置为给定index处项的数据。请注意，索引包含有关使用中的模型的信息。

基本实现不执行任何操作。如果您想自定义编辑，则需要重新实现此函数。

另请参阅setModelData。

[虚拟] void QAbstractItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const

将model中给定index处的项的数据设置为给定editor的内容。

基本实现不执行任何操作。如果您想自定义编辑，则需要重新实现此函数。

另请参阅setEditorData。

[纯虚拟] QSize QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

如果您想自定义渲染，则需要重新实现此纯抽象函数。选项由option指定，而模型项由index指定。

如果您重实现此功能，您还必须重实现 paint ()。

[signal] void QAbstractItemDelegate::sizeHintChanged(const QModelIndex &index)

当 index 的 sizeHint () 发生更改时，必须发出此信号。

视图会自动连接到该信号，并在必要时重新布局项目。

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

根据 option 中指定的矩形更新具有给定 index 的 editor 的几何形状。如果项目有内部布局，则编辑器将相应地进行布局。请注意，索引包含有关所使用的模型的信息。

基本实现不执行任何操作。如果您想要自定义编辑，必须重写此函数。