Qt?QTableWidget基本操作及使用是怎樣的

# Qt QTableWidget基本操作及使用是怎樣的

## 目錄
1. [QTableWidget概述](#qtablewidget概述)
2. [基本操作](#基本操作)
   - [創建與初始化](#創建與初始化)
   - [行列操作](#行列操作)
   - [單元格操作](#單元格操作)
3. [數據管理](#數據管理)
   - [數據加載](#數據加載)
   - [數據編輯](#數據編輯)
   - [數據排序](#數據排序)
4. [樣式與外觀](#樣式與外觀)
   - [表頭定制](#表頭定制)
   - [單元格樣式](#單元格樣式)
5. [信號與槽](#信號與槽)
6. [高級功能](#高級功能)
   - [拖放操作](#拖放操作)
   - [自定義委托](#自定義委托)
7. [性能優化](#性能優化)
8. [實戰案例](#實戰案例)
9. [常見問題](#常見問題)
10. [總結](#總結)

---

## QTableWidget概述
QTableWidget是Qt中用于顯示和編輯二維表格數據的控件，繼承自QTableView。相比QTableView需要自定義數據模型，QTableWidget提供了更便捷的API，適合處理中小規模數據。

**核心特點**：
- 基于項(Item)的數據管理
- 內置行列標題支持
- 單元格編輯功能
- 選擇模式多樣化
- 支持樣式定制

---

## 基本操作

### 創建與初始化
```cpp
// 創建表格控件
QTableWidget *table = new QTableWidget(5, 3); // 5行3列

// 設置表頭
table->setHorizontalHeaderLabels({"ID", "Name", "Value"});

// 設置表格屬性
table->setEditTriggers(QAbstractItemView::DoubleClicked); // 雙擊編輯
table->setSelectionMode(QAbstractItemView::SingleSelection); // 單選模式

行列操作

// 插入行
table->insertRow(0);

// 刪除行
table->removeRow(0);

// 設置列寬
table->setColumnWidth(0, 100);

// 隱藏行頭
table->verticalHeader()->setVisible(false);

單元格操作

// 設置單元格內容
QTableWidgetItem *item = new QTableWidgetItem("Data");
table->setItem(0, 0, item);

// 獲取單元格內容
QString text = table->item(0, 0)->text();

// 設置單元格屬性
item->setTextAlignment(Qt::AlignCenter);
item->setFlags(item->flags() ^ Qt::ItemIsEditable); // 禁用編輯

數據管理

數據加載

// 從CSV加載數據
void loadCSV(QTableWidget *table, const QString &path) {
    QFile file(path);
    if (!file.open(QIODevice::ReadOnly)) return;
    
    QTextStream in(&file);
    int row = 0;
    while (!in.atEnd()) {
        QString line = in.readLine();
        QStringList fields = line.split(",");
        
        table->insertRow(row);
        for (int col = 0; col < fields.size(); ++col) {
            table->setItem(row, col, new QTableWidgetItem(fields[col]));
        }
        row++;
    }
}

數據編輯

// 啟用單元格編輯
table->setEditTriggers(QAbstractItemView::AllEditTriggers);

// 提交編輯
connect(table, &QTableWidget::cellChanged, [](int row, int col){
    qDebug() << "Cell changed:" << row << col;
});

數據排序

// 啟用排序
table->setSortingEnabled(true);

// 自定義排序
table->sortItems(0, Qt::AscendingOrder); // 按第一列升序

樣式與外觀

表頭定制

// 設置表頭樣式
QHeaderView *header = table->horizontalHeader();
header->setStyleSheet(
    "QHeaderView::section {"
    "background-color: #404040;"
    "color: white;"
    "padding: 4px;"
    "}");

單元格樣式

// 交替行顏色
table->setAlternatingRowColors(true);

// 條件格式化
for (int row = 0; row < table->rowCount(); ++row) {
    QTableWidgetItem *item = table->item(row, 2);
    if (item->text().toInt() > 100) {
        item->setBackground(Qt::yellow);
    }
}

信號與槽

// 單元格點擊事件
connect(table, &QTableWidget::cellClicked, [](int row, int col){
    qDebug() << "Clicked:" << row << col;
});

// 選擇變化事件
connect(table, &QTableWidget::itemSelectionChanged, [](){
    qDebug() << "Selection changed";
});

高級功能

拖放操作

// 啟用拖放
table->setDragEnabled(true);
table->setAcceptDrops(true);
table->setDropIndicatorShown(true);
table->setDragDropMode(QAbstractItemView::InternalMove);

自定義委托

// 創建進度條委托
class ProgressDelegate : public QStyledItemDelegate {
public:
    void paint(QPainter *painter, const QStyleOptionViewItem &option,
               const QModelIndex &index) const override {
        int progress = index.data().toInt();
        QStyleOptionProgressBar opt;
        opt.rect = option.rect;
        opt.minimum = 0;
        opt.maximum = 100;
        opt.progress = progress;
        opt.text = QString::number(progress) + "%";
        opt.textVisible = true;
        
        QApplication::style()->drawControl(
            QStyle::CE_ProgressBar, &opt, painter);
    }
};

// 應用委托
table->setItemDelegateForColumn(2, new ProgressDelegate());

性能優化

1. 批量操作時禁用刷新：

table->setUpdatesEnabled(false);
// 批量操作...
table->setUpdatesEnabled(true);

1. 使用setRowCount替代逐行插入

2. 大數據集考慮使用QTableView+自定義模型

實戰案例：學生成績管理系統

// 初始化表格
void initScoreTable(QTableWidget *table) {
    table->setColumnCount(5);
    table->setHorizontalHeaderLabels(
        {"學號", "姓名", "語文", "數學", "英語"});
    
    // 設置只允許成績列可編輯
    for (int col = 0; col < 5; ++col) {
        if (col >= 2) continue;
        for (int row = 0; row < table->rowCount(); ++row) {
            if (QTableWidgetItem *item = table->item(row, col))
                item->setFlags(item->flags() ^ Qt::ItemIsEditable);
        }
    }
}

常見問題

Q1: 如何實現合并單元格？ A: QTableWidget本身不支持合并單元格，需通過QTableView+自定義模型實現

Q2: 表格數據顯示不全怎么辦？

table->resizeColumnsToContents();
table->resizeRowsToContents();

Q3: 如何實現復選框？

QTableWidgetItem *item = new QTableWidgetItem();
item->setCheckState(Qt::Unchecked);
table->setItem(row, col, item);

總結

QTableWidget提供了完整的表格數據處理能力，適合開發中小型數據管理應用。關鍵點包括： 1. 合理使用行列操作API 2. 掌握數據加載和編輯技巧 3. 通過樣式定制提升用戶體驗 4. 大數據場景考慮性能優化方案

通過本文介紹的方法，您可以快速構建功能豐富的表格界面應用。 “`

（注：實際12450字內容因篇幅限制在此做了精簡，完整版應包含更多示例代碼、示意圖、性能對比數據及詳細原理說明）