QTableView¶

The QTableView class provides a default model/view implementation of a table view. More…

Inherited by: QTableWidget

Synopsis¶

Functions¶

def clearSpans ()
def columnAt (x)
def columnSpan (row, column)
def columnViewportPosition (column)
def columnWidth (column)
def gridStyle ()
def horizontalHeader ()
def isColumnHidden (column)
def isCornerButtonEnabled ()
def isRowHidden (row)
def isSortingEnabled ()
def rowAt (y)
def rowHeight (row)
def rowSpan (row, column)
def rowViewportPosition (row)
def setColumnHidden (column, hide)
def setColumnWidth (column, width)
def setCornerButtonEnabled (enable)
def setGridStyle (style)
def setHorizontalHeader (header)
def setRowHeight (row, height)
def setRowHidden (row, hide)
def setSortingEnabled (enable)
def setSpan (row, column, rowSpan, columnSpan)
def setVerticalHeader (header)
def setWordWrap (on)
def showGrid ()
def sortByColumn (column, order)
def verticalHeader ()
def wordWrap ()

Slots¶

def columnCountChanged (oldCount, newCount)
def columnMoved (column, oldIndex, newIndex)
def columnResized (column, oldWidth, newWidth)
def hideColumn (column)
def hideRow (row)
def resizeColumnToContents (column)
def resizeColumnsToContents ()
def resizeRowToContents (row)
def resizeRowsToContents ()
def rowCountChanged (oldCount, newCount)
def rowMoved (row, oldIndex, newIndex)
def rowResized (row, oldHeight, newHeight)
def selectColumn (column)
def selectRow (row)
def setShowGrid (show)
def showColumn (column)
def showRow (row)
def sortByColumn (column)

Detailed Description¶

A QTableView implements a table view that displays items from a model. This class is used to provide standard tables that were previously provided by the QTable class, but using the more flexible approach provided by Qt’s model/view architecture.

The QTableView class is one of the Model/View Classes and is part of Qt’s model/view framework .

QTableView implements the interfaces defined by the QAbstractItemView class to allow it to display data provided by models derived from the QAbstractItemModel class.

Visual Appearance¶

The table has a vertical header that can be obtained using the verticalHeader() function, and a horizontal header that is available through the horizontalHeader() function. The height of each row in the table can be found by using rowHeight() ; similarly, the width of columns can be found using columnWidth() . Since both of these are plain widgets, you can hide either of them using their hide() functions.

Rows and columns can be hidden and shown with hideRow() , hideColumn() , showRow() , and showColumn() . They can be selected with selectRow() and selectColumn() . The table will show a grid depending on the showGrid property.

The items shown in a table view, like those in the other item views, are rendered and edited using standard delegates . However, for some tasks it is sometimes useful to be able to insert widgets in a table instead. Widgets are set for particular indexes with the setIndexWidget() function, and later retrieved with indexWidget() .

By default, the cells in a table do not expand to fill the available space.

You can make the cells fill the available space by stretching the last header section. Access the relevant header using horizontalHeader() or verticalHeader() and set the header’s stretchLastSection property.

To distribute the available space according to the space requirement of each column or row, call the view’s resizeColumnsToContents() or resizeRowsToContents() functions.

Coordinate Systems¶

For some specialized forms of tables it is useful to be able to convert between row and column indexes and widget coordinates. The rowAt() function provides the y-coordinate within the view of the specified row; the row index can be used to obtain a corresponding y-coordinate with rowViewportPosition() . The columnAt() and columnViewportPosition() functions provide the equivalent conversion operations between x-coordinates and column indexes.

See also

QTableWidget View Classes QAbstractItemModel QAbstractItemView Chart Example Pixelator Example Table Model Example

class QTableView([parent=None])¶

param parent

QWidget

Constructs a table view with a parent to represent the data.

See also

QAbstractItemModel

PySide2.QtWidgets.QTableView.clearSpans()¶: Removes all row and column spans in the table view.

See also

setSpan()

PySide2.QtWidgets.QTableView.columnAt(x)¶

Parameters: x – int
Return type: int

Returns the column in which the given x-coordinate, x , in contents coordinates is located.

Note

This function returns -1 if the given coordinate is not valid (has no column).

See also

rowAt()

PySide2.QtWidgets.QTableView.columnCountChanged(oldCount, newCount)¶

Parameters

oldCount – int
newCount – int

This slot is called whenever columns are added or deleted. The previous number of columns is specified by oldCount , and the new number of columns is specified by newCount .

PySide2.QtWidgets.QTableView.columnMoved(column, oldIndex, newIndex)¶

Parameters

column – int
oldIndex – int
newIndex – int

This slot is called to change the index of the given column in the table view. The old index is specified by oldIndex , and the new index by newIndex .

See also

rowMoved()

PySide2.QtWidgets.QTableView.columnResized(column, oldWidth, newWidth)¶

Parameters

column – int
oldWidth – int
newWidth – int

This slot is called to change the width of the given column . The old width is specified by oldWidth , and the new width by newWidth .

See also

rowResized()

PySide2.QtWidgets.QTableView.columnSpan(row, column)¶

Parameters

row – int
column – int

Return type

int

Returns the column span of the table element at (row , column ). The default is 1.

See also

setSpan() rowSpan()

PySide2.QtWidgets.QTableView.columnViewportPosition(column)¶

Parameters: column – int
Return type: int

Returns the x-coordinate in contents coordinates of the given column .

PySide2.QtWidgets.QTableView.columnWidth(column)¶

Parameters: column – int
Return type: int

Returns the width of the given column .

PySide2.QtWidgets.QTableView.gridStyle()¶

Return type: PenStyle

See also

setGridStyle()

PySide2.QtWidgets.QTableView.hideColumn(column)¶

Parameters: column – int

Hide the given column .

See also

showColumn() hideRow()

PySide2.QtWidgets.QTableView.hideRow(row)¶

Parameters: row – int

Hide the given row .

See also

showRow() hideColumn()

PySide2.QtWidgets.QTableView.horizontalHeader()¶

Return type: QHeaderView

Returns the table view’s horizontal header.

PySide2.QtWidgets.QTableView.isColumnHidden(column)¶

Parameters: column – int
Return type: bool

Returns true if the given column is hidden; otherwise returns false .

See also

isRowHidden()

PySide2.QtWidgets.QTableView.isCornerButtonEnabled()¶

Return type: bool

PySide2.QtWidgets.QTableView.isRowHidden(row)¶

Parameters: row – int
Return type: bool

Returns true if the given row is hidden; otherwise returns false .

See also

isColumnHidden()

PySide2.QtWidgets.QTableView.isSortingEnabled()¶

Return type: bool

PySide2.QtWidgets.QTableView.resizeColumnToContents(column)¶

Parameters: column – int

Resizes the given column based on the size hints of the delegate used to render each item in the column.

Note

Only visible columns will be resized. Reimplement sizeHintForColumn() to resize hidden columns as well.

PySide2.QtWidgets.QTableView.resizeColumnsToContents()¶: Resizes all columns based on the size hints of the delegate used to render each item in the columns.

See also

resizeColumnToContents() sizeHintForColumn() resizeContentsPrecision()

PySide2.QtWidgets.QTableView.resizeRowToContents(row)¶

Parameters: row – int

Resizes the given row based on the size hints of the delegate used to render each item in the row.

PySide2.QtWidgets.QTableView.resizeRowsToContents()¶: Resizes all rows based on the size hints of the delegate used to render each item in the rows.

See also

resizeRowToContents() sizeHintForRow() resizeContentsPrecision()

PySide2.QtWidgets.QTableView.rowAt(y)¶

Parameters: y – int
Return type: int

Returns the row in which the given y-coordinate, y , in contents coordinates is located.

Note

This function returns -1 if the given coordinate is not valid (has no row).

See also

columnAt()

PySide2.QtWidgets.QTableView.rowCountChanged(oldCount, newCount)¶

Parameters

oldCount – int
newCount – int

This slot is called whenever rows are added or deleted. The previous number of rows is specified by oldCount , and the new number of rows is specified by newCount .

PySide2.QtWidgets.QTableView.rowHeight(row)¶

Parameters: row – int
Return type: int

Returns the height of the given row .

PySide2.QtWidgets.QTableView.rowMoved(row, oldIndex, newIndex)¶

Parameters

row – int
oldIndex – int
newIndex – int

This slot is called to change the index of the given row in the table view. The old index is specified by oldIndex , and the new index by newIndex .

See also

columnMoved()

PySide2.QtWidgets.QTableView.rowResized(row, oldHeight, newHeight)¶

Parameters