自定义QItemDelegate无法正常显示问题排查

这绝对是Qt自定义ComboBox代理时最容易踩的坑——你大概率只实现了弹出下拉框的createEditor()方法，却忽略了非编辑状态下的数据渲染逻辑，导致模型里明明存着"Bank"，单元格却显示异常内容。我帮你拆解问题和解决方案：

核心原因分析 #

当你给列设置自定义代理后，Qt不会自动帮你把模型数据映射到单元格显示上。很多人只关注编辑时的下拉框功能，却忘了：

• 单元格的正常显示（非编辑状态）需要代理通过displayText()或paint()方法来渲染内容
• 就算你通过下拉框修改了模型数据，代理没同步显示逻辑的话，单元格依然会显示错误内容

针对性解决方案（基于ComboBoxDelegate） #

假设你的comboboxdelegate.cpp已有基础框架，补充以下关键方法即可：

1. 重写displayText()方法（最直接的修复） #

在代理类中添加这个方法，直接返回模型里的原始值，确保非编辑状态下正确显示：

QString ComboBoxDelegate::displayText(const QVariant &value, const QLocale &locale) const
{
    // 直接返回模型存储的文本，跳过代理默认的处理逻辑
    return value.toString();
}

2. 检查setModelData()方法是否正确同步数据 #

确保下拉框选择的值被正确写入模型的DisplayRole和EditRole：

void ComboBoxDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    QComboBox *comboBox = qobject_cast<QComboBox*>(editor);
    if (comboBox) {
        QString selectedText = comboBox->currentText();
        // 同时设置编辑角色和显示角色，确保模型数据与显示一致
        model->setData(index, selectedText, Qt::EditRole);
        model->setData(index, selectedText, Qt::DisplayRole);
    }
    QItemDelegate::setModelData(editor, model, index);
}

3. 可选：自定义paint()方法（复杂样式需求） #

如果需要更个性化的显示效果，比如改变字体或颜色，可以重写paint()手动绘制：

void ComboBoxDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QStyleOptionViewItem opt = option;
    initStyleOption(&opt, index);
    
    // 从模型获取要显示的文本
    QString displayText = index.data(Qt::DisplayRole).toString();
    opt.text = displayText;
    
    // 用系统样式绘制单元格，保证和其他单元格风格统一
    QApplication::style()->drawControl(QStyle::CE_ItemViewItem, &opt, painter);
}

验证步骤 #

1. 确认模型中对应单元格的Qt::DisplayRole和Qt::EditRole都存储了正确的"Bank"字符串
2. 检查代理是否正确绑定到目标列：ui->tableView->setItemDelegateForColumn(你的目标列索引, new ComboBoxDelegate(this));
3. 重启程序后，非编辑状态下单元格会直接显示"Bank"，编辑时弹出下拉框，修改后内容也会同步更新

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