QItemDelegate

一、简介

二、使用 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