QStyledItemDelegate自定义代理不显示问题求助

你的自定义代理出现空白/显示异常的核心原因有两个：

1. paint函数未执行绘制操作：仅更新了内部控件的内容，但未将控件渲染到列表项的绘制区域中。
2. 共用单个控件实例：构造函数中创建的ui、iconLabel等是代理的成员变量，所有列表项复用同一控件，导致绘制混乱，只会显示最后更新的内容且位置错误。

修复步骤 #

1. 重构paint函数，添加绘制逻辑 #

在paint函数中，需将控件内容绘制到当前项的矩形区域，同时先处理项的状态（选中、hover等）：

void EntityListDelegate::paint(QPainter* painter, const QStyleOptionViewItem& option, const QModelIndex& index) const
{
    // 先绘制项的状态背景（选中、hover效果）
    QStyledItemDelegate::paint(painter, option, index);

    // 创建临时控件承载当前项内容
    QWidget tempWidget;
    tempWidget.setFixedSize(option.rect.size());
    
    QHBoxLayout* hLayout = new QHBoxLayout(&tempWidget);
    QLabel* iconLabel = new QLabel(&tempWidget);
    iconLabel->setFixedSize(40, 40);
    
    QVBoxLayout* vLayout = new QVBoxLayout();
    QLabel* nameLabel = new QLabel(&tempWidget);
    QLabel* typeLabel = new QLabel(&tempWidget);

    // 绑定当前项的数据
    nameLabel->setText(index.data(Qt::DisplayRole).toString());
    switch (qvariant_cast<int>(index.data(UserRoles::Type)))
    {
        case EntityType::Foo:
            iconLabel->setPixmap(QPixmap(":/icons/foo.png").scaled(40,40, Qt::KeepAspectRatio));
            typeLabel->setText("Foo");
            break;
        case EntityType::Bar:
            iconLabel->setPixmap(QPixmap(":/icons/bar.png").scaled(40,40, Qt::KeepAspectRatio));
            typeLabel->setText("Bar");
            break;
        case EntityType::Baz:
            iconLabel->setPixmap(QPixmap(":/icons/baz.png").scaled(40,40, Qt::KeepAspectRatio));
            typeLabel->setText("Baz");
            break;
        default:
            iconLabel->setPixmap(QPixmap(":/icons/Placeholder.png").scaled(40,40, Qt::KeepAspectRatio));
            typeLabel->setText("Unknown type");
            break;
    }

    // 布局控件
    hLayout->addWidget(iconLabel);
    vLayout->addWidget(nameLabel);
    vLayout->addWidget(typeLabel);
    hLayout->addLayout(vLayout);
    tempWidget.setLayout(hLayout);

    // 将临时控件渲染到当前项区域
    painter->save();
    painter->translate(option.rect.topLeft());
    tempWidget.render(painter);
    painter->restore();
}

2. 移除构造函数中的全局控件 #

删除构造函数内创建的ui、iconLabel等成员变量，避免复用冲突。

3. 重写sizeHint函数 #

返回列表项的固定尺寸，确保列表正确分配空间：

QSize EntityListDelegate::sizeHint(const QStyleOptionViewItem& option, const QModelIndex& index) const
{
    return QSize(option.rect.width(), 40); // 自定义高度为40px
}

优化建议 #

若担心临时控件创建的性能开销，可将控件设为mutable成员变量，在paint函数中更新内容后再渲染，避免重复创建控件实例。同时需确保资源文件中的图标路径正确，防止加载失败。

内容的提问来源于stack exchange，提问作者Peter Hoff