Qt中文手册 之 QTableWidget

简介：

    QTableWidget是基于QTableView的一个默认的视图模型；它用于显示一个标准的表格。表格中每一个项通过QTableWidgetItem来实现。

头文件：#include

继承自：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

     返回给定逻辑行的可视行。