QTableView Class

You can navigate the cells in the table by clicking on a cell with the mouse, or by using the arrow keys. Because QTableView enables tabKeyNavigation by default, you can also hit Tab and Backtab to move from cell to cell.

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. Each header is configured with its highlightSections and sectionsClickable properties set to true.

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().

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

This property holds whether the button in the top-left corner is enabled

If this property is true then button in the top-left corner of the table view is enabled. Clicking on this button will select all the cells in the table view.

This property is true by default.

Access functions:

• bool isCornerButtonEnabled() const

• void setCornerButtonEnabled(bool enable)

This property holds the pen style used to draw the grid.

This property holds the style used when drawing the grid (see showGrid).

Access functions:

• gridStyle() const

• void setGridStyle( style)

This property holds whether the grid is shown

If this property is true a grid is drawn for the table; if the property is false, no grid is drawn. The default value is true.

Access functions:

• bool showGrid() const

• void setShowGrid(bool show)

This property holds whether sorting is enabled

If this property is true, sorting is enabled for the table. If this property is false, sorting is not enabled. The default value is false.

Access functions:

• bool isSortingEnabled() const

• void setSortingEnabled(bool enable)

See Also▲

This property holds the item text word-wrapping policy

If this property is true then the item text is wrapped where necessary at word-breaks; otherwise it is not wrapped at all. This property is true by default.

Note that even of wrapping is enabled, the cell will not be expanded to fit all text. Ellipsis will be inserted according to the current textElideMode.

Access functions:

• bool wordWrap() const

• void setWordWrap(bool on)

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

See Also▲

Destroys the table view.

Removes all row and column spans in the table view.

See Also▲

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

See Also▲

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.

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▲

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▲

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

See Also▲

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

Returns the width of the given column.

See Also▲

Reimplements: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

Hide the given column.

See Also▲

Hide the given row.

See Also▲

Returns the table view's horizontal header.

See Also▲

Reimplements: QAbstractItemView::horizontalOffset() const.

Returns the horizontal offset of the items in the table view.

Note that the table view uses the horizontal header section positions to determine the positions of columns in the view.

See Also▲

Reimplements: QAbstractItemView::indexAt(const QPoint &point) const.

Returns the index position of the model item corresponding to the table item at position pos in contents coordinates.

Reimplements: QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const.

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

See Also▲

Reimplements: QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

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

See Also▲

Reimplements: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

Moves the cursor in accordance with the given cursorAction, using the information provided by the modifiers.

See Also▲

Reimplements: QAbstractScrollArea::paintEvent(QPaintEvent *event).

Paints the table on receipt of the given paint event event.

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

See Also▲

Resizes all columns based on the size hints of the delegate used to render each item in the columns.

See Also▲

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

See Also▲

Resizes all rows based on the size hints of the delegate used to render each item in the rows.

See Also▲

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

See Also▲

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.

Returns the height of the given row.

See Also▲

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▲

This slot is called to change the height of the given row. The old height is specified by oldHeight, and the new height by newHeight.

See Also▲

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

See Also▲

Returns the y-coordinate in contents coordinates of the given row.

Reimplements: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

Scroll the contents of the table view by (dx, dy).

Reimplements: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

Makes sure that the given index is visible in the table view, scrolling if necessary.

Selects the given column in the table view if the current SelectionMode and SelectionBehavior allows columns to be selected.

See Also▲

Selects the given row in the table view if the current SelectionMode and SelectionBehavior allows rows to be selected.

See Also▲

Reimplements: QAbstractItemView::selectedIndexes() const.

Reimplements: QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

If hide is true the given column will be hidden; otherwise it will be shown.

See Also▲

Sets the width of the given column to be width.

See Also▲

Sets the widget to use for the horizontal header to header.

See Also▲

Reimplements: QAbstractItemView::setModel(QAbstractItemModel *model).

Reimplements: QAbstractItemView::setRootIndex(const QModelIndex &index).

Sets the height of the given row to be height.

See Also▲

If hide is true row will be hidden, otherwise it will be shown.

See Also▲

Reimplements: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Selects the items within the given rect and in accordance with the specified selection flags.

Reimplements: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

If enable is true, enables sorting for the table and immediately trigger a call to sortByColumn() with the current sort section and order

See Also▲

Sets the span of the table element at (row, column) to the number of rows and columns specified by (rowSpanCount, columnSpanCount).

See Also▲

Sets the widget to use for the vertical header to header.

See Also▲

Show the given column.

See Also▲

Show the given row.

See Also▲

Reimplements: QAbstractItemView::sizeHintForColumn(int column) const.

Returns the size hint for the given column's width or -1 if there is no model.

If you need to set the width of a given column to a fixed value, call QHeaderView::resizeSection() on the table's horizontal header.

If you reimplement this function in a subclass, note that the value you return will be used when resizeColumnToContents() or QHeaderView::resizeSections() is called. If a larger column width is required by either the horizontal header or the item delegate, the larger width will be used instead.

See Also▲

Reimplements: QAbstractItemView::sizeHintForRow(int row) const.

Returns the size hint for the given row's height or -1 if there is no model.

If you need to set the height of a given row to a fixed value, call QHeaderView::resizeSection() on the table's vertical header.

If you reimplement this function in a subclass, note that the value you return is only used when resizeRowToContents() is called. In that case, if a larger row height is required by either the vertical header or the item delegate, that width will be used instead.

See Also▲

Sorts the model by the values in the given column and order.

column may be -1, in which case no sort indicator will be shown and the model will return to its natural, unsorted order. Note that not all models support this and may even crash in this case.

See Also▲

Reimplements: QAbstractItemView::timerEvent(QTimerEvent *event).

Reimplements: QAbstractItemView::updateGeometries().

Returns the table view's vertical header.

See Also▲

Reimplements: QAbstractItemView::verticalOffset() const.

Returns the vertical offset of the items in the table view.

Note that the table view uses the vertical header section positions to determine the positions of rows in the view.

See Also▲

Reimplements: QAbstractItemView::viewportSizeHint() const.

Reimplements: QAbstractItemView::visualRect(const QModelIndex &index) const.

Returns the rectangle on the viewport occupied by the given index. If the index is hidden in the view it will return a null QRect.

Reimplements: QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

Returns the rectangle from the viewport of the items in the given selection.

Since 4.7, the returned region only contains rectangles intersecting (or included in) the viewport.