如何为可双击编辑的QTableWidgetItem绘制边框？

核心思路是利用Qt的项视图代理机制，自定义QStyledItemDelegate来绘制边框，同时保留QTableWidgetItem的原生双击编辑功能。

步骤1：自定义边框代理类 #

继承QStyledItemDelegate并重写paint方法，先绘制默认的项内容，再根据标记判断是否绘制边框：

#include <QStyledItemDelegate>
#include <QPainter>
#include <QTableWidgetItem>

class BorderDelegate : public QStyledItemDelegate
{
    Q_OBJECT
public:
    explicit BorderDelegate(QObject *parent = nullptr) : QStyledItemDelegate(parent) {}

    void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override
    {
        // 先绘制项的默认内容（包括文本、编辑状态等）
        QStyledItemDelegate::paint(painter, option, index);

        // 通过自定义Role判断当前项是否需要边框（这里用Qt::UserRole+1作为标记位）
        if (index.data(Qt::UserRole + 1).toBool()) {
            // 设置边框样式：红色、2px宽度
            QPen borderPen(Qt::red, 2);
            painter->setPen(borderPen);
            // 绘制边框，调整矩形避免与单元格边缘重叠
            painter->drawRect(option.rect.adjusted(1, 1, -1, -1));
        }
    }
};

步骤2：在QTableWidget中使用代理 #

将自定义代理设置到表格上，然后通过给QTableWidgetItem设置自定义Role数据来控制边框显示：

// 给表格设置自定义代理
ui->tableWidget->setItemDelegate(new BorderDelegate(this));

// 创建带边框的可编辑项
QTableWidgetItem *borderItem = new QTableWidgetItem("可编辑带边框");
// 确保项支持双击编辑
borderItem->setFlags(borderItem->flags() | Qt::ItemIsEditable);
// 标记需要绘制边框
borderItem->setData(Qt::UserRole + 1, true);
ui->tableWidget->setItem(0, 0, borderItem);

// 创建普通可编辑项（无框）
QTableWidgetItem *normalItem = new QTableWidgetItem("普通可编辑项");
normalItem->setFlags(normalItem->flags() | Qt::ItemIsEditable);
ui->tableWidget->setItem(0, 1, normalItem);

方案优势（对应你的问题） #

1. 绕过QTableWidgetItem无样式表的限制：直接通过绘制API实现边框，无需依赖样式表。
2. 保留双击编辑功能：完全使用原生QTableWidgetItem，不需要插入QLabel等控件，原生编辑逻辑不受影响。
3. 准确获取项尺寸：paint方法中的option.rect直接提供了当前项的精确矩形区域，无需额外获取尺寸。

扩展说明 #

• 可以修改边框的颜色、宽度、样式（比如虚线），只需要调整QPen的参数即可。
• 标记边框的自定义Role可以根据需求修改，比如用Qt::UserRole + 100避免冲突。
• 如果需要针对特定列/行设置边框，可以在paint方法中通过index.row()或index.column()判断，结合Role标记实现更细粒度的控制。

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