Qt代理委托机制详解与实战应用

1. Qt代理委托基础概念解析

在Qt框架中，代理委托（Delegate）机制是模型/视图架构的核心组成部分。简单来说，它就像是一位专业的"数据化妆师"——当模型中的数据需要在视图中展示时，委托决定如何绘制每个数据项；当用户需要编辑数据时，委托又负责创建合适的编辑器控件。

QStyledItemDelegate作为Qt默认的代理类，自Qt 4.4起就取代了旧的QItemDelegate。它们的主要区别在于：QStyledItemDelegate会遵循当前应用程序的样式（QStyle）进行绘制，这使得它能够完美支持Qt样式表（QSS）等现代特性。想象一下，如果你的应用程序需要适配不同平台的外观风格，或者需要实现自定义的主题切换，使用QStyledItemDelegate就能自动获得这些能力。

关键提示：在新项目中，除非有特殊兼容性需求，否则都应该优先选择QStyledItemDelegate而非QItemDelegate。官方文档明确建议将其作为自定义委托的基类。

代理委托的工作流程可以概括为三个核心环节：

1. 绘制（Paint）：通过paint()方法决定数据项的视觉呈现
2. 编辑（Edit）：通过createEditor()等方法管理编辑过程
3. 交互（Interaction）：处理用户与数据项的交互事件

2. 核心功能实现原理

2.1 绘制机制深度剖析

QStyledItemDelegate的绘制过程始于paint()方法的重写。这个方法接收三个关键参数：

• QPainter：实际的绘图工具
• QStyleOptionViewItem：包含所有样式信息
• QModelIndex：定位模型中的数据项

一个典型的绘制实现如下：

cpp复制void CustomDelegate::paint(QPainter *painter, 
                          const QStyleOptionViewItem &option,
                          const QModelIndex &index) const
{
    // 1. 准备样式选项
    QStyleOptionViewItem opt = option;
    initStyleOption(&opt, index);
    
    // 2. 绘制背景（包括选中状态）
    const QWidget *widget = option.widget;
    QStyle *style = widget ? widget->style() : QApplication::style();
    style->drawControl(QStyle::CE_ItemViewItem, &opt, painter, widget);
    
    // 3. 自定义内容绘制
    painter->save();
    if (index.data(Qt::UserRole+1).isValid()) {
        drawCustomContent(painter, opt, index);
    }
    painter->restore();
}

重要技巧：在自定义绘制前后务必使用painter->save()和restore()，避免影响后续绘制状态。我曾在一个项目中因为遗漏这个步骤，导致表格的选中状态显示异常。

2.2 编辑流程完整实现

编辑流程涉及四个关键方法的协作：

1. createEditor()：创建编辑器控件

cpp复制QWidget* createEditor(QWidget *p