如何修改QTableWidget中指定行列分隔线的样式？

要实现单元格之间区域的彩色加粗分隔线，且线条延伸至表头，不能依赖QItemDelegate（它仅在单元格内部绘制），而是通过重写QTableWidget和QHeaderView的paintEvent，直接在视图的viewport上绘制分隔线，具体实现如下：

核心思路 #

1. 禁用默认网格线，避免与自定义线条冲突
2. 重写表头的paintEvent，在目标列/行的对应位置绘制分隔线，覆盖表头区域
3. 重写表格的paintEvent，在对应位置绘制分隔线，覆盖单元格内容区域
4. 利用Qt内置的视图坐标计算方法，确保滚动时分隔线位置始终准确

代码实现 #

自定义表头（实现表头部分的分隔线） #

#include <QHeaderView>
#include <QPainter>

class CustomHeaderView : public QHeaderView
{
public:
    explicit CustomHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)
        : QHeaderView(orientation, parent), m_targetColumn(2), m_lineColor(Qt::red), m_lineWidth(3)
    {}

    // 提供接口动态调整分隔参数
    void setSeparator(int column, const QColor& color, int width) {
        m_targetColumn = column;
        m_lineColor = color;
        m_lineWidth = width;
        update(); // 触发重绘
    }

protected:
    void paintEvent(QPaintEvent *event) override {
        // 先绘制默认表头内容
        QHeaderView::paintEvent(event);

        QPainter painter(viewport());
        painter.setPen(QPen(m_lineColor, m_lineWidth));

        // 计算目标列右侧的x坐标（自动处理滚动偏移）
        int lineX = sectionViewportPosition(m_targetColumn) + sectionSize(m_targetColumn);
        // 绘制贯穿表头的垂直线
        painter.drawLine(lineX, 0, lineX, viewport()->height());
    }

private:
    int m_targetColumn;    // 要分隔的目标列索引
    QColor m_lineColor;    // 分隔线颜色
    int m_lineWidth;       // 分隔线宽度
};

自定义表格（实现单元格区域的分隔线） #

#include <QTableWidget>
#include <QPainter>

class CustomTableWidget : public QTableWidget
{
public:
    explicit CustomTableWidget(QWidget *parent = nullptr)
        : QTableWidget(parent), m_targetColumn(2), m_lineColor(Qt::red), m_lineWidth(3)
    {
        setShowGrid(false); // 禁用默认网格线
        // 设置自定义表头
        auto header = new CustomHeaderView(Qt::Horizontal, this);
        setHorizontalHeader(header);
    }

    // 同步设置分隔参数到表头
    void setColumnSeparator(int column, const QColor& color, int width) {
        m_targetColumn = column;
        m_lineColor = color;
        m_lineWidth = width;
        static_cast<CustomHeaderView*>(horizontalHeader())->setSeparator(column, color, width);
        update();
    }

protected:
    void paintEvent(QPaintEvent *event) override {
        // 先绘制默认单元格内容
        QTableWidget::paintEvent(event);

        QPainter painter(viewport());
        painter.setPen(QPen(m_lineColor, m_lineWidth));

        // 计算目标列右侧的x坐标（自动处理滚动偏移）
        int lineX = columnViewportPosition(m_targetColumn) + columnWidth(m_targetColumn);
        // 绘制贯穿单元格区域的垂直线
        painter.drawLine(lineX, 0, lineX, viewport()->height());
    }

private:
    int m_targetColumn;
    QColor m_lineColor;
    int m_lineWidth;
};

注意事项 #

• 如果需要分隔行，只需将上述逻辑改为计算y坐标、绘制水平线，同时重写垂直表头的paintEvent即可
• 支持动态调整分隔线参数，调用setColumnSeparator即可实时更新效果
• 滚动时，sectionViewportPosition和columnViewportPosition会自动处理偏移量，保证分隔线始终对齐目标列/行
• 若需保留其他网格线，可不关闭setShowGrid(false)，但需确保自定义线条宽度大于默认网格线，避免被覆盖

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