QTableView 类

成员函数文档

[显式] QTableView::QTableView(QWidget *parent = nullptr)

创建一个表视图，用于表示数据，并带有 parent。

另请参阅QAbstractItemModel。

[虚拟 noexcept] QTableView::~QTableView()

销毁表视图。

void QTableView::clearSpans()

移除表视图中的所有行和列跨度。

另请参阅setSpan。

int QTableView::columnAt(int x) const

返回包含给定内容坐标 x 坐标的列。

另请参阅rowAt。

[保护槽] void QTableView::columnCountChanged(int oldCount, int newCount)

每当添加或删除列时调用此槽。之前列数由 oldCount 指定，新的列数由 newCount 指定。

[保护槽] void QTableView::columnMoved(int column, int oldIndex, int newIndex)

调用此槽以更改表视图中给定 column 的索引。旧的索引由 oldIndex 指定，新的索引由 newIndex 指定。

另请参阅rowMoved。

[保护槽] void QTableView::columnResized(int column, int oldWidth, int newWidth)

调用此槽以更改给定 column 的宽度。旧宽度由 oldWidth 指定，新宽度由 newWidth 指定。

另请参阅rowResized。

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

返回位于 (row, column) 处的表元素的列跨度。默认值为 1。

另请参阅setSpan 和 rowSpan。

int QTableView::columnViewportPosition(int column) const

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

int QTableView::columnWidth(int column) const

返回给定 column 的宽度。

另请参阅setColumnWidth，resizeColumnToContents 和 rowHeight。

[覆盖虚保护] void QTableView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

重新实现：QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

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

隐藏指定的 列.

另请参阅showColumn() 和 hideRow().

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

隐藏指定的 行.

另请参阅showRow() 和 hideColumn().

QHeaderView *QTableView::horizontalHeader() const

返回表格的水平表头。

另请参阅setHorizontalHeader()、verticalHeader() 和 QAbstractItemModel::headerData().

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

重新实现：QAbstractItemView::horizontalOffset() const.

返回表格视图中项目的水平偏移。

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

另请参阅verticalOffset().

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

重新实现：QAbstractItemView::indexAt(const QPoint &point) const.

返回模型项和表格中在内容坐标系中位置为 pos 的项目相对应的索引位置。

[override virtual protected] void QTableView::initViewItemOption(QStyleOptionViewItem *option) const

重新实现：QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const.

bool QTableView::isColumnHidden(int column) const

如果指定的 列 被隐藏，则返回 true；否则返回 false。

另请参阅isRowHidden().

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

重新实现：QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QTableView::isRowHidden(int row) const

如果指定的 行 被隐藏，则返回 true；否则返回 false。

另请参阅isColumnHidden().

[override virtual] QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

重新实现：QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

根据给定的 cursorAction 移动光标，并使用由 modifiers 提供的信息。

另请参阅QAbstractItemView::CursorAction.

[重载虚拟保护] void QTableView::paintEvent(QPaintEvent *event)

重新实现：QAbstractScrollArea::paintEvent(QPaintEvent *event)

在接收到给定的绘制事件 event 时绘制表格。

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

根据用于渲染列中每个项的代理的大小提示重新设置给定的 column 的大小。

另请参阅resizeColumnsToContents(), sizeHintForColumn() 和 QHeaderView::resizeContentsPrecision.

[槽] void QTableView::resizeColumnsToContents()

根据用于渲染列中每个项的代理的大小提示调整所有列的大小。

另请参阅resizeColumnToContents(), sizeHintForColumn() 和 QHeaderView::resizeContentsPrecision.

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

根据用于渲染行中每个项的代理的大小提示重新设置给定的 row 的大小。

另请参阅resizeRowsToContents(), sizeHintForRow() 和 QHeaderView::resizeContentsPrecision.

[槽] void QTableView::resizeRowsToContents()

根据用于渲染行中每个项的代理的大小提示调整所有行的大小。

另请参阅resizeRowToContents(), sizeHintForRow() 和 QHeaderView::resizeContentsPrecision.

int QTableView::rowAt(int y) const

返回给定内容坐标中的 y 坐标所在的行。

另请参阅columnAt().

[保护槽] void QTableView::rowCountChanged(int oldCount, int newCount)

每当添加或删除行时，都会调用此槽。以前行数由 oldCount 指定，新行数由 newCount 指定。

int QTableView::rowHeight(int row) const

返回给定 行 的高度。

另请参阅 setRowHeight()，resizeRowToContents()和columnWidth()。

[受保护的槽函数] void QTableView::rowMoved(int row, int oldIndex, int newIndex)

此槽函数用于更改表格视图中给定 行 的索引。旧索引由 oldIndex 指定，新索引由 newIndex 指定。

另请参阅 columnMoved()。

[受保护的槽函数] void QTableView::rowResized(int row, int oldHeight, int newHeight)

该槽函数用于更改给定 行 的高度。旧高度由 oldHeight 指定，新高度由 newHeight 指定。

另请参阅 columnResized()。

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

返回表格元素（行, 列）的行跨度。默认为 1。

另请参阅 setSpan() 和 columnSpan()。

int QTableView::rowViewportPosition(int row) const

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

[重写虚拟受保护的] void QTableView::scrollContentsBy(int dx, int dy)

重新实现了: QAbstractScrollArea::scrollContentsBy(int dx, int dy)

通过（dx, dy）滚动表格视图的内容。

[重写虚拟] void QTableView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

重新实现了: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)

确保给定的 索引 在表格视图中可见，并在必要时进行滚动。

[槽函数] void QTableView::selectColumn(int column)

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

另请参阅 selectRow()。

[槽函数] void QTableView::selectRow(int row)

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

另请参阅 selectColumn()。

[重写虚拟受保护的] QModelIndexList QTableView::selectedIndexes() const

重新实现：QAbstractItemView::selectedIndexes() const.

[覆盖虚保护] void QTableView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

重新实现：QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

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

如果 hide 为 true，则给定 column 将被隐藏；否则将显示。

另请参阅 isColumnHidden() 和 setRowHidden().

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

将给定 column 的宽度设置为 width。

另请参阅 columnWidth().

void QTableView::setHorizontalHeader(QHeaderView *header)

设置用于水平标题的控件为 header。

另请参阅 horizontalHeader() 和 setVerticalHeader().

[覆盖虚] void QTableView::setModel(QAbstractItemModel *model)

重新实现：QAbstractItemView::setModel(QAbstractItemModel *model).

[覆盖虚] void QTableView::setRootIndex(const QModelIndex &index)

重新实现：QAbstractItemView::setRootIndex(const QModelIndex &index).

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

将给定 row 的高度设置为 height。

另请参阅 rowHeight().

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

如果 hide 为 true，row 将被隐藏，否则将显示。

另请参阅 isRowHidden() 和 setColumnHidden().

[覆盖虚保护] void QTableView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

重新实现：QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

选择给定 rect 内的项，并按照指定的选择 flags。

[覆盖虚] void QTableView::setSelectionModel(QItemSelectionModel *selectionModel)

重实现：QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QTableView::setSortingEnabled(bool enable)

如果 enable 为真，则启用表格排序并立即调用 sortByColumn() 以当前排序的列和顺序

另请参阅：isSortingEnabled().

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

将表格元素在 (row, column) 的范围设置为通过 (rowSpanCount, columnSpanCount) 指定的行数和列数。

另请参阅：rowSpan() 和 columnSpan().

void QTableView::setVerticalHeader(QHeaderView *header)

将用于垂直表头的控件设置为 header。

另请参阅：verticalHeader() 和 setHorizontalHeader().

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

显示给定的 column。

另请参阅：hideColumn() 和 showRow().

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

显示给定的 row。

另请参阅：hideRow() 和 showColumn().

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

重实现了：QAbstractItemView::sizeHintForColumn(int column) const.

返回给定 column 的宽度的大小提示或如果没有模型则返回 -1。

如果您需要将给定列的宽度设置为固定值，请在表格的水平表头上调用 QHeaderView::resizeSection().

如果您在子类中重写此函数，请注意您返回的值将被用于调用 resizeColumnToContents() 或 QHeaderView::resizeSections() 时。如果水平表头或项目代理需要更大的列宽，则将使用更大的宽度。

另请参阅：QWidget::sizeHint，horizontalHeader() 和 QHeaderView::resizeContentsPrecision().

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

重实现了：QAbstractItemView::sizeHintForRow(int row) const.

返回给定 row 的高度的大小提示或如果没有模型则返回 -1。

如果您需要将给定行的长度设置为固定值，请在表格的垂直表头上调用 QHeaderView::resizeSection().

如果您在子类中重新实现了这个函数，请注意，您返回的值仅在使用时返回resizeRowToContents()。在这种情况下，如果垂直表头或项目代理需要更大的行高，将使用该宽度。

另请参阅QWidget::sizeHint，verticalHeader()和QHeaderView::resizeContentsPrecision。

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

按给定列的值和秩序对模型进行排序。

column可能为-1，在这种情况下，不会显示排序指示器，并且模型将返回其自然、未排序的顺序。请注意，并非所有模型都支持此功能，甚至可能在这种情况下崩溃。

另请参阅sortingEnabled。

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

重新实现：QAbstractItemView::timerEvent(QTimerEvent *event)

[override virtual protected] void QTableView::updateGeometries()

重新实现：QAbstractItemView::updateGeometries

QHeaderView *QTableView::verticalHeader() const

返回表格视图的垂直表头。

另请参阅setVerticalHeader，horizontalHeader和QAbstractItemModel::headerData

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

重新实现：QAbstractItemView::verticalOffset() const

返回表格视图中项的垂直偏移量。

注意，表格视图使用垂直表头部分的定位来确定视图中行的位置。

另请参阅horizontalOffset

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

重新实现：QAbstractItemView::viewportSizeHint() const

[override virtual] QRect QTableView::visualRect(const QModelIndex &index) const

重新实现：QAbstractItemView::visualRect(const QModelIndex &index) const

返回由给定index占用的视口矩形。如果索引在视图中隐藏，则返回一个空QRect。

[override virtual protected] QRegion QTableView::visualRegionForSelection(const QItemSelection &selection) const

重新实现：QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const

返回给定selection中项的视口矩形。

自4.7以来，返回的区域仅包含与视口相交（或包含）的矩形。