QTableWidget 十分常用，本文結合了網路資源以及作者自己的實踐，總結和整理和最常用的功能及寫法。

QTableWidget是QT程式中常用的顯示資料表格的空間，很類似於VC、C#中的DataGrid。說到QTableWidget，就必須講一下它跟QTabelView的區別了。QTableWidget是QTableView的子類，主要的區別是QTableView可以使用自定義的資料模型來顯示內容(也就是先要通過setModel來繫結資料來源)，而QTableWidget則只能使用標準的資料模型，並且其單元格資料是QTableWidgetItem的物件來實現的(也就是不需要資料來源，將逐個單元格內的資訊填好即可)。這主要體現在QTableView類中有setModel成員函式，而到了QTableWidget類中，該成員函式變成了私有。使用QTableWidget就離不開QTableWidgetItem。QTableWidgetItem用來表示表格中的一個單元格，正個表格都需要用逐個單元格構建起來。

1. #include <QtGui/QApplication>
2. #include <QTableWidget>
3. #include <QTableWidgetItem>
4. int main(int argc, char *argv[])  
5. {  
6.     QApplication a(argc, argv);  
7.     QTableWidget *tableWidget = new QTableWidget(10,5); // 構造了一個QTableWidget的物件，並且設定為10行，5列
8.     //    也可用下面的方法構造QTableWidget物件
9.     //    QTableWidget *tableWidget = new QTableWidget;
10.     //    tableWidget->setRowCount(10);     //設定行數為10
11.     //    tableWidget->setColumnCount(5);   //設定列數為5
12.     tableWidget->setWindowTitle("QTableWidget & Item");  
13.     tableWidget->resize(350, 200);  //設定表格
14.     QStringList header;  
15.     header<<"Month"<<"Description";  
16.     tableWidget->setHorizontalHeaderLabels(header);  
17.     tableWidget->setItem(0,0,new QTableWidgetItem("Jan"));  
18.     tableWidget->setItem(1,0,new QTableWidgetItem("Feb"));  
19.     tableWidget->setItem(2,0,new QTableWidgetItem("Mar"));  
20.     tableWidget->setItem(0,1,new QTableWidgetItem(QIcon("images/IED.png"), "Jan's month"));  
21.     tableWidget->setItem(1,1,new QTableWidgetItem(QIcon("images/IED.png"), "Feb's month"));  
22.     tableWidget->setItem(2,1,new QTableWidgetItem(QIcon("images/IED.png"), "Mar's month"));  
23.     tableWidget->show();  
24.     return a.exec();  
25. }  

一. 對QTableWidget本身的效果實現

1. 將表格變為禁止編輯

在預設情況下，表格裡的字元是可以更改的，比如雙擊一個單元格，就可以修改原來的內容，如果想禁止使用者的這種操作，讓這個表格對使用者只讀，可以這樣：

 tableWidget->setEditTriggers(QAbstractItemView::NoEditTriggers);

QAbstractItemView.NoEditTriggers是QAbstractItemView.EditTrigger列舉中的一個，都是觸發修改單元格內容的條件：

2. 設定表格為整行選擇

tableWidget->setSelectionBehavior(QAbstractItemView::SelectRows);  //整行選中的方式

QAbstractItemView.SelectionBehavior列舉還有如下型別

3.單個選中和多個選中的設定：

tableWidget->setSelectionMode(QAbstractItemView::ExtendedSelection);  //設定為可以選中多個目標

該函式的引數還可以是：

QAbstractItemView.NoSelection      不能選擇

QAbstractItemView.SingleSelection  選中單個目標

QAbstractItemView.MultiSelection    選中多個目標

QAbstractItemView.ExtendedSelection   QAbstractItemView.ContiguousSelection 的區別不明顯，主要功能是正常情況下是單選，但按下Ctrl或Shift鍵後，可以多選

4. 表格表頭的顯示與隱藏

對於水平或垂直方法的表頭，可以用以下方式進行 隱藏/顯示 的設定：

1. tableWidget->verticalHeader()->setVisible(false);   //隱藏列表頭
2. tableWidget->horizontalHeader()->setVisible(false); //隱藏行表頭

注意：需要 #include<QHeaderView>

5. 對錶頭文字的字型、顏色進行設定

1. QTableWidgetItem *columnHeaderItem0 = tableWidget->horizontalHeaderItem(0); //獲得水平方向表頭的Item物件
2. columnHeaderItem0->setFont(QFont("Helvetica")); //設定字型
3. columnHeaderItem0->setBackgroundColor(QColor(0,60,10)); //設定單元格背景顏色
4. columnHeaderItem0->setTextColor(QColor(200,111,30)); //設定文字顏色

注意：需要 #include<QHeaderView>

6. 在單元格里加入控制元件：

QTableWidget不僅允許把文字加到單元格，還允許把控制元件也放到單元格中。比如，把一個下拉框加入單元格，可以這麼做：

1. QComboBox *comBox = new QComboBox();  
2. comBox->addItem("Y");  
3. comBox->addItem("N");  
4. tableWidget->setCellWidget(0,2,comBox);  

讀取QComboBox 資訊：

1. QWidget * widget=ui->tableWidget->cellWidget(i,0);//獲得widget     
2. QComboBox *combox=(QComboBox*)widget;//強制轉化為QComboBox       
3. QString string=combox->currentText();    
4. qDebug()<<string;  

二. 對單元格的進行設定

1. 單元格設定字型顏色和背景顏色 及字型字元

1. QTableWidgetItem *item = new QTableWidgetItem("Apple");  
2. item->setBackgroundColor(QColor(0,60,10));  
3. item->setTextColor(QColor(200,111,100));  
4. item->setFont(QFont("Helvetica"));  
5. tableWidget->setItem(0,3,item);  

另：如果需要對所有的單元格都使用這種字型，則可以使用  tableWidget->setFont(QFont("Helvetica"));

2. 設定單元格內文字的對齊方式

這個比較簡單，使用newItem.setTextAlignment()函式即可，該函式的引數為單元格內的對齊方式，和字元輸入順序是自左相右還是自右向左。

水平對齊方式有：

垂直對齊方式：

如果兩種都要設定，只要用 Qt.AlignHCenter |  Qt.AlignVCenter 的方式即可

3. 合併單元格效果的實現：

tableWidget->setSpan(0, 0, 3, 1)  # 其引數為： 要改變單元格的   1行數  2列數     要合併的  3行數  4列數

4. 設定單元格的大小

首先，可以指定某個行或者列的大小

1. tableWidget->setColumnWidth(3,200);  
2. tableWidget->setRowHeight(3,60);  

還可以將行和列的大小設為與內容相匹配

1. tableWidget->resizeColumnsToContents();  
2. tableWidget->resizeRowsToContents();  

5. 獲得單擊單元格的內容

通過實現 itemClicked (QTableWidgetItem *) 訊號的槽函式，就可以獲得滑鼠單擊到的單元格指標，進而獲得其中的文字資訊

connect(tableWidget,SIGNAL(itemDoubleClicked(QTreeWidgetItem*,int)),this,SLOT(getItem(QTreeWidgetItem*,int)));

//將itemClicked訊號與函式getItem繫結

6.QTableWidget要調整表格行寬主要涉及以下一個函式

resizeColumnsToContents();                      根據內容調整列寬          resizeColumnToContents(int col);               根據內容自動調整給定列寬horizontalHeader()->setResizeMode           把給定列設定為給定模式主要模式有Stretch和Fixed

7.

int row = rowCount(); removeRow(row);//清除已有的行列 setShowGrid(true);//顯示錶格線 verticalHeader()->setVisible(false);//隱藏左邊垂直 QHeaderView *headerView = horizontalHeader(); headerView->setMovable(false);//去除表頭的移動 headerView->resizeSection(0,284);//設定第一列寬 headerView->resizeSection(1,127);//設定第二列寬 headerView->setResizeMode(QHeaderView::Fixed);//列表不能移動 headerView->setClickable(false);//不響應滑鼠單擊 setEditTriggers(QTableWidget::NoEditTriggers);//不能編輯 setSelectionBehavior(QTableWidget::SelectRows);//一次選中一行 setSelectionMode(QAbstractItemView::SingleSelection);//只能單選 /*QScrollBar *scrollBar = horizontalScrollBar(); scrollBar->hide();*/ setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);//去掉水平滾動條 setVerticalScrollMode(QAbstractItemView::ScrollPerItem);//垂直滾動條按項移動 setAutoScroll(false);//去掉自動滾動 

初始化示例:

1. m_tableWid->setColumnCount(6);  
2. m_tableWid->verticalHeader()->setVisible(false);  
3. //m_tableWid->setEditTriggers(QAbstractItemView::NoEditTriggers);  
4. //設定列表題    
5. QStringList rowLabels;    
6. rowLabels << "ID" << QString::fromLocal8Bit("告警級別") << QString::fromLocal8Bit("經度") <<   
7.     QString::fromLocal8Bit("緯度")<<  
8.     QString::fromLocal8Bit("哨兵")<<  
9.     QString::fromLocal8Bit("備註") ;    
10. m_tableWid->setHorizontalHeaderLabels(rowLabels);    
11. m_tableWid->horizontalHeader()->setResizeMode(QHeaderView::Stretch) ;  

新增：

1. m_tableWid->setRowCount(++m_Rows);  

1. m_tableWid->setItem(Row_,TABLE_COLUMN_ID, new QTableWidgetItem(QString::fromUtf8(warning_msg_->ID)));    
2. m_tableWid->setItem(Row_,TABLE_COLUMN_WARNING_LEVEL, new QTableWidgetItem(QString::fromUtf8(warning_msg_->WarningLevel)));    
3. m_tableWid->setItem(Row_,TABLE_COLUMN_LON, new QTableWidgetItem(QString::fromUtf8(warning_msg_->Lon)));   
4. m_tableWid->setItem(Row_,TABLE_COLUMN_LAT,new QTableWidgetItem(QString::fromUtf8(warning_msg_->Lat)));    
5. m_tableWid->setItem(Row_,TABLE_COLUMN_TIPS,new QTableWidgetItem(QString::fromUtf8(warning_msg_->Tips)));