Qt中如何在QStyledItemDelegate委托内绘制使用可交互QLineEdit

你当前实现只在paint函数里绘制了QLineEdit的边框外观，没有创建真实的交互控件实例，也没有对接委托的编辑触发、位置对齐、数据回写全流程，所以只能看到空白框无法操作。按以下步骤修复即可：

• 抽离输入框位置计算逻辑：把原来写在paint里计算rectLE的代码抽成独立公共函数（比如QRect calcInputRect(const QRect &itemRect) const），保证绘制、点击命中、编辑器位置对齐三个场景用的是同一套坐标计算逻辑，不会错位。
• 重写editorEvent做命中检测：只有鼠标点击落在输入框区域内时，才触发编辑器创建，点击商品图、商品名等其他区域不触发编辑。
• 重写updateEditorGeometry：把创建出来的真实QLineEdit控件位置严格对齐你绘制的输入框区域，不要默认占满整个列表项。
• 补全setModelData逻辑：把用户在输入框里修改的内容校验后写回数据模型，完成模型到视图、视图到模型的双向绑定。
• 优化paint逻辑：不要在paint函数里临时创建QLineEdit实例获取样式，paint是高频调用函数，频繁创建销毁控件会导致列表滚动卡顿，直接调用全局QStyle接口绘制即可，非编辑状态下要把模型里存储的数量文本画到输入框区域内，避免显示空白。

修复后的核心代码参考：

// 抽离的公共位置计算函数
QRect CustomDelegate::calcInputRect(const QRect &itemRect) const
{
    // 这里替换成你原来计算rectLE的逻辑，示例为输入框靠右侧宽60高24垂直居中
    return QRect(itemRect.right() - 70, itemRect.center().y() - 12, 60, 24);
}

void CustomDelegate::paint(QPainter *painter,
                           const QStyleOptionViewItem &opt,
                           const QModelIndex &idx) const
{
    // 先绘制商品图、商品名等其他元素
    // ... 其他绘制逻辑

    // 绘制输入框边框
    QStyleOptionFrame panelOpt;
    panelOpt.initFrom(opt.widget);
    panelOpt.rect = calcInputRect(opt.rect);
    panelOpt.state = QStyle::State_Sunken | QStyle::State_Enabled;
    panelOpt.lineWidth = 1;
    QApplication::style()->drawPrimitive(QStyle::PE_PanelLineEdit, &panelOpt, painter);

    // 非编辑状态下绘制输入框内的数量文本
    if (!(opt.state & QStyle::State_Editing)) {
        QString countText = idx.data(Qt::EditRole).toString();
        QRect textRect = panelOpt.rect.adjusted(4, 0, -4, 0);
        painter->drawText(textRect, Qt::AlignVCenter | Qt::AlignLeft, countText);
    }
}

bool CustomDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index)
{
    if (event->type() == QEvent::MouseButtonRelease) {
        QMouseEvent *mouseEv = static_cast<QMouseEvent*>(event);
        QRect inputRect = calcInputRect(option.rect);
        if (inputRect.contains(mouseEv->pos())) {
            // 命中输入框区域，触发编辑
            QAbstractItemView *view = qobject_cast<QAbstractItemView*>(option.widget);
            if (view) view->edit(index);
            return true;
        }
    }
    return QStyledItemDelegate::editorEvent(event, model, option, index);
}

QWidget *CustomDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QLineEdit *editor = new QLineEdit(parent);
    // 给数量输入框加数字校验，只允许输入正整数
    editor->setValidator(new QIntValidator(1, 999, editor));
    return editor;
}

void CustomDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    QLineEdit *lineEdit = qobject_cast<QLineEdit*>(editor);
    if (lineEdit) {
        // 从模型读取当前存储的商品数量，不要写死固定文本
        int curCount = index.data(Qt::EditRole).toInt();
        lineEdit->setText(QString::number(curCount));
    }
}

void CustomDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    QLineEdit *lineEdit = qobject_cast<QLineEdit*>(editor);
    if (lineEdit) {
        bool ok = false;
        int inputCount = lineEdit->text().toInt(&ok);
        if (ok && inputCount > 0) {
            // 合法值写回模型
            model->setData(index, inputCount, Qt::EditRole);
        }
    }
}

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

Qt默认委托机制单个QModelIndex只支持一个顶层编辑器控件，多输入框场景用容器承载即可，不需要修改委托基类逻辑：

• createEditor阶段先创建一个QWidget作为父容器，用布局把多个QLineEdit按需要的位置排列在容器里，给每个QLineEdit设置动态属性标记对应的字段，比如setProperty("field", "buyCount")标记购买数量输入框、setProperty("field", "remark")标记备注输入框。
• setEditorData阶段遍历容器下所有QLineEdit子控件，根据field属性标记，从模型对应的数据角色（默认数量用Qt::EditRole，其他自定义字段从Qt::UserRole + 1开始依次分配即可）读取数据赋值。
• setModelData阶段同样遍历所有子输入框，根据field属性把用户输入的内容校验后写回模型对应角色。
• editorEvent里分别判断点击命中的是哪个输入框的区域，触发编辑后可以直接给对应输入框设置焦点，优化交互体验。

多输入框场景的核心代码参考：

QWidget *CustomDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QWidget *container = new QWidget(parent);
    QHBoxLayout *lay = new QHBoxLayout(container);
    lay->setContentsMargins(2, 2, 2, 2);
    lay->setSpacing(6);

    QLineEdit *countEdit = new QLineEdit(container);
    countEdit->setProperty("field", "buyCount");
    countEdit->setValidator(new QIntValidator(1, 999, countEdit));
    lay->addWidget(countEdit);

    QLineEdit *remarkEdit = new QLineEdit(container);
    remarkEdit->setProperty("field", "remark");
    lay->addWidget(remarkEdit);

    return container;
}

void CustomDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    const auto edits = editor->findChildren<QLineEdit*>();
    for (QLineEdit *le : edits) {
        QString field = le->property("field").toString();
        if (field == "buyCount") {
            le->setText(index.data(Qt::EditRole).toString());
        } else if (field == "remark") {
            le->setText(index.data(Qt::UserRole + 1).toString());
        }
    }
}

void CustomDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    const auto edits = editor->findChildren<QLineEdit*>();
    for (QLineEdit *le : edits) {
        QString field = le->property("field").toString();
        if (field == "buyCount") {
            bool ok = false;
            int cnt = le->text().toInt(&ok);
            if (ok && cnt > 0) model->setData(index, cnt, Qt::EditRole);
        } else if (field == "remark") {
            model->setData(index, le->text(), Qt::UserRole + 1);
        }
    }
}

注意：如果列表项里交互控件超过3个，不建议继续用委托绘制的方案，直接用QListWidget::setItemWidget挂真实控件的方案实现更简单，维护成本更低。

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