QTableView Class

成员函数

QTableView::QTableView(QWidget *parent = Q_NULLPTR)

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

参见 QAbstractItemModel.

QTableView::~QTableView()

Destroys the table view.

void QTableView::clearSpans()

Removes all row and column spans in the table view.

This function was introduced in Qt 4.4.

参见 setSpan().

int QTableView::columnAt(int x) const

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

参见 rowAt().

[protected slot] void QTableView::columnCountChanged(int oldCount, int newCount)

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.

[protected slot] void QTableView::columnMoved(int column, int oldIndex, int newIndex)

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.

参见 rowMoved().

[protected slot] void QTableView::columnResized(int column, int oldWidth, int newWidth)

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.

参见 rowResized().

int QTableView::columnSpan(int row, int column) const

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

This function was introduced in Qt 4.2.

参见 setSpan() and rowSpan().

int QTableView::columnViewportPosition(int column) const

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

int QTableView::columnWidth(int column) const

Returns the width of the given column.

参见 setColumnWidth(), resizeColumnToContents(), and rowHeight().

[virtual protected] void QTableView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

重新实现 QAbstractItemView::currentChanged().

[slot] void QTableView::hideColumn(int column)

Hide the given column.

参见 showColumn() and hideRow().

[slot] void QTableView::hideRow(int row)

Hide the given row.

参见 showRow() and hideColumn().

QHeaderView *QTableView::horizontalHeader() const

Returns the table view's horizontal header.

参见 setHorizontalHeader(), verticalHeader(), and QAbstractItemModel::headerData().

[virtual protected] int QTableView::horizontalOffset() const

重新实现 QAbstractItemView::horizontalOffset().

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.

参见 verticalOffset().

[virtual] QModelIndex QTableView::indexAt(const QPoint &pos) const

重新实现 QAbstractItemView::indexAt().

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

bool QTableView::isColumnHidden(int column) const

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

参见 isRowHidden().

[virtual protected] bool QTableView::isIndexHidden(const QModelIndex &index) const

重新实现 QAbstractItemView::isIndexHidden().

bool QTableView::isRowHidden(int row) const

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

参见 isColumnHidden().

[virtual protected] QModelIndex QTableView::moveCursor(CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

重新实现 QAbstractItemView::moveCursor().

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

参见 QAbstractItemView::CursorAction.

[virtual protected] void QTableView::paintEvent(QPaintEvent *event)

重新实现 QWidget::paintEvent().

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

[slot] void QTableView::resizeColumnToContents(int column)

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.

参见 resizeColumnsToContents(), sizeHintForColumn(), and QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeColumnsToContents()

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

参见 resizeColumnToContents(), sizeHintForColumn(), and QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowToContents(int row)

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

参见 resizeRowsToContents(), sizeHintForRow(), and QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowsToContents()

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

参见 resizeRowToContents(), sizeHintForRow(), and QHeaderView::resizeContentsPrecision().

int QTableView::rowAt(int y) const

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

参见 columnAt().

[protected slot] void QTableView::rowCountChanged(int oldCount, int newCount)

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.

int QTableView::rowHeight(int row) const

Returns the height of the given row.

参见 setRowHeight(), resizeRowToContents(), and columnWidth().

[protected slot] void QTableView::rowMoved(int row, int oldIndex, int newIndex)

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.

参见 columnMoved().

[protected slot] void QTableView::rowResized(int row, int oldHeight, int newHeight)

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.

参见 columnResized().

int QTableView::rowSpan(int row, int column) const

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

This function was introduced in Qt 4.2.

参见 setSpan() and columnSpan().

int QTableView::rowViewportPosition(int row) const

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

[slot] void QTableView::selectColumn(int column)

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

参见 selectRow().

[slot] void QTableView::selectRow(int row)

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

参见 selectColumn().

[virtual protected] QModelIndexList QTableView::selectedIndexes() const

重新实现 QAbstractItemView::selectedIndexes().

[virtual protected] void QTableView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

重新实现 QAbstractItemView::selectionChanged().

void QTableView::setColumnHidden(int column, bool hide)

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

参见 isColumnHidden() and setRowHidden().

void QTableView::setColumnWidth(int column, int width)

Sets the width of the given column to be width.

This function was introduced in Qt 4.1.

参见 columnWidth().

void QTableView::setHorizontalHeader(QHeaderView *header)

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

参见 horizontalHeader() and setVerticalHeader().

[virtual] void QTableView::setModel(QAbstractItemModel *model)

重新实现 QAbstractItemView::setModel().

[virtual] void QTableView::setRootIndex(const QModelIndex &index)

重新实现 QAbstractItemView::setRootIndex().

void QTableView::setRowHeight(int row, int height)

Sets the height of the given row to be height.

This function was introduced in Qt 4.1.

参见 rowHeight().

void QTableView::setRowHidden(int row, bool hide)

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

参见 isRowHidden() and setColumnHidden().

[virtual protected] void QTableView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

重新实现 QAbstractItemView::setSelection().

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

[virtual] void QTableView::setSelectionModel(QItemSelectionModel *selectionModel)

重新实现 QAbstractItemView::setSelectionModel().

void QTableView::setSortingEnabled(bool enable)

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

Note: Setter function for property sortingEnabled.

参见 isSortingEnabled().

void QTableView::setSpan(int row, int column, int rowSpanCount, int columnSpanCount)

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

This function was introduced in Qt 4.2.

参见 rowSpan() and columnSpan().

void QTableView::setVerticalHeader(QHeaderView *header)

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

参见 verticalHeader() and setHorizontalHeader().

[slot] void QTableView::showColumn(int column)

Show the given column.

参见 hideColumn() and showRow().

[slot] void QTableView::showRow(int row)

Show the given row.

参见 hideRow() and showColumn().

[virtual protected] int QTableView::sizeHintForColumn(int column) const

重新实现 QAbstractItemView::sizeHintForColumn().

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.

参见 QWidget::sizeHint, horizontalHeader(), and QHeaderView::resizeContentsPrecision().

[virtual protected] int QTableView::sizeHintForRow(int row) const

重新实现 QAbstractItemView::sizeHintForRow().

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.

参见 QWidget::sizeHint, verticalHeader(), and QHeaderView::resizeContentsPrecision().

void QTableView::sortByColumn(int column, Qt::SortOrder order)

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

This function was introduced in Qt 4.2.

参见 sortingEnabled.

[virtual protected] void QTableView::timerEvent(QTimerEvent *event)

重新实现 QObject::timerEvent().

[virtual protected] void QTableView::updateGeometries()

重新实现 QAbstractItemView::updateGeometries().

QHeaderView *QTableView::verticalHeader() const

Returns the table view's vertical header.

参见 setVerticalHeader(), horizontalHeader(), and QAbstractItemModel::headerData().

[virtual protected] int QTableView::verticalOffset() const

重新实现 QAbstractItemView::verticalOffset().

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.

参见 horizontalOffset().

[virtual protected] QStyleOptionViewItem QTableView::viewOptions() const

重新实现 QAbstractItemView::viewOptions().

[virtual protected] QSize QTableView::viewportSizeHint() const

重新实现 QAbstractScrollArea::viewportSizeHint().