Qt委托(Delegate)类技术详解

于 2025-06-20 07:45:36 发布
阅读量1k 收藏 26
点赞数 10
CC 4.0 BY-SA版权
分类专栏： QT开发技术 文章标签： qt 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_15181569/article/details/148754044

Qt委托（Delegate）类技术详解

Qt 委托(Delegate)类概述

Qt的Delegate类用于在视图组件（如QListView、QTableView、QTreeView）中控制数据的显示和编辑方式。Delegate允许开发者自定义单元格的外观、编辑器创建和数据处理逻辑，常见子类包括QStyledItemDelegate和QItemDelegate。
主要负责：

  • 控制数据项的显示方式
  • 提供数据项的编辑功能
  • 管理模型与视图之间的数据交互

委托类继承关系：

在这里插入图片描述

核心功能与使用场景

  1. 数据展示定制
    重写paint()方法可自定义单元格的绘制逻辑，例如显示进度条、图标组合或特殊格式文本。

  2. 数据编辑控制
    通过createEditor()、setEditorData()和setModelData()实现编辑器的创建、数据同步与回写。

  3. 交互增强
    在editorEvent()中处理鼠标/键盘事件，支持复杂交互如双击触发二级对话框。

常用子类对比

QStyledItemDelegate

  • 推荐使用的默认委托，支持样式表（QSS）。
  • 自动处理标准数据类型（如颜色、字体）的编辑控件。
  • 示例代码（简单的星级评分委托）：
#include <QStyledItemDelegate>
#include <QPainter>

class StarDelegate : public QStyledItemDelegate {
    Q_OBJECT
public:
    explicit StarDelegate(QObject *parent = nullptr) 
        : QStyledItemDelegate(parent) {}
    
    // 重写绘制方法
    void paint(QPainter *painter, const QStyleOptionViewItem &option,
               const QModelIndex &index) const override {
        if (index.data().canConvert<int>()) {
            int rating = index.data().toInt();
            
            painter->save();
            painter->setRenderHint(QPainter::Antialiasing, true);
            
            // 绘制背景
            if (option.state & QStyle::State_Selected) {
                painter->fillRect(option.rect, option.palette.highlight());
            }
            
            // 绘制星星
            QRect starRect = option.rect.adjusted(2, 2, -2, -2);
            starRect.setWidth(starRect.height()); // 保持正方形
            
            for (int i = 0; i < 5; ++i) {
                if (i < rating) {
                    painter->setBrush(Qt::yellow);
                    painter->setPen(Qt::black);
                } else {
                    painter->setBrush(Qt::NoBrush);
                    painter->setPen(Qt::gray);
                }
                
                painter->drawPolygon(createStar(starRect));
                starRect.translate(starRect.width() + 2, 0);
            }
            
            painter->restore();
        } else {
            QStyledItemDelegate::paint(painter, option, index);
        }
    }
    
    // 重写大小计算
    QSize sizeHint(const QStyleOptionViewItem &option,
                   const QModelIndex &index) const override {
        return QSize(5 * 20, 20); // 5颗星，每颗20px宽
    }

private:
    // 创建五角星形状
    QPolygonF createStar(const QRect &rect) const {
        QPolygonF star;
        qreal radius = rect.height() / 2;
        qreal centerX = rect.left() + radius;
        qreal centerY = rect.top() + radius;
        
        for (int i = 0; i < 5; ++i) {
            qreal angle = 2 * M_PI * i / 5 - M_PI / 2;
            star << QPointF(centerX + radius * cos(angle),
                           centerY + radius * sin(angle));
            
            angle += M_PI / 5;
            star << QPointF(centerX + radius * 0.5 * cos(angle),
                           centerY + radius * 0.5 * sin(angle));
        }
        
        return star;
    }
};

QItemDelegate

  • 旧版实现，不依赖样式系统。
  • 需要手动处理更多绘图细节，适用于特殊兼容需求。

实现自定义委托的关键步骤

1. 继承QStyledItemDelegate
创建子类并重写必要方法：

class StarRatingDelegate : public QStyledItemDelegate {
    Q_OBJECT
public:
    void paint(QPainter *painter, /*...*/) const override;
    QSize sizeHint(/*...*/) const override;
    QWidget *createEditor(/*...*/) const override;
};

2. 实现绘图逻辑
在paint()中利用QPainter绘制自定义内容：

void StarRatingDelegate::paint(QPainter *painter, /*...*/) const {
    int stars = index.data().toInt();
    QRect rect = option.rect.adjusted(2, 2, -2, -2);
    painter->drawRect(rect);
    painter->fillRect(rect, QColor(stars * 50, 0, 0)); // 示例：根据值变色
}

3. 创建编辑器控件
返回适合数据类型的编辑组件（如QSpinBox、QComboBox）：

QWidget *createEditor(QWidget *parent, /*...*/) const override {
    QSpinBox *editor = new QSpinBox(parent);
    editor->setRange(0, 5);
    return editor;
}

4. 数据同步处理
双向绑定模型与编辑器数据：

void setEditorData(QWidget *editor, /*...*/) const override {
    QSpinBox *box = static_cast<QSpinBox*>(editor);
    box->setValue(index.data().toInt());
}

void setModelData(QWidget *editor, /*...*/) const override {
    QSpinBox *box = static_cast<QSpinBox*>(editor);
    model->setData(index, box->value());
}

高级应用技巧

动态样式调整
通过initStyleOption()修改基础样式选项，再调用父类绘制：

void paint(QPainter *painter, /*...*/) const override {
    QStyleOptionViewItem opt = option;
    if (index.row() % 2 == 0) 
        opt.font.setBold(true);
    QStyledItemDelegate::paint(paint, opt, index);
}

编辑器事件过滤
在eventFilter()中捕获编辑器特定事件（如回车确认编辑）。

性能优化
对于大型数据集，避免在paint()中进行复杂计算，优先使用模型角色（如Qt::DecorationRole）预处理数据。

条件委托

class ConditionalDelegate : public QStyledItemDelegate {
public:
    QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option,
                         const QModelIndex &index) const override {
        if (index.column() == 0) { // 第一列使用QLineEdit
            return new QLineEdit(parent);
        } 
        else if (index.data().canConvert<double>()) { // 数值使用QSpinBox
            QSpinBox *editor = new QSpinBox(parent);
            editor->setRange(0, 100);
            return editor;
        }
        return QStyledItemDelegate::createEditor(parent, option, index);
    }
    
    void setModelData(QWidget *editor, QAbstractItemModel *model,
                     const QModelIndex &index) const override {
        if (index.column() == 0 && qobject_cast<QLineEdit*>(editor)) {
            model->setData(index, static_cast<QLineEdit*>(editor)->text());
        }
        else if (qobject_cast<QSpinBox*>(editor)) {
            model->setData(index, static_cast<QSpinBox*>(editor)->value());
        }
        else {
            QStyledItemDelegate::setModelData(editor, model, index);
        }
    }
};

委托开发的最佳实践

1、性能优化：

  • 在paint()方法中保存和恢复painter状态
  • 避免在paint()中创建临时对象
  • 对于复杂绘制，考虑缓存绘制结果

2、可访问性：

  • 确保委托支持高DPI显示
  • 考虑颜色对比度以满足可访问性要求

3、一致性：

  • 继承QStyledItemDelegate而不是QAbstractItemDelegate
  • 使用QStyle绘制标准UI元素

4、编辑体验：

  • 在编辑器中使用合适的验证器
  • 提供清晰的编辑反馈

委托开发实战演示

1、效果展示

在这里插入图片描述

2、开发流程

a、新建工程

在这里插入图片描述

b、添加MStarDelegate类

.hpp

#ifndef MSTARDELEGATE_H
#define MSTARDELEGATE_H

#include <QObject>
#include <QStyledItemDelegate>
#include <QPainter>
#include <QSpinBox>

class MStarDelegate: public QStyledItemDelegate
{
    Q_OBJECT
public:
    MStarDelegate(QObject *parent = nullptr);
    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;
    void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const override;
};

#endif // MSTARDELEGATE_H

.cpp

#include "mstardelegate.h"

MStarDelegate::MStarDelegate(QObject *parent):
    QStyledItemDelegate(parent)
{

}

void MStarDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QPointF vertex[5]; /* 五角星 Size=20,20 */
    for (int i = 0; i < 5; i++)
    {
        vertex[i].setX(+10 * sinf(i * 144.0f * (3.1415926535f / 180.0f)));
        vertex[i].setY(-10 * cosf(i * 144.0f * (3.1415926535f / 180.0f)));
    }
    int many = index.data(Qt::DisplayRole).toInt();
    painter->setPen(Qt::NoPen);
    painter->setBrush(QColor(255, 170, 0));
    QSize iconSize = option.decorationSize;
    QRect thisRect = option.rect;
    int y = thisRect.y() + thisRect.height() / 2;
    for (int i = 0; i < many; i++)
    {
        painter->save();
        painter->setRenderHint(QPainter::Antialiasing);
        qreal left = 2 + iconSize.width() * 0.5 + (2 + iconSize.width()) * i;
        painter->translate(left, y);
        painter->scale(iconSize.width() / 20.0, iconSize.height() / 20.0);
        painter->drawPolygon(vertex, 5, Qt::WindingFill);
        painter->restore();
    }
    // if (option.state & QStyle::State_Selected)
    // {
    //     painter->fillRect(option.rect, option.palette.highlight());
    // }
}

QWidget *MStarDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QSpinBox* cbBox = new QSpinBox(parent);
    cbBox->setRange(0, 5);
    cbBox->setSuffix(u8"星");
    return cbBox;
}

void MStarDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    QSpinBox* cbWidget = dynamic_cast<QSpinBox*>(editor);
    cbWidget->setValue(index.data(Qt::DisplayRole).toInt());
}

void MStarDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    int level = dynamic_cast<QSpinBox*>(editor)->value();
    model->setData(index, level, Qt::DisplayRole);
}

void MStarDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    editor->setGeometry(option.rect);
}

c、工程结构

在这里插入图片描述

d、放置TableView

在这里插入图片描述

e、设置委托

    this->ui->tableView->setItemDelegateForColumn(0, new MStarDelegate(this->ui->tableView));
    QStandardItemModel* model = new QStandardItemModel(this->ui->tableView);
    model->setHorizontalHeaderLabels({ u8"点数", u8"状态" });
    model->setVerticalHeaderLabels({ "哪吒", "孙悟空", "猪八戒", "唐僧" });
    model->setColumnCount(2);
    model->setRowCount(4);
    for (int i = 0; i < 4; i++)
    {
        model->setItem(i, 0, new QStandardItem(QString::number(i)));
        model->setItem(i, 1, new QStandardItem(QString("剩余%1点血").arg(i)));
    }
    this->ui->tableView->setModel(model);

在这里插入图片描述

【QT开发】项目委托QItemDelegate类详解及实战应用
科技改变人类，技术成就未来
07-07 1342
QItemDelegate是Qt提供的一个功能强大且灵活的项目委托类，通过本篇文章的学习，你应该对QItemDelegate有了全面的理解，能够在自己的项目中正确使用它。QItemDelegate在用户界面中帮助你更好地自定义项数据显示和编辑行为，实现交互式和响应式的应用程序，有助于创建用户友好和高效的自定义单元格渲染、自定义编辑器等应用场景。
Qt 中委托（Delegate）的使用
FucMobile的博客
09-13 786
委托（Delegate）是 Qt 框架中一个重要的概念，它用于定制和扩展控件的外观和行为。通过使用委托，我们可以实现对控件的绘制、编辑和交互等方面进行个性化的定制。这些控件在默认情况下提供了一种标准的显示方式，但是有时候我们需要对其中的某些单元格或项进行自定义的展示和编辑。通过以上步骤，我们就可以在 Qt 中使用委托来实现对控件外观和行为的个性化定制。通过重写委托类的方法，我们可以实现数据展示、编辑和交互等方面的定制。完成了自定义委托类的编写后，我们需要在使用委托的控件中进行设置。方法来为指定列设置委托。
Qt学习之路(48): 自定义委托
weixin_34259232的博客
01-27 563
好久没有来写文章了，由于家里面宽带断了，所以一直没能更新，今天现在写上一篇。 还是继续前面的内容。前面我们分三次把自定义model说完了，其实主要还是那三个实例。在 model/view 架构中，与model同等重要的就是 view。 我们知道，在经典的 MVC 模型中，view用于向用户展示 model 的数据。但是，Qt提供的不是 MVC 三层架构，而是一...
QT中委托(QItemDelegate/QStyledItemDelegate)的使用，以及自定义Delegate
热门推荐
System Architect
08-15 1万+
委托(QItemDelegate/QStyledItemDelegate)的功能很强大，可以把控件设置成只读、表格的某一列设置成各种自己想要的控件 -------------- 定义自己的Delegate： class MyDelegate: public QStyledItemDelegate {     //创建你编辑时候的控件 QWidget* createEditor(QWid
Qt模型/视图架构——委托（delegate）
雷东宸的博客
07-17 1973
Qt中的委托代理是什么？有什么用？如何使用？一文讲清楚！！！
Qt之模型/视图（委托）
信笔涂鸦
01-17 937
概念     不同于模型 - 视图 - 控制器模式，模型/视图设计不包括用于管理与用户交互的一个完全独立的组件。一般情况，视图负责将模型数据呈现给用户以及处理用户输入。为了输入更加具有灵活性，则由委托来执行交互。这些组件提供输入功能，且在一些视图中还负责渲染个别项目。控制委托的标准接口在QAbstractItemDelegate类中定义。     委托能够通过实现的paint()和sizeHi
qt 委托 delegate
证券指标的专栏
10-01 1358
委托的作用是，显示和编辑视图view中的item。 大多数情况下，view视图中的默认delegate委托已经足够了。一般不需要自定义委托。 如果项更好的控制有关项item的显示，可用在自定义model中实现，data（）函数中，根据不同的role，返回不同的值。 比如：Qt::FontRole，Qt::DisplayRole等角色。 data（）函数会自动的被委托调用。
(六)Qt Delgate的使用 简单说明
qimo601的专栏
05-21 1126
  (一) Qt Model/View 的简单说明 、预定义模型 (二)使用预定义模型 QstringListModel例子 (三)使用预定义模型QDirModel的例子 (四)Qt实现自定义模型基于QAbstractTableModel (五)Qt实现自定义模型基于QAbstractItemModel  (六) Qt实现自定义委托 QDelegate  Delegate  类 ...
【Qt】Qt委托（Delegate）-负责数据项的显示和编辑行为
最新发布
weixin_43510208的博客
05-13 855
委托（Delegate） 是模型-视图架构的核心组件，负责数据项的**显示**和**编辑**行为。它允许开发者完全自定义视图（如 `QTableView`、`QListView`、`QTreeView`）中每个数据项的渲染和交互方式。
qt delegate 委托 多级联动 小结
风声世界的专栏
01-15 3222
<br />最近使用qt写程序用到了treewidget和tablewidget<br />涉及到编辑默认情况下可以设置treewidget和tablewidget的item可编辑属性来进行编辑<br />默认情况只是简单的文本输入格式<br />在qt的demo中看到了spin box delegate实例<br /><br /> <br />想到了使用delegate 委托<br />该实例只是对整个tablewidget使用同一个spin box格式的delegata<br />那么对于不同的列时候不
Qt之QComboBox委托
03-02
使用QCombobox来实现QQ中多账号管理的操作 易用性很好 博客地址：http: blog sina com cn liang19890820
QT TableView自定义委托
03-29
效果看https://blog.csdn.net/Sakuya__/article/details/88895498。使用自定义委托实现在TableView中添加Combobox、Spainbox、CheckBox控件。
Qt5Delegate
09-04
Qt5下实现多种代理有日期选择spinbox等.
Qt 自定义委托(delegate) 实现进度条
01-03
前言: 本文就不介绍基础了 需要具备 M-V-D的知识 model view delegate 不清楚 mvd 结构的 建议先去了解一下 否则看起来比较吃力 项目结构比较简单清晰 一个小demo github 源码地址 main 函数 manwindow 主界面 progressbardelegate 自定义的进度条委托 我们自定义委托 直接上代码吧 我们这个小demo 只需要 重写基类的 paint 就行 如果有其他需要 可以看基类的 成员函数 这里就不多说了 paint 的实现 首先 只有第2列的 单元格的内容才变为进度条 所以 我们上面的判断条件 是 index.colu
QT中Model-View-Delegate委托代理机制用法介绍
yang1fei2的博客
07-05 4841
之前的一篇文章中介绍过QT的委托代理机制，那时候由于理解的比较浅就简单的给了一个例子。最近又做了一部分相关的工作，发现之前的理解有点问题。这里就详细的介绍一下QT的委托代理机制的用法，希望对大家有帮助。 Model-View-Delegate机制可以简单的理解为将本地的一些数据以特定的UI形式呈现出来。常见的数据结构包括列表数据(list)、表格数据(table)、树状数据(tree)，分别对应着QT中的QListView、QTableView、QTreeView控件。...
【QT开发】样式化项目委托QStyledItemDelegate类详解及实战应用
科技改变人类，技术成就未来
07-07 1376
QStyledItemDelegate是Qt提供的一个功能强大且灵活的样式化项目委托类，通过本篇文章的学习，你应该对QStyledItemDelegate有了全面的理解，能够在自己的项目中正确使用它。QStyledItemDelegate在用户界面中帮助你更好地自定义项数据显示和编辑行为，实现交互式和响应式的应用程序，有助于创建用户友好和高效的自定义单元格渲染、自定义编辑器等应用场景。
QT-Quick中QQmlListProperty详解
.
04-11 858
QQmlListProperty是QT-Quick中的一个类，用于在C++中公开QML中的列表数据。与其他Qt元素不同，QQmlListProperty只是一个半透明的包装器，它将QML列表属性的访问委托给C++类。我们只需要在C++中实现一些包装器函数和获取QQmlListProperty句柄的函数，就可以轻松地将C++数据类型公开到QML代码中。下面是一个简单的示例，演示了如何使用QQmlListProperty来管理QML中的一组元素。三、QQmlListProperty的示例代码。
qt delegate
weixin_33754065的博客
10-13 161
http://devbean.blog.51cto.com/448512/271255 http://blog.csdn.net/tonylk/article/details/1315053 http://stackoverflow.com/questions/5457154/qstyleditemdelegate-how-does-updateeditorgeometry-works
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小灰灰搞电子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值