Qt QTableWidget列头拖动时单元格部件宽度无法实时更新问题

问题根源 #

使用setCellWidget()添加的单元格部件，默认仅在列宽调整完成（鼠标释放）时才会更新几何信息，拖动过程中不会同步跟随列宽变化，导致视觉上的延迟。

解决方案：自定义QHeaderView实时同步 #

通过重写QHeaderView的鼠标移动事件，在拖动列头的过程中主动更新对应列所有cellWidget的几何参数，强制触发表格布局刷新。

1. 实现自定义HeaderView类

#include <QHeaderView>
#include <QMouseEvent>
#include <QTableWidget>

class SyncHeaderView : public QHeaderView
{
    Q_OBJECT
public:
    explicit SyncHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)
        : QHeaderView(orientation, parent) {}

protected:
    void mouseMoveEvent(QMouseEvent *event) override
    {
        QHeaderView::mouseMoveEvent(event);
        // 仅在列宽拖动过程中执行同步
        if (isSectionResizing()) {
            auto table = qobject_cast<QTableWidget*>(parentWidget());
            if (!table) return;

            int currentCol = logicalIndexAt(event->pos());
            // 遍历当前列所有行，更新cellWidget的几何位置
            for (int row = 0; row < table->rowCount(); ++row) {
                QWidget* widget = table->cellWidget(row, currentCol);
                if (widget) {
                    QRect cellRect = table->visualItemRect(table->item(row, currentCol));
                    widget->setGeometry(cellRect);
                }
            }
            // 刷新视图，确保后续列位置同步更新
            table->viewport()->update();
        }
    }
};

2. 替换QTableWidget的默认表头

初始化QTableWidget后，将其水平表头替换为自定义的SyncHeaderView：

// 假设你的QTableWidget对象是ui->tableWidget
auto syncHeader = new SyncHeaderView(Qt::Horizontal, ui->tableWidget);
ui->tableWidget->setHorizontalHeader(syncHeader);

3. 优化CellWidget的自适应能力

为确保cellWidget内部控件能跟随宽度变化，设置其大小策略为可扩展：

QWidget* cellWidget = new QWidget();
// 设置大小策略，让widget自适应单元格尺寸
cellWidget->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
// 向widget添加子控件和布局...
ui->tableWidget->setCellWidget(rowIndex, colIndex, cellWidget);

原理说明 #

• 重写mouseMoveEvent后，在列宽拖动的每一次鼠标移动时，都会触发当前列cellWidget的几何更新。
• 通过visualItemRect()获取单元格的实时位置和尺寸，直接同步给cellWidget。
• 调用viewport()->update()强制刷新表格视图，确保后续列的位置也能实时更新。

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