[TOC] ## 概述 常用函數 ``` QTableWidget(QWidget * parent = 0) QTableWidget(int rows, int columns, QWidget * parent = 0) // 行列 void setRowCount(int rows) //設置行數 void setColumnCount(int columns) //設置列數 int rowCount() const //獲取行數 int columnCount() const //獲取列數 //設置條目 void QTableWidget::?setItem(int row, int column, QTableWidgetItem * item) //移除條目 QTableWidgetItem * QTableWidget::?takeItem(int row, int column) // 條目訪問函數 QTableWidgetItem * QTableWidget::?item(int row, int column) const QTableWidgetItem * QTableWidget::?itemAt(const QPoint & point) const QTableWidgetItem * QTableWidget::?itemAt(int ax, int ay) const //當前選中條目的操作 QTableWidgetItem * QTableWidget::?currentItem() const int QTableWidget::?currentRow() const //當前選中行號 int QTableWidget::?currentColumn() const //當前選中列號 // 點亮單元格 void QTableWidget::?setCurrentCell(int row, int column) void QTableWidget::?setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command) // 條目查找 QList<QTableWidgetItem *> QTableWidget::?findItems(const QString & text, Qt::MatchFlags flags) const // 排序 void setSortingEnabled(bool enable) //設置是否自動排序 bool isSortingEnabled() const //判斷是否開啟了自動排序 void QTableView::?sortByColumn(int column, Qt::SortOrder order) // 按哪一行排序 // 單元格控件 void QTableWidget::?setCellWidget(int row, int column, QWidget * widget) // 設置獨立的單元格控件 QWidget * QTableWidget::?cellWidget(int row, int column) const // 獲取單元格控件 void QTableWidget::?removeCellWidget(int row, int column) //移除單元格空間,刪除單元格控件后，單元格就會顯示原來的條目內容 //編輯 void QTableWidget::?openPersistentEditor(QTableWidgetItem * item) //開啟持續編輯器 void QTableWidget::?closePersistentEditor(QTableWidgetItem * item) //關閉持續編輯器 void QTableWidget::?editItem(QTableWidgetItem * item) // 編輯觸發器 void setEditTriggers(EditTriggers triggers) //設置編輯觸發器 EditTriggers editTriggers() const //獲取編輯觸發器 // 信號 void currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn) //單元格無論是否為空都起作用，當前選中單元格的變化信號，參數指出了新當前單元格行列號和舊單元格的行列號 void currentItemChanged(QTableWidgetItem * current, QTableWidgetItem * previous) //當前選中條目變化信號，新、舊當前選中單元格至少有一個非空才會觸發這個信號 void cellActivated(int row, int column) //單元格被激活 void cellChanged(int row, int column) //單元格內部發生變化，如從NULL變成有條目，或者條目內部數據發生變化 void cellClicked(int row, int column) //單元格被點擊 void cellDoubleClicked(int row, int column) //單元格被雙擊 // 選擇區域 QList<QTableWidgetItem *> QTableWidget::?selectedItems() const ``` ### 表頭設置 QTableWidgetItem 既可以作為表格控件普通單元格的條目，也可以用來設置表頭分段 常用函數 ``` void QTableWidget::?setHorizontalHeaderLabels(const QStringList & labels) //設置水平表頭文本 void QTableWidget::?setVerticalHeaderLabels(const QStringList & labels) //設置垂直表頭文本 void QTableWidget::?setHorizontalHeaderItem(int column, QTableWidgetItem * item) //設置指定列的水平表頭分段條目 QTableWidgetItem * QTableWidget::?horizontalHeaderItem(int column) const //獲取指定列的水平表頭分段條目 void QTableWidget::?setVerticalHeaderItem(int row, QTableWidgetItem * item) //設置指定行的垂直表頭分段條目 QTableWidgetItem * QTableWidget::?verticalHeaderItem(int row) const //獲取指定行的垂直表頭分段條目 QHeaderView * QTableView::?horizontalHeader() const //獲取整個的水平表頭 void QTableView::?setHorizontalHeader(QHeaderView * header) //設置整個的水平表頭 QHeaderView * QTableView::?verticalHeader() const //獲取整個的垂直表頭 void QTableView::?setVerticalHeader(QHeaderView * header) //設置整個的垂直表頭 ``` ### 設計師界面 1. 設置 "horizontalHeaderShowSortIndicator" 時,根據一個列自動排序時，該列水平表頭分段顯示三角形排序指示符  2. 設置 "horizontalHeaderStretchLastSection ",表格最后一列會自動占據剩下的空間 ## 實例 ``` ui->tableWidget->setSelectionBehavior(QAbstractItemView::SelectRows); //為方便刪除按鈕操作，把選中模式設為單選，即每次只選中一行，而不能選中多行 ui->tableWidget->setSelectionMode(QAbstractItemView::SingleSelection); //開啟自動排序 ui->tableWidget->setSortingEnabled(true); ui->tableWidget->sortByColumn(0, Qt::AscendingOrder); //設置末尾一列自動拉伸 ui->tableWidget->horizontalHeader()->setStretchLastSection(true); //設置默認行高，把圖標設置更大一些 ui->tableWidget->verticalHeader()->setDefaultSectionSize(36); ui->tableWidget->setIconSize( QSize(32,32) ); //構造表格條目 for(int i=0; i<3; i++) { for(int j=0; j<3; j++) { QTableWidgetItem *itemTA = new QTableWidgetItem(); itemTA->setText( tr("tableItem %1, %2").arg(i).arg(j) ); ui->tableWidget->setItem( i, j, itemTA ); } } // 設置內部拖拽 ui->tableWidget->setDragDropMode(QAbstractItemView::InternalMove); // 外部拖拽 ui->tableWidget->setSelectionMode(QAbstractItemView::SingleSelection); //單選模式 ui->tableWidget->setDragEnabled(true); //可以拖出源條目 ui->tableWidget->viewport()->setAcceptDrops(true); //視口可以接收拖入 ui->tableWidget->setDropIndicatorShown(true); //啟用拖拽的顯示效果 ui->tableWidget->setDragDropMode(QAbstractItemView::DragDrop); //使用能拖能拽的模式 ```