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實現自適應列寬，處理滾動條和文本對齊方式，以達到更好的展示效果。