QTableView Class

成员函数文档

[explicit] QTableView::QTableView(QWidget *parent = nullptr)

用parent 构建表视图来表示数据。

另请参阅 QAbstractItemModel 。

[virtual noexcept] QTableView::~QTableView()

销毁表格视图。

void QTableView::clearSpans()

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

另请参阅 setSpan()。

int QTableView::columnAt(int x) const

返回内容坐标中给定 x 坐标x 所在的列。

另请参见 rowAt()。

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

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

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

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

另请参见 rowMoved()。

[protected slot] 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()。

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

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

[override virtual protected] void QTableView::dropEvent(QDropEvent *event)

重实现：QAbstractItemView::dropEvent(QDropEvent *event).

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

隐藏给定的column 。

另请参见 showColumn() 和hideRow()。

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

隐藏给定的row 。

另请参见 showRow() 和hideColumn()。

QHeaderView *QTableView::horizontalHeader() const

返回表格视图的水平标题。

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

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

重实现：QAbstractItemView::horizontalOffset() 常量。

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

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

另请参阅 verticalOffset()。

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

重实现：QAbstractItemView::indexAt(const QPoint &point) 常量。

返回与pos 位置的表项相对应的模型项的索引位置（以 contents 坐标表示）。

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

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

bool QTableView::isColumnHidden(int column) const

如果给定的column 是隐藏的，则返回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

如果给定的row 是隐藏的，则返回true ；否则返回false 。

另请参阅 isColumnHidden() 。

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

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

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

另请参阅 QAbstractItemView::CursorAction 。

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

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

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

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

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

另请参阅 resizeColumnsToContents()、sizeHintForColumn() 和QHeaderView::resizeContentsPrecision()。

[slot] void QTableView::resizeColumnsToContents()

根据用于呈现列中每个项目的委托的大小提示调整所有列的大小。

另请参阅 resizeColumnToContents()、sizeHintForColumn() 和QHeaderView::resizeContentsPrecision()。

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

根据用于呈现行中每个项目的委托的大小提示，调整给定row 的大小。

另请参阅 resizeRowsToContents()、sizeHintForRow() 和QHeaderView::resizeContentsPrecision()。

[slot] void QTableView::resizeRowsToContents()

根据用于呈现行中每个项目的委托的大小提示调整所有行的大小。

另请参阅 resizeRowToContents()、sizeHintForRow() 和QHeaderView::resizeContentsPrecision()。

int QTableView::rowAt(int y) const

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

另请参见 columnAt()。

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

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

int QTableView::rowHeight(int row) const

返回给定row 的高度。

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

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

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

另请参见 columnMoved()。

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

调用此槽可更改给定row 的高度。旧高度由oldHeight 指定，新高度由newHeight 指定。

另请参见 columnResized()。

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

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

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

int QTableView::rowViewportPosition(int row) const

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

[override virtual protected] void QTableView::scrollContentsBy(int dx, int dy)

重实现：QAbstractScrollArea::scrollContentsBy(int dx, int dy）。

通过 (dx,dy) 滚动表格视图的内容。

[override virtual] void QTableView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

重实现：QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)。

确保给定的index 在表格视图中可见，必要时滚动显示。

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

如果当前的选择模式（SelectionMode）和选择行为（SelectionBehavior）允许选择列，则在表格视图中选择给定的column 。

另请参阅 selectRow()。

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

如果当前的选择模式（SelectionMode）和选择行为（SelectionBehavior）允许选择行，则在表格视图中选择给定的row 。

另请参阅 selectColumn()。

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

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

[override virtual protected] 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)

将用于水平标题的 widget 设置为header 。

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

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

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

[override virtual] 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()。

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

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

根据指定的选择flags ，在给定的rect 范围内选择项目。

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

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

void QTableView::setSortingEnabled(bool enable)

如果enable 为 true，则启用表格排序，并立即使用当前排序段和顺序触发对sortByColumn() 的调用。

另请参阅 isSortingEnabled() 。

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

将 (row,column) 处表格元素的跨度设置为 (rowSpanCount,columnSpanCount) 指定的行数和列数。

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

void QTableView::setVerticalHeader(QHeaderView *header)

将用于垂直标题的 widget 设置为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 和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() 常量。

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

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

另请参阅 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) 常量。

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

自 4.7 版起，返回的区域只包含与视口相交（或包含在视口中）的矩形。