一、简介

二、使用 QItemDelegate 的基本步骤

2.1、创建 Item 视图和模型

2.2、创建自定义的委托类

2.3、应用委托类到 Item 视图

三、实例：定制化 Item 视图

一、简介
        当我们需要在 Qt 应用程序中自定义 Item 视图的外观和交互行为时，QItemDelegate 类是一个非常有用的工具。它允许开发者以特定的方式显示和编辑数据，为 Item 视图提供了灵活的定制选项。

        QItemDelegate 类是 Qt 框架中的一个委托类，用于控制 Item 在视图中的显示和编辑方式。它是 Model/View 架构中的一部分，通过与模型和视图的交互，实现对 Item 的定制。QItemDelegate 类的主要作用是为 Item 提供绘制、编辑和交互的功能，并通过重写相关的虚函数来实现自定义行为。

二、使用 QItemDelegate 的基本步骤
2.1、创建 Item 视图和模型
        在使用 QItemDelegate 前，我们首先需要创建 Item 视图和模型。我们可以选择使用任何适合的 Item 视图类，如 QTableView、QTreeView 或 QListView，并创建相应的模型来存储数据。

QStandardItemModel* model = new QStandardItemModel(this);
model->setColumnCount(2);
model->setHeaderData(0, Qt::Horizontal, "Name");
model->setHeaderData(1, Qt::Horizontal, "Age");
 
QTableView* tableView = new QTableView(this);
tableView->setModel(model);
2.2、创建自定义的委托类
        接下来，我们需要创建一个自定义的委托类，继承自 QItemDelegate，并重写其虚函数以实现定制化的显示和编辑逻辑。例如，我们可以定制某一列的显示样式，或者添加特定的交互行为。

class CustomDelegate : public QItemDelegate
{
public:
    explicit CustomDelegate(QObject* parent = nullptr)
        : QItemDelegate(parent)
    {
    }
 
    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        // 自定义绘制逻辑
    }
 
    QWidget* createEditor(QWidget* parent, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        // 自定义编辑器创建逻辑
    }
 
    void setEditorData(QWidget* editor, const QModelIndex& index) const override
    {
        // 自定义编辑器数据设置逻辑
    }
 
    void setModelData(QWidget* editor, QAbstractItemModel* model, const QModelIndex& index) const override
    {
        // 自定义编辑器数据保存逻辑
    }
};
2.3、应用委托类到 Item 视图
        最后，我们将自定义的委托类应用到特定的列或 Item 视图中，以实现定制化的显示和编辑效果。

CustomDelegate* delegate = new CustomDelegate(this);
tableView->setItemDelegateForColumn(1, delegate);
        在上述代码中，我们将自定义的委托类 CustomDelegate 应用到第二列上，即 "Age" 列。这样，该列的显示和编辑效果将由 CustomDelegate 控制。

三、实例：定制化 Item 视图
        让我们通过一个实例来演示如何使用 QItemDelegate 定制化 Item 视图的外观和交互行为。假设我们有一个任务列表，其中包含任务名称和完成状态。我们希望定制化完成状态列的显示效果，使用自定义的图标来表示任务的完成状态，并提供一种交互方式来切换任务的完成状态。

        首先，我们创建一个自定义的委托类 TaskDelegate，继承自 QItemDelegate。在该委托类中，我们重写了 paint()、createEditor() 和 setModelData() 函数。

class TaskDelegate : public QItemDelegate
{
public:
    explicit TaskDelegate(QObject* parent = nullptr)
        : QItemDelegate(parent)
    {
    }
 
    void paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        if (index.column() == 1) {
            bool isCompleted = index.data().toBool();
 
            if (isCompleted) {
                // 绘制背景色
                painter->fillRect(option.rect, Qt::green);
            } else {
                // 绘制背景色
                painter->fillRect(option.rect, Qt::yellow);
            }
 
            // 绘制文本
            QString text = index.data().toString();
            painter->drawText(option.rect, Qt::AlignCenter, text);
        } else {
            QItemDelegate::paint(painter, option, index);
        }
    }
 
    QWidget* createEditor(QWidget* parent, const QStyleOptionViewItem& option, const QModelIndex& index) const override
    {
        if (index.column() == 1) {
            // 创建自定义的编辑器，例如复选框
            QCheckBox* checkBox = new QCheckBox(parent);
            return checkBox;
        }
 
        return QItemDelegate::createEditor(parent, option, index);
    }
 
    void setModelData(QWidget* editor, QAbstractItemModel* model, const QModelIndex& index) const override
    {
        if (index.column() == 1) {
            // 获取编辑器的值，更新数据模型
            QCheckBox* checkBox = qobject_cast<QCheckBox*>(editor);
            if (checkBox) {
                bool isCompleted = checkBox->isChecked();
                model->setData(index, isCompleted);
            }
        } else {
            QItemDelegate::setModelData(editor, model, index);
        }
    }
};
        然后，我们在主窗口中创建任务列表的模型和视图，并将自定义委托应用到完成状态列上。

QStandardItemModel* model = new QStandardItemModel(this);
model->setColumnCount(2);
model->setHeaderData(0, Qt::Horizontal, "Task");
model->setHeaderData(1, Qt::Horizontal, "Status");
 
QTableView* tableView = new QTableView(this);
tableView->setModel(model);
 
TaskDelegate* delegate = new TaskDelegate(this);
tableView->setItemDelegateForColumn(1, delegate);
        在上述代码中，我们创建了一个包含两列的任务列表模型，并设置了列标题。然后，我们创建了一个 QTableView，并将该模型设置为其数据源。接下来，我们创建了 `TaskDelegate` 的实例，并将其应用到第二列（状态列）上，以定制化显示和编辑效果。 最后，我们可以将任务数据添加到模型中，然后显示任务列表。

QStandardItem* task1 = new QStandardItem("Task 1");
QStandardItem* task2 = new QStandardItem("Task 2");
model->appendRow({task1, new QStandardItem(false)});
model->appendRow({task2, new QStandardItem(true)});
 
tableView->show();
        在上述代码中，我们创建了两个任务项，并将其添加到模型中。每个任务项包含任务名称和完成状态。通过调用 tableView->show()，我们将任务列表显示在界面上。

        通过以上的实例，我们展示了如何使用 QItemDelegate 定制化 Item 视图的外观和交互行为。通过重写委托类的函数，我们可以实现自定义的绘制、编辑和数据更新逻辑，以满足特定的需求。
————————————————

                            本文为博主原创文章，未经博主允许不得转载。
                        
原文链接：https://blog.csdn.net/baidu_18624493/article/details/130594393