Qt QTableWidget 如何为指定列优先分配水平空间且无横向滚动条

核心需求落地目标 #

• 非第3列（索引2，Qt列索引从0开始计数）先根据自身内容完成列宽自适应
• 视口可用水平空间的剩余部分，全部分配给第3列
• 若第3列内容过宽，自动将超长内容截断为右侧省略号，全程不触发横向滚动条
• 兼容用户手动拖拽调整列宽的交互行为

内置方法的失效原因 #

• 开启setStretchLastSection(true)：默认拉伸的是最后一列，无法将剩余空间优先分配给指定的第3列
• 直接调用resizeColumnsToContents()：会按全表内容把所有列拉至最宽，总宽度超出容器时直接触发横向滚动条，且会覆盖用户手动调整的列宽
• 全表设置QHeaderView::Stretch模式：所有列等宽分配空间，无法实现向第3列倾斜分配剩余空间的要求
• 全表设置QHeaderView::ResizeToContents模式：所有列严格按内容宽度计算，第3列的长文本内容会直接撑出横向滚动条，不会自动截断适配

实现步骤 #

1. 给非第3列设置宽度适配规则，让这些列自动跟随自身内容调整宽度
2. 给第3列设置为交互列宽模式，既支持用户手动拖拽调整宽度，也允许代码动态计算分配剩余空间
3. 关闭表格横向滚动条策略，从源头避免横向滚动条出现
4. 拦截表格的尺寸变化事件：每次视口宽度变化时，计算除第3列外其他列的实际宽度总和，将剩余的所有可用宽度赋值给第3列，保证第3列始终占满剩余空间
5. 配置表格文本省略规则，超长内容自动截断为右侧省略号显示

可直接运行的实现代码 #

#include <QApplication>
#include <QTableWidget>
#include <QStringList>
#include <QHeaderView>
#include <QResizeEvent>
#include <QDialog>
#include <QVBoxLayout>

// 封装自定义表格逻辑，避免在业务代码里重复写事件拦截
class CustomTableWidget : public QTableWidget
{
public:
    CustomTableWidget(QWidget* parent = nullptr) : QTableWidget(parent)
    {
        // 固定关闭横向滚动条
        setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
        // 超长文本右侧截断显示省略号
        setTextElideMode(Qt::ElideRight);

        // 非目标列（索引0、1、3）设置为内容自适应模式
        horizontalHeader()->setSectionResizeMode(0, QHeaderView::ResizeToContents);
        horizontalHeader()->setSectionResizeMode(1, QHeaderView::ResizeToContents);
        horizontalHeader()->setSectionResizeMode(3, QHeaderView::ResizeToContents);
        // 目标列（索引2，第3列）设置为交互模式，支持手动拖拽+动态宽度赋值
        horizontalHeader()->setSectionResizeMode(2, QHeaderView::Interactive);
    }

protected:
    // 重写尺寸变化事件，动态计算列宽分配
    void resizeEvent(QResizeEvent* event) override
    {
        QTableWidget::resizeEvent(event);
        // 以视口实际可用宽度为计算基准，避免边框/预留空间导致的宽度计算偏差
        int totalAvailWidth = viewport()->width();
        // 累加非目标列的实际总宽度
        int otherColumnsTotalWidth = 0;
        for(int colIndex : {0, 1, 3})
        {
            otherColumnsTotalWidth += columnWidth(colIndex);
        }
        // 剩余宽度全部分配给第3列，设置最小宽度兜底避免被过度挤压
        int targetColWidth = qMax(50, totalAvailWidth - otherColumnsTotalWidth);
        setColumnWidth(2, targetColWidth);
    }
};

int main( int argc, char* argv[] )
{
    QApplication a(argc, argv);

    QDialog* mainDialog = new QDialog();
    mainDialog->setLayout(new QVBoxLayout());

    CustomTableWidget* table = new CustomTableWidget(1, 4);
    QStringList headers = {"1", "2", "3", "4"};
    table->setHorizontalHeaderLabels(headers);

    table->setItem(0, 0, new QTableWidgetItem("1"));
    table->setItem(0, 1, new QTableWidgetItem("22222"));
    table->setItem(0, 2, new QTableWidgetItem("33333333333333333333333333333"));
    table->setItem(0, 3, new QTableWidgetItem("4"));

    mainDialog->layout()->addWidget(table);
    mainDialog->resize(600, 300);
    mainDialog->show();
    return a.exec();
}

适配注意事项 #

• 计算可用宽度时必须取viewport()->width()，不要直接使用表格控件的总宽度，否则会因为边框、内边距预留导致计算偏差
• 给第3列设置最小宽度兜底，避免其他列内容过宽把目标列挤压到不可见
• 非目标列的ResizeToContents模式会自动跟随单元格内容变化更新宽度，不需要手动触发全表列宽刷新
• 如果需要支持用户手动调整非目标列的宽度，可以将非目标列的模式改为Interactive，初始化时手动根据内容计算一次列宽赋值即可，用户后续拖拽调整的宽度会被保留，第3列依然会自动补全剩余空间

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