1. 程式人生 > >Qt中文手冊 之 QTableWidget

Qt中文手冊 之 QTableWidget

簡介:

    QTableWidget是基於QTableView的一個預設的檢視模型;它用於顯示一個標準的表格。表格中每一個項通過QTableWidgetItem來實現。

標頭檔案:#include <QTableWidget>

繼承自:QTableView

成員函式:

1、QTableWidget::QTableWidget(QWidget * parent = 0)

    預設建構函式

2、QTableWidget::QTableWidget(int rows,int columns, QWidget * parent = 0)

    使用給定的行數rows和列數columns,構造表格

3、QTableWidget::~QTableWidget()

    解構函式

4、void QTableWidget::cellActivated(int row,int column) [signal] 訊號函式

    當位於第row行第column列的單元格被啟用時,觸發該訊號。如果該單元格可以編輯則不觸發。

5、void QTableWidget::cellChanged(int row,int column)[signal] 訊號函式

    當位於第row行第column列的單元格中的資料發生變化時,觸發該訊號

6、void QTableWidget::cellClicked

(int row,int column)[signal] 訊號函式

   當位於第row行第column列的單元格被點選時,觸發該訊號。

7、void QTableWidget::cellDoubleClicked(int row,int column)[signal] 訊號函式

    當位於第row行第column列的單元格被雙擊時,觸發該訊號。

8、void QTableWidget::cellEntered(int row,int column)[signal] 訊號函式

    當位於第row行第column列的單元格獲取滑鼠游標時,觸發該訊號。需要設定表格setMouseTracking

(true),預設是false

9、void QTableWidget::cellPressed(int row,int column)[signal] 訊號函式

    當位於第row行第column列的單元格被按下時,觸發該訊號。

10、QWidget * QTableWidget::cellWidget(int row,int column) const

     返回位於第row行第column列的單元格中視窗部件。

11、void QTableWidget::clear() [slot]槽函式

     刪除表格中所有的項(QTableWidgetItem),但是表格還在。

12、void QTableWidget::clearContents()  [slot]槽函式

    刪除表格中所有的項(QTableWidgetItem),不包括表頭中的,但是表格還在

13、void QTableWidget::closePersistentEditor(QTableWidgetItem * item)

    關閉指定item的可編輯狀態

14、int QTableWidget::column(constQTableWidgetItem * item) const

     返回指定item在第幾列。

15、void QTableWidget::currentCellChanged(int currentRow,int currentColumn, int previousRow,int previousColumn) [signal] 訊號函式

    當單元格的焦點變化時,發射該訊號。currentRow當前行currentColumn當前列;int previousRow之前的行 int previousColumn之前的列

 16、int QTableWidget::currentColumn() const

     返回當前單元格在第幾列

17、QTableWidgetItem * QTableWidget::currentItem() const

      返回當前的單元格中的item

18、void QTableWidget::currentItemChanged(QTableWidgetItem * current,QTableWidgetItem * previous)[signal] 訊號函式

     當單元格的焦點變化時,發射該訊號。current當前的項item;previous之前的項item

 19、int QTableWidget::currentRow() const

      返回當前單元格在第幾行。

20、void QTableWidget::dropEvent(QDropEvent * event[virtual protected]

      當向該表格中拖放時,觸發該事件

 21、bool QTableWidget::dropMimeData(int row,int column, const QMimeData * data,Qt::DropAction action)[virtual protected]

     如果指定的單元格能處理拖放中的資料,則返回真,否則返回假

22、void QTableWidget::editItem(QTableWidgetItem * item)

     如果item能編輯,開始編輯該項。

 23、QList<QTableWidgetItem *> QTableWidget::findItems(constQString & text, Qt::MatchFlags flags) const

   返回匹配text的項的列表。

24、QTableWidgetItem * QTableWidget::horizontalHeaderItem(int column) const

     返回第column列的表頭項,如果沒有則返回0。

25、QModelIndex QTableWidget::indexFromItem(QTableWidgetItem * item) const     [protected]

  返回指定item的QModelIndex(QAbstractItemModel的引索)

26、void QTableWidget::insertColumn(int column)

  在第column列插入一個空列。

27、void QTableWidget::insertRow(int row)

 在第row行插入一個空行。

28、QTableWidgetItem * QTableWidget::item(int row,int column) const

 返回在第row行第column列的項,如果不存在返回0。

29、void QTableWidget::itemActivated(QTableWidgetItem * item)[signal] 訊號函式

    項被啟用,發射訊號。

30、QTableWidgetItem * QTableWidget::itemAt(constQPoint & point) const

    返回指定座標point處的項,如果該座標處沒有項則返回0。該座標相對於表格視窗。

 31、QTableWidgetItem * QTableWidget::itemAt(int ax,int ay) const

   同上。QPoint(x,y)

32、void QTableWidget::itemChanged(QTableWidgetItem * item)[signal] 訊號函式

   當item的數值發生改變時,觸發該訊號

33、void QTableWidget::itemClicked(QTableWidgetItem * item)[signal] 訊號函式

    當item被點選時,觸發該訊號

34、void QTableWidget::itemDoubleClicked(QTableWidgetItem * item)[signal] 訊號函式

   當item被雙擊時,觸發該訊號

35、void QTableWidget::itemEntered(QTableWidgetItem * item)

   當編輯item時(獲取滑鼠)時,觸發該訊號。需要設定表格setMouseTracking(true),預設是false

36、QTableWidgetItem * QTableWidget::itemFromIndex(constQModelIndex & index) const [protected]

   返回給定index的項,QModelIndex指向資料?

37、void QTableWidget::itemPressed(QTableWidgetItem * item)[signal] 訊號函式

   當item被按下時,觸發該訊號

38、const QTableWidgetItem * QTableWidget::itemPrototype() const

      返回項的原型,通常用於克隆項

39、void QTableWidget::itemSelectionChanged()[signal] 訊號函式

   當被選中的item發生改變時,觸發該訊號。

40、QList<QTableWidgetItem *> QTableWidget::items(constQMimeData * data) const  [protected]

    返回包含MIME data資料所有的項。

41、QMimeData * QTableWidget::mimeData(constQList<QTableWidgetItem *> items) const[protected]

    返回項列表中MIME資料的容器

42、QStringList QTableWidget::mimeTypes() const[protected

   返回表格中所有項的一個MIME資料

43、void QTableWidget::openPersistentEditor(QTableWidgetItem * item)

   開始編輯item

44、void QTableWidget::removeCellWidget(int row,int column)

   刪除第row行第column列的視窗部件

45、void QTableWidget::removeColumn(int column)[slot]

   刪除第column列

46、void QTableWidget::removeRow(int row)[slot]

   刪除第row行

47、int QTableWidget::row(constQTableWidgetItem * item) const[slot]

   返回指定item所在的行數

48、void QTableWidget::scrollToItem(constQTableWidgetItem * item, QAbstractItemView::ScrollHint hint = EnsureVisible)[slot]

   指定的item比較突顯出來,方便辨認。

49、QList<QTableWidgetItem *> QTableWidget::selectedItems()

   返回選中的項的列表

50、QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

   返回選擇範圍

51、void QTableWidget::setCellWidget(int row,int column, QWidget * widget)

   將widget視窗部件放到第row行第column列。

52、void QTableWidget::setCurrentCell(int row,int column)

     將位於第row行第column列的項設定為當前項(獲取焦點)

53、void QTableWidget::setCurrentItem(QTableWidgetItem * item)

    設定指定的item為當前項

54、void QTableWidget::setHorizontalHeaderItem(int column,QTableWidgetItem * item)

    將第column列的水平表頭項設為item

55、void QTableWidget::setHorizontalHeaderLabels(constQStringList & labels)

   使用一組標籤設定水平表頭

56、void QTableWidget::setItem(int row,int column, QTableWidgetItem * item)

    設定第row行第column列的項;注意如果使能排序,行位置會變化

57、void QTableWidget::setItemPrototype(constQTableWidgetItem * item)

   通過item設定表的標準項模型。

58、void QTableWidget::setRangeSelected(constQTableWidgetSelectionRange & range, bool select)

   選擇或取消範圍

59、void QTableWidget::setVerticalHeaderItem(int row,QTableWidgetItem * item)

   設定第row行的垂直表頭的項

60、void QTableWidget::setVerticalHeaderLabels(constQStringList & labels)

   通過一組標籤設定垂直表頭

 61、void QTableWidget::sortItems(int column,Qt::SortOrder order = Qt::AscendingOrder)

   根據規則order設定第column列的所有行

62、Qt::DropActions QTableWidget::supportedDropActions() const

   返回該表支援的所有拖放操作

63、QTableWidgetItem * QTableWidget::takeHorizontalHeaderItem(int column)

   將項從第column列的水平表頭中去除,但不刪除它(不delete item)。

64、QTableWidgetItem * QTableWidget::takeItem(int row,int column)

      將項從第row行第column列去除,但不刪除它

65、QTableWidgetItem * QTableWidget::verticalHeaderItem(int row) const

     返回垂直表頭中第row行的項

66、int QTableWidget::visualColumn(int logicalColumn) const

    返回給定邏輯列的可視列。

67、QRect QTableWidget::visualItemRect(constQTableWidgetItem * item) const

      返回item所佔的單元格的位置和大小

68、int QTableWidget::visualRow(int logicalRow) const

     返回給定邏輯行的可視行。