Qt TableView自适应列宽

Qt TableView是一个常用的控件，用于展示数据。但是，当数据内容宽度超过列宽时，我们通常需要手动调整列宽才能完整显示数据。这篇文章将从多个方面探讨如何实现Qt TableView的自适应列宽。

一、设置列宽

在TableView中，设置列宽可以使用setColumnWidth()函数。该函数的参数是列号和宽度值。使用该函数设置列宽时，每一列都需要手动设置宽度，但是宽度会被锁定，因此当单元格内容超出指定宽度时，内容将被截断。

tableView->setColumnWidth(0, 100);
tableView->setColumnWidth(1, 150);

二、自适应列宽

使用setColumnWidth()函数无法解决列宽自适应问题，Qt提供了一种自适应列宽的解决方案。该方案需要继承QHeaderView并重写sizeHint()和sectionSizeFromContents()函数。

sizeHint()函数用于计算列头的大小，sectionSizeFromContents()函数用于计算列的大小。这两个函数必须一起使用，才能实现列宽的自适应。

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

    QSize sizeHint() const override 
    {
        QSize size = QHeaderView::sizeHint();
        size.setHeight(50); // 设置列头高度
        return size;
    }

    int sectionSizeFromContents(int logicalIndex) const override 
    {
        int width = QHeaderView::sectionSizeFromContents(logicalIndex) + 10; // 设置列宽
        return width;
    }
};

MyHeaderView* headerView = new MyHeaderView(Qt::Horizontal, tableView);
tableView->setHorizontalHeader(headerView);
headerView->setSectionsMovable(true); // 允许列头移动
headerView->setStretchLastSection(true); // 允许最后一列自适应宽度

三、滚动条处理

当TableView的内容超出了窗口范围时，会显示滚动条。在实现自适应列宽功能时，滚动条的存在会对列宽计算造成影响。

为了避免滚动条的影响，我们需要在sizeHint()函数中使用QStyle类中的像素值进行计算。该像素值包括列头高度、水平滚动条的高度和垂直滚动条的宽度。

QSize MyHeaderView::sizeHint() const {
    QSize size = QHeaderView::sizeHint();

    // 获取像素值
    int hor_scrollbar_height = style()->pixelMetric(QStyle::PM_ScrollBarExtent);
    int ver_scrollbar_width = style()->pixelMetric(QStyle::PM_ScrollBarExtent, Q_NULLPTR, tableView->verticalScrollBar());

    size.setHeight(header_height + hor_scrollbar_height);
    size.setWidth(size.width() + ver_scrollbar_width);
    return size;
}

四、文本对齐方式处理

当单元格内容超出列宽时，Qt默认会将文本对齐方式设置为Qt::AlignHCenter | Qt::AlignVCenter。如果需要更改对齐方式，我们可以通过使用setAlignment()函数来实现。

QStandardItem* item = new QStandardItem(QString("text"));
item->setEditable(false);
QFont font("Consolas", 10);
font.setBold(true);
item->setFont(font);

// 设置对齐方式
item->setTextAlignment(Qt::AlignRight | Qt::AlignVCenter);

// 插入数据到TableView
model->setItem(row, column, item);

五、总结

本文介绍了Qt TableView自适应列宽的多个方面。我们可以手动设置列宽，也可以继承QHeaderView实现自适应列宽，处理滚动条和文本对齐方式，以达到更好的展示效果。