[QtGui module]

在QTableView中的类提供了默认的模型/视图实现表视图中。More…

继承QAbstractItemView。

通过继承QTableWidget。

Methods

  • __init__ (self, QWidget parent = None)
  • clearSpans (self)
  • int columnAt (self, int x)
  • columnCountChanged (self, int oldCount, int newCount)
  • columnMoved (self, int column, int oldIndex, int newIndex)
  • columnResized (self, int column, int oldWidth, int newWidth)
  • int columnSpan (self, int row, int column)
  • int columnViewportPosition (self, int column)
  • int columnWidth (self, int column)
  • currentChanged (self, QModelIndex current, QModelIndex previous)
  • Qt.PenStyle gridStyle (self)
  • hideColumn (self, int column)
  • hideRow (self, int row)
  • QHeaderView horizontalHeader (self)
  • int horizontalOffset (self)
  • horizontalScrollbarAction (self, int action)
  • QModelIndex indexAt (self, QPoint p)
  • bool isColumnHidden (self, int column)
  • bool isCornerButtonEnabled (self)
  • bool isIndexHidden (self, QModelIndex index)
  • bool isRowHidden (self, int row)
  • bool isSortingEnabled (self)
  • QModelIndex moveCursor (self, QAbstractItemView.CursorAction cursorAction, Qt.KeyboardModifiers modifiers)
  • paintEvent (self, QPaintEvent e)
  • resizeColumnsToContents (self)
  • resizeColumnToContents (self, int column)
  • resizeRowsToContents (self)
  • resizeRowToContents (self, int row)
  • int rowAt (self, int y)
  • rowCountChanged (self, int oldCount, int newCount)
  • int rowHeight (self, int row)
  • rowMoved (self, int row, int oldIndex, int newIndex)
  • rowResized (self, int row, int oldHeight, int newHeight)
  • int rowSpan (self, int row, int column)
  • int rowViewportPosition (self, int row)
  • scrollContentsBy (self, int dx, int dy)
  • scrollTo (self, QModelIndex index, QAbstractItemView.ScrollHint hint = QAbstractItemView.EnsureVisible)
  • selectColumn (self, int column)
  • list-of-QModelIndex selectedIndexes (self)
  • selectionChanged (self, QItemSelection selected, QItemSelection deselected)
  • selectRow (self, int row)
  • setColumnHidden (self, int column, bool hide)
  • setColumnWidth (self, int column, int width)
  • setCornerButtonEnabled (self, bool enable)
  • setGridStyle (self, Qt.PenStyle style)
  • setHorizontalHeader (self, QHeaderView header)
  • setModel (self, QAbstractItemModel model)
  • setRootIndex (self, QModelIndex index)
  • setRowHeight (self, int row, int height)
  • setRowHidden (self, int row, bool hide)
  • setSelection (self, QRect rect, QItemSelectionModel.SelectionFlags command)
  • setSelectionModel (self, QItemSelectionModel selectionModel)
  • setShowGrid (self, bool show)
  • setSortingEnabled (self, bool enable)
  • setSpan (self, int row, int column, int rowSpan, int columnSpan)
  • setVerticalHeader (self, QHeaderView header)
  • setWordWrap (self, bool on)
  • showColumn (self, int column)
  • bool showGrid (self)
  • showRow (self, int row)
  • int sizeHintForColumn (self, int column)
  • int sizeHintForRow (self, int row)
  • sortByColumn (self, int column)
  • sortByColumn (self, int column, Qt.SortOrder order)
  • timerEvent (self, QTimerEvent event)
  • updateGeometries (self)
  • QHeaderView verticalHeader (self)
  • int verticalOffset (self)
  • verticalScrollbarAction (self, int action)
  • QStyleOptionViewItem viewOptions (self)
  • QRect visualRect (self, QModelIndex index)
  • QRegion visualRegionForSelection (self, QItemSelection selection)
  • bool wordWrap (self)

Detailed Description

在QTableView中的类提供了默认的模型/视图实现表视图中。

一个QTableView中实现了显示从模型项目的表视图。这个类是用来提供以前由提供的标准表QTable类，但使用Qt的模型/视图结构中提供的更灵活的方法。

在QTableView中类是一个Model/View Classes并且是Qt的一部分model/view framework。

QTableView中实现由定义的接口QAbstractItemView类以允许其显示由从派生模型提供数据QAbstractItemModel类。

Navigation

您可以通过点击一个单元格，用鼠标，或者使用箭头键导航的单元格在表中。因为QTableView中启用tabKeyNavigation默认情况下，你也可以按下Tab键和BACKTAB移动从细胞到细胞。

Visual Appearance

该表具有可利用以下方式获得一个垂直头中的verticalHeader（）函数，和一个水平标头，可通过horizontalHeader（）函数。表中的每一行的高度可以通过使用被发现rowHeight（）;类似地，列的宽度可以通过使用发现columnWidth（ ） 。由于这两个都是普通的小工具，你可以使用隐藏其中任何一个的hide（）函数。

行和列可以隐藏和显示hideRow（ ）hideColumn（ ）showRow（）和showColumn（ ） 。它们可以与被选择selectRow（）和selectColumn（ ） 。该表将显示一个网格取决于showGrid属性。

在表视图中显示的项目，像那些在其他项目的意见，被渲染并使用标准编辑delegates。然而，对于某些任务它能够插入部件中的表而不是有时是有用的。 Widget是针对特定的索引设置与setIndexWidget()功能，后来与检索indexWidget()。

| QTableView Class Reference - 图1 | By default, the cells in a table do not expand to fill the available space.可以通过拉伸最后一个头部分使细胞填满可用空间。通过访问相关的头horizontalHeader（）或verticalHeader（）和set头的stretchLastSection属性。要根据每列或行的空间需求分配的可用空间，调用视图的resizeColumnsToContents（）或resizeRowsToContents（）函数。 |

Coordinate Systems

对于一些特殊形式的表它能够以行和列索引和widget的坐标之间的转换是非常有用的。该rowAt（）函数提供的指定行的视图中的y坐标;行索引可以被用来获取一个对应的y坐标rowViewportPosition（ ） 。该columnAt（）和columnViewportPosition（）函数提供x坐标和列索引之间的等效转换操作。

Styles

QTableView中适当称呼为每个平台。下图显示它的外观在三个不同的平台。转到Qt Widget Gallery看到它在其他样式的外观。

| QTableView Class Reference - 图2 | QTableView Class Reference - 图3 | QTableView Class Reference - 图4 |
| A Windows XP style table view. | A Macintosh style table view. | A Plastique style table view. |

Method Documentation

  1. QTableView.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个表格视图parent来表示数据。

See also QAbstractItemModel。

  1. QTableView.clearSpans (self)

删除所有的行和列跨度的表格视图。

此功能被引入Qt的4.4 。

See also setSpan（ ） 。

  1. int QTableView.columnAt (self, int x)

返回该塔，在其中给定的x坐标，x在内容坐标系的位置。

Note:该函数返回-1，如果给定的坐标是无效的（无柱） 。

See also rowAt（ ） 。

  1. QTableView.columnCountChanged (self, int oldCount, int newCount)

这种方法也是一个Qt槽与C + +的签名void columnCountChanged(int,int)。

这个槽被调用时列添加或删除。由指定的列以前的数oldCount，由指定的列的新号码newCount。

  1. QTableView.columnMoved (self, int column, int oldIndex, int newIndex)

这种方法也是一个Qt槽与C + +的签名void columnMoved(int,int,int)。

这个槽被调用来改变给定的索引column在表视图。旧索引由指定oldIndex，并且由新的索引newIndex。

See also rowMoved（ ） 。

  1. QTableView.columnResized (self, int column, int oldWidth, int newWidth)

这种方法也是一个Qt槽与C + +的签名void columnResized(int,int,int)。

这个槽被调用来改变给定的宽度column。旧的宽度由规定oldWidth，并且由新的宽度newWidth。

See also rowResized（ ） 。

  1. int QTableView.columnSpan (self, int row, int column)

返回table元素的列跨度为（row，column） 。默认值是1 。

这个函数中引入了Qt 4.2中。

See also setSpan（）和rowSpan（ ） 。

  1. int QTableView.columnViewportPosition (self, int column)

返回给定的内容中x坐标坐标column。

  1. int QTableView.columnWidth (self, int column)

返回给定的宽度column。

See also setColumnWidth（ ）resizeColumnToContents（）和rowHeight（ ） 。

  1. QTableView.currentChanged (self, QModelIndex current, QModelIndex previous)

从重新实现QAbstractItemView.currentChanged（ ） 。

  1. Qt.PenStyle QTableView.gridStyle (self)

[

  1. QTableView.hideColumn (self, int column)

这种方法也是一个Qt槽与C + +的签名void hideColumn(int)。

隐藏指定column。

](docs_qt.html#PenStyle-enum)

See also showColumn（）和hideRow（ ） 。

  1. QTableView.hideRow (self, int row)

这种方法也是一个Qt槽与C + +的签名void hideRow(int)。

隐藏指定row。

See also showRow（）和hideColumn（ ） 。

  1. QHeaderView QTableView.horizontalHeader (self)

[

返回表视图的水平标题。

](docs_qheaderview.html)

See also setHorizontalHeader（ ）verticalHeader（）和QAbstractItemModel.headerData（ ） 。

  1. int QTableView.horizontalOffset (self)

从重新实现QAbstractItemView.horizontalOffset（ ） 。

返回水平在表视图中的项目所抵销。

请注意，表视图使用水平标题部分的位置来确定的列在视图中的位置。

See also verticalOffset（ ） 。

  1. QTableView.horizontalScrollbarAction (self, int action)
  1. QModelIndex QTableView.indexAt (self, QPoint p)

从重新实现QAbstractItemView.indexAt（ ） 。

返回相应的模型项的索引位置在位置表项目pos在内容坐标。

  1. bool QTableView.isColumnHidden (self, int column)

返回True如果给定的column被隐藏，否则返回False 。

See also isRowHidden（ ） 。

  1. bool QTableView.isCornerButtonEnabled (self)
  1. bool QTableView.isIndexHidden (self, QModelIndex index)

从重新实现QAbstractItemView.isIndexHidden（ ） 。

  1. bool QTableView.isRowHidden (self, int row)

返回True如果给定的row被隐藏，否则返回False 。

See also isColumnHidden（ ） 。

  1. bool QTableView.isSortingEnabled (self)
  1. QModelIndex QTableView.moveCursor (self, QAbstractItemView.CursorAction cursorAction, Qt.KeyboardModifiers modifiers)

从重新实现QAbstractItemView.moveCursor（ ） 。

移动光标按照给定的cursorAction使用由所提供的信息modifiers。

See also QAbstractItemView.CursorAction。

  1. QTableView.paintEvent (self, QPaintEvent e)

从重新实现QWidget.paintEvent（ ） 。

绘制表格收据上给定的油漆事件event。

  1. QTableView.resizeColumnsToContents (self)

这种方法也是一个Qt槽与C + +的签名void resizeColumnsToContents()。

重新调整的基础上用来呈现在列的每个项目委讬的大小暗示的所有列。

  1. QTableView.resizeColumnToContents (self, int column)

这种方法也是一个Qt槽与C + +的签名void resizeColumnToContents(int)。

调整大小给定的column根据用于呈现列中每个项目委讬的大小的提示。

Note:唯一可见的列将被调整。重新实现sizeHintForColumn（ ）调整隐藏的列也是如此。

  1. QTableView.resizeRowsToContents (self)

这种方法也是一个Qt槽与C + +的签名void resizeRowsToContents()。

重新调整的基础上用来渲染中的行的每个项目委讬的大小暗示的所有行。

  1. QTableView.resizeRowToContents (self, int row)

这种方法也是一个Qt槽与C + +的签名void resizeRowToContents(int)。

调整大小给定的row基于用于渲染的行中的每个项目委讬的大小的提示。

  1. int QTableView.rowAt (self, int y)

返回该行中给定的y坐标，y在内容坐标系的位置。

Note:该函数返回-1，如果给定的坐标是无效的（没有行） 。

See also columnAt（ ） 。

  1. QTableView.rowCountChanged (self, int oldCount, int newCount)

这种方法也是一个Qt槽与C + +的签名void rowCountChanged(int,int)。

这个槽被调用时行添加或删除。由指定的行之前的数oldCount，并且通过指定的行数的新newCount。

  1. int QTableView.rowHeight (self, int row)

返回给定的高度row。

See also setRowHeight（ ）resizeRowToContents（）和columnWidth（ ） 。

  1. QTableView.rowMoved (self, int row, int oldIndex, int newIndex)

这种方法也是一个Qt槽与C + +的签名void rowMoved(int,int,int)。

这个槽被调用来改变给定的索引row在表视图。旧索引由指定oldIndex，并且由新的索引newIndex。

See also columnMoved（ ） 。

  1. QTableView.rowResized (self, int row, int oldHeight, int newHeight)

这种方法也是一个Qt槽与C + +的签名void rowResized(int,int,int)。

这个槽被调用来改变给定的高度row。旧的高度由指定oldHeight，和新的高度由newHeight。

See also columnResized（ ） 。

  1. int QTableView.rowSpan (self, int row, int column)

返回表元素的行间距为（row，column） 。默认值是1 。

这个函数中引入了Qt 4.2中。

See also setSpan（）和columnSpan（ ） 。

  1. int QTableView.rowViewportPosition (self, int row)

返回给定的内容中y坐标坐标row。

  1. QTableView.scrollContentsBy (self, int dx, int dy)
  1. QTableView.scrollTo (self, QModelIndex index, QAbstractItemView.ScrollHint hint = QAbstractItemView.EnsureVisible)
  1. QTableView.selectColumn (self, int column)

这种方法也是一个Qt槽与C + +的签名void selectColumn(int)。

选择给定的column在表视图，如果当前SelectionMode和SelectionBehavior允许选择的列。

See also selectRow（ ） 。

  1. list-of-QModelIndex QTableView.selectedIndexes (self)

从重新实现QAbstractItemView.selectedIndexes（ ） 。

  1. QTableView.selectionChanged (self, QItemSelection selected, QItemSelection deselected)

从重新实现QAbstractItemView.selectionChanged（ ） 。

  1. QTableView.selectRow (self, int row)

这种方法也是一个Qt槽与C + +的签名void selectRow(int)。

选择给定的row在表视图，如果当前SelectionMode和SelectionBehavior允许选择的行。

See also selectColumn（ ） 。

  1. QTableView.setColumnHidden (self, int column, bool hide)

If hide是真正的给定column将被隐藏，否则将被显示。

See also isColumnHidden（）和setRowHidden（ ） 。

  1. QTableView.setColumnWidth (self, int column, int width)

设定的给定的宽度column要width。

这个函数是Qt 4.1中引入。

See also columnWidth（ ） 。

  1. QTableView.setCornerButtonEnabled (self, bool enable)
  1. QTableView.setGridStyle (self, Qt.PenStyle style)
  1. QTableView.setHorizontalHeader (self, QHeaderView header)

该header说法有它的所有权转移给Qt的。

设置部件用于在水平标头header。

See also horizontalHeader（）和setVerticalHeader（ ） 。

  1. QTableView.setModel (self, QAbstractItemModel model)

从重新实现QAbstractItemView.setModel（ ） 。

  1. QTableView.setRootIndex (self, QModelIndex index)

从重新实现QAbstractItemView.setRootIndex（ ） 。

  1. QTableView.setRowHeight (self, int row, int height)

设定的给定的高度row要height。

这个函数是Qt 4.1中引入。

See also rowHeight（ ） 。

  1. QTableView.setRowHidden (self, int row, bool hide)

If hide是真的row将被隐藏，否则会被显示。

See also isRowHidden（）和setColumnHidden（ ） 。

  1. QTableView.setSelection (self, QRect rect, QItemSelectionModel.SelectionFlags command)

从重新实现QAbstractItemView.setSelection（ ） 。

选择在给定的项目rect并按照指定的选择flags。

  1. QTableView.setSelectionModel (self, QItemSelectionModel selectionModel)

从重新实现QAbstractItemView.setSelectionModel（ ） 。

  1. QTableView.setShowGrid (self, bool show)
  1. QTableView.setSortingEnabled (self, bool enable)
  1. QTableView.setSpan (self, int row, int column, int rowSpan, int columnSpan)

设置表格单元的跨度为（row，column），以通过（指定的行和列的数量rowSpanCount，columnSpanCount） 。

这个函数中引入了Qt 4.2中。

See also rowSpan（）和columnSpan（ ） 。

  1. QTableView.setVerticalHeader (self, QHeaderView header)

该header说法有它的所有权转移给Qt的。

设置部件用于在垂直头header。

See also verticalHeader（）和setHorizontalHeader（ ） 。

  1. QTableView.setWordWrap (self, bool on)
  1. QTableView.showColumn (self, int column)

这种方法也是一个Qt槽与C + +的签名void showColumn(int)。

显示给定的column。

See also hideColumn（）和showRow（ ） 。

  1. bool QTableView.showGrid (self)
  1. QTableView.showRow (self, int row)

这种方法也是一个Qt槽与C + +的签名void showRow(int)。

显示给定的row。

See also hideRow（）和showColumn（ ） 。

  1. int QTableView.sizeHintForColumn (self, int column)

从重新实现QAbstractItemView.sizeHintForColumn（ ） 。

返回尺寸暗示对于给定的column的宽度或-1 ，如果没有模型。

如果你需要一个给定列的宽度设置为一个固定值，调用QHeaderView.resizeSection（ ）在桌子上的水平标题。

如果在子类中重新实现这个功能，请注意您返回值时，将使用resizeColumnToContents（）或QHeaderView.resizeSections（）被调用。如果一个较大的列宽是必需的任何一方的横头或项目的委讬，较大的宽度将被代替使用。

See also QWidget.sizeHint和horizontalHeader（ ） 。

  1. int QTableView.sizeHintForRow (self, int row)

从重新实现QAbstractItemView.sizeHintForRow（ ） 。

返回尺寸暗示对于给定的row的高度或-1 ，如果没有模型。

如果你需要一个给定的行的高度设置为一个固定值，调用QHeaderView.resizeSection（ ）在桌子上的垂直标题。

如果在子类中重新实现这个功能，请注意您返回值时只使用resizeRowToContents（）被调用。在这种情况下，如果一个较大的行高是必需的任何一方向垂直头或项目委讬时，该宽度将被代替使用。

See also QWidget.sizeHint和verticalHeader（ ） 。

  1. QTableView.sortByColumn (self, int column)

这种方法也是一个Qt槽与C + +的签名void sortByColumn(int)。

通过在给定的值进行排序的模型column在给定的order。

这个函数中引入了Qt 4.2中。

See also sortingEnabled。

  1. QTableView.sortByColumn (self, int column, Qt.SortOrder order)
  1. QTableView.timerEvent (self, QTimerEvent event)

从重新实现QObject.timerEvent（ ） 。

  1. QTableView.updateGeometries (self)

从重新实现QAbstractItemView.updateGeometries（ ） 。

  1. QHeaderView QTableView.verticalHeader (self)

[

返回表视图的垂直插头。

](docs_qheaderview.html)

See also setVerticalHeader（ ）horizontalHeader（）和QAbstractItemModel.headerData（ ） 。

  1. int QTableView.verticalOffset (self)

从重新实现QAbstractItemView.verticalOffset（ ） 。

返回垂直的表视图中的项目所抵销。

请注意，表视图使用垂直标题部分的位置来确定的行视图的位置。

See also horizontalOffset（ ） 。

  1. QTableView.verticalScrollbarAction (self, int action)
  1. QStyleOptionViewItem QTableView.viewOptions (self)

从重新实现QAbstractItemView.viewOptions（ ） 。

  1. QRect QTableView.visualRect (self, QModelIndex index)
  1. QRegion QTableView.visualRegionForSelection (self, QItemSelection selection)

[

  1. bool QTableView.wordWrap (self)

](docs_qregion.html)