QAbstractItemView Class

成员函数文档

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

使用给定的parent 构建抽象项目视图。

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

破坏景观。

[signal] void QAbstractItemView::activated(const QModelIndex &index)

当index 指定的项目被用户激活时，就会发出该信号。如何激活项目取决于平台；例如，单击或双击项目，或在项目处于当前状态时按 Return 或 Enter 键。

另请参阅 clicked()、doubleClicked()、entered() 和pressed()。

[slot] void QAbstractItemView::clearSelection()

取消选择所有选定项目。当前索引不会改变。

另请参阅 setSelection() 和selectAll()。

[signal] void QAbstractItemView::clicked(const QModelIndex &index)

当鼠标左键被点击时发出该信号。鼠标点击的项目由index 指定。该信号仅在索引有效时发出。

另请参阅 activated()、doubleClicked()、entered() 和pressed()。

[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)

关闭给定的editor ，并将其释放。hint 用于指定视图应如何响应编辑操作的结束。例如，该提示可能表示应打开视图中的下一个项目进行编辑。

另请参阅 edit() 和commitData() 。

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

关闭给定index 上项目的持久编辑器。

另请参阅 openPersistentEditor() 和isPersistentEditorOpen()。

[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)

将editor 中的数据提交给模型。

另请参见 closeEditor().

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

当一个新项目成为当前项目时，该槽会被调用。前一个当前项目由previous 索引指定，新项目由current 索引指定。

如果您想了解项目的变化，请参阅dataChanged() 信号。

QModelIndex QAbstractItemView::currentIndex() const

返回当前项目的模型索引。

另请参阅 setCurrentIndex()。

[virtual protected slot] void QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

当模型中带有给定roles 的项目发生变化时，将调用此槽。更改的项目是从topLeft 到bottomRight （包括 ）的项目。如果只有一个项目发生变化，topLeft ==bottomRight 。

已更改的roles 可以是一个空容器（表示所有内容都已更改），也可以是一个包含已更改角色子集的非空容器。

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

返回视图中脏污区域的偏移量。

如果您使用scrollDirtyRegion() 并在QAbstractItemView 的子类中实现了paintEvent() ，则应使用此函数返回的偏移量来平移绘制事件给出的区域。

另请参阅 scrollDirtyRegion() 和setDirtyRegion()。

[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)

双击鼠标按钮时发出该信号。鼠标被双击的项目由index 指定。该信号仅在索引有效时发出。

另请参阅 clicked() 和activated()。

[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)

重实现：QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)。

当拖放操作进入 widget 时，该函数将被调用，调用时给定event 。如果拖动是在一个有效的拖放位置（例如在一个可接受拖放的项目上），则接受该事件；否则将忽略该事件。

另请参阅 dropEvent() 和startDrag()。

[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)

重实现：QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)。

当被拖动的项目离开视图时，该函数将被调用。event 描述了拖放操作的状态。

[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)

重实现：QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)。

在对窗口小部件进行拖放操作时，该函数会以给定的event 连续调用。例如，如果用户将一个选区拖到视图的右边或底边，它就会导致视图滚动。在这种情况下，事件将被接受，否则将被忽略。

另请参阅 dropEvent() 和startDrag()。

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

重实现：QAbstractScrollArea::dropEvent(QDropEvent *event)。

当窗口小部件上发生下拉事件时，该函数会以给定的event 调用。如果模型接受偶数位置，则滴落事件会被接受；否则会被忽略。

另请参阅 startDrag().

[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const

返回下拉指示符相对于最近项目的位置。

[slot] void QAbstractItemView::edit(const QModelIndex &index)

开始编辑与给定index 对应的项目（如果该项目可编辑）。

请注意，此函数不会更改当前索引。由于当前索引定义了下一个和上一个要编辑的项目，因此用户可能会发现键盘导航无法按预期工作。为提供一致的导航行为，请在此函数之前调用setCurrentIndex() 并使用相同的模型索引。

另请参见 QModelIndex::flags()。

[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)

开始编辑index 上的项目，必要时创建一个编辑器，如果视图的State 现在是EditingState ，则返回true ；否则返回false 。

导致编辑过程的操作由trigger 描述，相关事件由event 指定。

可以通过指定trigger 为QAbstractItemView::AllEditTriggers 来强制编辑。

另请参阅 closeEditor() 。

[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)

当给定的editor 被销毁时，该函数将被调用。

另请参见 closeEditor()。

[signal] void QAbstractItemView::entered(const QModelIndex &index)

当鼠标光标进入index 指定的项目时，将发出该信号。需要启用鼠标跟踪功能才能使用此功能。

另请参阅 viewportEntered(),activated(),clicked(),doubleClicked() 和pressed().

[override virtual protected] bool QAbstractItemView::event(QEvent *event)

重实现：QAbstractScrollArea::event(QEvent *event).

[override virtual protected] bool QAbstractItemView::eventFilter(QObject *object, QEvent *event)

重实现：QObject::eventFilter(QObject *watched, QEvent *event).

[protected] void QAbstractItemView::executeDelayedItemsLayout()

不等待事件处理开始就执行计划布局。

另请参阅 scheduleDelayedItemsLayout()。

[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)

重实现：QWidget::focusInEvent(QFocusEvent *event)。

当窗口小部件获得焦点时，使用给定的event 调用该函数。默认情况下，该事件被忽略。

另请参阅 setFocus() 和focusOutEvent() 。

[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)

重实现：QWidget::focusNextPrevChild(bool next）。

[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)

重实现：QWidget::focusOutEvent(QFocusEvent *event)。

当窗口小部件失去焦点时，该函数将调用给定的event 。默认情况下，该事件被忽略。

另请参阅 clearFocus() 和focusInEvent() 。

[pure virtual protected] int QAbstractItemView::horizontalOffset() const

返回视图的水平偏移量。

在基类中，这是一个纯虚函数。

另请参见 verticalOffset()。

[pure virtual] QModelIndex QAbstractItemView::indexAt(const QPoint &point) const

返回视口坐标point 处项目的模型索引。

在基类中，这是一个纯虚函数。

另请参见 visualRect()。

QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const

返回位于给定index 的项目的 widget。

另请参阅 setIndexWidget() 。

[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const

使用视图的调色板、字体、状态、对齐方式等初始化option 结构。

此函数在 Qt 6.0 中引入。

[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)

重实现：QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const

重实现：QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

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

如果给定的index 所指向的项目在视图中隐藏，则返回true ，否则返回false 。

隐藏是视图的特定功能。例如，在TableView 中，一列可以被标记为隐藏，在TreeView 中，一行也可以被标记为隐藏。

在基类中，这是一个纯虚函数。

bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

返回位于索引index 的项目是否已打开持久编辑器。

另请参阅 openPersistentEditor() 和closePersistentEditor()。

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

返回此视图和模型使用的项目委托。它可以是setItemDelegate() 设置的委托，也可以是默认委托。

另请参阅 setItemDelegate()。

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

返回此视图和模型在给定column 时使用的项目委托。您可以调用itemDelegate() 获取指向给定索引的当前委托的指针。

另请参阅 setItemDelegateForColumn()、itemDelegateForRow() 和itemDelegate()。

[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const

返回该视图和模型用于给定index 的项目委托。

此函数在 Qt 6.0 中引入。

另请参阅 setItemDelegate()、setItemDelegateForRow() 和setItemDelegateForColumn()。

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

返回该视图和模型用于给定row 的项目委托，如果没有分配委托，则返回nullptr 。您可以调用itemDelegate() 获取指向给定索引的当前委托的指针。

另请参阅 setItemDelegateForRow()、itemDelegateForColumn() 和setItemDelegate()。

[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)

重实现：QAbstractScrollArea::keyPressEvent(QKeyEvent *e)。

当有按键事件发送到 widget 时，该函数会以给定的event 调用。默认实现处理基本的光标移动，例如上、下、左、右、主页、PageUp 和 PageDown；如果当前索引有效且激活键被按下（例如 Enter 或 Return，取决于平台），则会发出activated() 信号。该功能用于通过按键启动编辑，例如按下 F2。

另请参见 edit()、moveCursor()、keyboardSearch() 和tabKeyNavigation 。

[virtual] void QAbstractItemView::keyboardSearch(const QString &search)

移动并选择与字符串search 最匹配的项目。如果没有找到项目，则不会发生任何操作。

在默认实现中，如果search 为空，或上次搜索后的时间间隔超过QApplication::keyboardInputInterval() ，则重置搜索。

QAbstractItemModel *QAbstractItemView::model() const

返回此视图显示的模型。

另请参阅 setModel()。

[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)

重实现：QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)。

当鼠标按键在 widget 内被双击时，该函数会以给定的event 调用。如果双击的是一个有效的项目，它将发出doubleClicked() 信号，并调用edit() 来处理该项目。

[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)

重实现：QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)。

当鼠标移动事件发送到 widget 时，该函数会以给定的event 调用。如果选择正在进行，且有新项目移过，则会扩展选择；如果拖动正在进行，则会继续拖动。

[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)

重实现：QAbstractScrollArea::mousePressEvent(QMouseEvent *e)。

当光标在 widget 内按下鼠标键时，该函数会以给定的event 调用。如果一个有效的项目被按下，它将成为当前项目。该函数将发出pressed() 信号。

[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)

重实现：QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)。

在部件上发生鼠标按下事件后，当鼠标按钮被释放时，该函数会以给定的event 调用。如果用户在您的 widget 中按下鼠标，然后在释放鼠标键之前将鼠标拖到另一个位置，您的 widget 就会收到释放事件。如果有项目被按下，该函数将发出clicked() 信号。

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

根据给定的cursorAction 和modifiers 指定的键盘修改器，返回指向视图中下一个对象的QModelIndex 对象。

在基类中，这是一个纯虚函数。

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

在给定的index 上打开项目的持久编辑器。如果不存在编辑器，代理将创建一个新的编辑器。

另请参阅 closePersistentEditor() 和isPersistentEditorOpen()。

[signal] void QAbstractItemView::pressed(const QModelIndex &index)

当鼠标按键被按下时会发出该信号。鼠标按下的项目由index 指定。只有索引有效时才会发出该信号。

使用QGuiApplication::mouseButtons() 函数可获取鼠标按钮的状态。

另请参阅 activated()、clicked()、doubleClicked() 和entered()。

[virtual slot] void QAbstractItemView::reset()

重置视图的内部状态。

[override virtual protected] void QAbstractItemView::resizeEvent(QResizeEvent *event)

重实现：QAbstractScrollArea::resizeEvent(QResizeEvent *event)。

当有调整大小事件发送到 widget 时，该函数会以给定的event 调用。

另请参见 QWidget::resizeEvent().

QModelIndex QAbstractItemView::rootIndex() const

返回模型根项的模型索引。根项目是视图顶层项目的父项目。根项目可以是无效的。

另请参阅 setRootIndex()。

[virtual protected slot] void QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

当记录即将被删除时，会调用此槽。删除的记录是给定的parent 下从start 到end （含）的那些记录。

另请参见 rowsInserted()。

[virtual protected slot] void QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)

插入记录时会调用此槽。新插入的记录是给定的parent 下的记录，从start 到end （含）。基类实现会调用模型上的 fetchMore() 来检查更多数据。

另请参见 rowsAboutToBeRemoved()。

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

计划在事件处理开始时执行视图中的项目布局。

即使在事件处理之前多次调用 scheduleDelayedItemsLayout()，视图也只会进行一次布局。

另请参阅 executeDelayedItemsLayout()。

[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)

通过向相反方向移动脏污区域，为视图滚动 (dx,dy) 像素做好准备。只有在视图子类中实现滚动视口时，才需要调用此函数。

如果您在QAbstractItemView 的子类中实现了scrollContentsBy() ，请在视口上调用QWidget::scroll() 之前调用此函数。或者，只需调用update() 即可。

另请参阅 scrollContentsBy()、dirtyRegionOffset() 和setDirtyRegion()。

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

必要时滚动视图，以确保index 上的项目可见。视图将尝试根据给定的hint 定位项目。

在基类中，这是一个纯虚函数。

[slot] void QAbstractItemView::scrollToBottom()

将视图滚动到底部。

另请参阅 scrollTo() 和scrollToTop()。

[slot] void QAbstractItemView::scrollToTop()

将视图滚动到顶部。

另请参阅 scrollTo() 和scrollToBottom()。

[virtual slot] void QAbstractItemView::selectAll()

选择视图中的所有项目。选择时，该函数将使用视图中设置的选择行为。

另请参阅 setSelection()、selectedIndexes() 和clearSelection()。

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

此便捷函数返回视图中所有选中和非隐藏项目索引的列表。该列表不包含重复内容，也不排序。

另请参阅 QItemSelectionModel::selectedIndexes()。

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

当选择项发生变化时，会调用该槽。之前的选择（可能为空）由deselected 指定，新的选择由selected 指定。

另请参阅 setSelection() 。

[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const

返回更新指定index 的选择模型时使用的 SelectionFlags。结果取决于当前的selectionMode() 和用户输入事件event ，后者可以是nullptr 。

重新实现此函数可定义您自己的选择行为。

另请参阅 setSelection()。

QItemSelectionModel *QAbstractItemView::selectionModel() const

返回当前的选择模型。

另请参阅 setSelectionModel() 和selectedIndexes()。

[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)

将当前项目设置为index 中的项目。

除非当前选择模式为NoSelection ，否则该项目也会被选中。请注意，此函数也会更新用户执行任何新选择时的起始位置。

要将一个项目设置为当前项目而不选择它，请调用

selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);

另请参阅 currentIndex(),currentChanged() 和selectionMode 。

[protected] void QAbstractItemView::setDirtyRegion(const QRegion &region)

将给定的region 标记为 dirty，并安排更新时间。只有在实现自己的视图子类时才需要调用此函数。

另请参阅 scrollDirtyRegion() 和dirtyRegionOffset()。

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

在index 的项目上设置给定的widget ，并将 widget 的所有权传递给视口。

如果index 无效（例如，如果您传递的是根索引），此函数将不起作用。

给定的widget 的autoFillBackground 属性必须设置为 true，否则 widget 的背景将是透明的，同时显示模型数据和位于给定index 的项目。

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

该函数只能用于在与数据项相对应的可见区域内显示静态内容。如果您想显示自定义动态内容或实现自定义编辑器部件，请子类QStyledItemDelegate 。

另请参阅 indexWidget() 和委托类。

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

将此视图及其模型的项目委托设置为delegate 。如果您想完全控制项目的编辑和显示，这将非常有用。

QAbstractItemView 不会占用delegate 的所有权。

另请参阅 itemDelegate()。

void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)

设置该视图和模型使用的给定项目delegate ，用于给定的column 。column 上的所有项目都将由delegate 绘制和管理，而不是使用默认委托（即itemDelegate() ）。

column QAbstractItemView 不拥有 的所有权。delegate

另请参阅 itemDelegateForColumn()、setItemDelegateForRow() 和itemDelegate()。

void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)

设置该视图和模型使用的给定项目delegate ，用于给定的row 。row 上的所有项目都将由delegate 绘制和管理，而不是使用默认委托（即itemDelegate() ）。

row QAbstractItemView 不拥有 的所有权。delegate

另请参阅 itemDelegateForRow()、setItemDelegateForColumn() 和itemDelegate()。

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

为视图设置model 。

此函数将创建并设置一个新的选择模型，替换之前使用setSelectionModel() 设置的任何模型。但是，旧的选择模型不会被删除，因为它可能被多个视图共享。如果不再需要旧的选择模型，我们建议您将其删除。具体方法如下：

QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;

如果旧模型和旧选择模型都没有父对象，或者它们的父对象是长寿命对象，那么最好调用它们的deleteLater() 函数显式删除它们。

除非视图是模型的父对象，否则视图不会获得模型的所有权，因为模型可能在许多不同的视图之间共享。

另请参阅 model()、selectionModel() 和setSelectionModel()。

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

将根项目设置为位于给定index 的项目。

另请参阅 rootIndex() 。

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

将选择flags 应用于矩形中或与矩形接触的项目，rect 。

在实现自己的 itemview setSelection 时，应调用selectionModel()->select(selection, flags)，其中 selection 可以是空的QModelIndex ，也可以是包含rect 中所有项目的QItemSelection 。

另请参见 selectionCommand() 和selectedIndexes()。

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

将当前选择模型设置为给定的selectionModel 。

请注意，如果在此函数后调用setModel() ，给定的selectionModel 将被视图创建的选择模型取代。

另请参见 selectionModel()、setModel() 和clearSelection()。

[protected] void QAbstractItemView::setState(QAbstractItemView::State state)

将项目视图的状态设置为给定的state 。

另请参阅 state() 。

[virtual] int QAbstractItemView::sizeHintForColumn(int column) const

返回指定column 的宽度尺寸提示，如果没有模型，则返回-1。

该函数用于带有水平标题的视图，根据给定的column 内容查找标题部分的尺寸提示。

另请参阅 sizeHintForRow()。

QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const

返回具有指定index 的项的大小提示，如果索引无效，则返回无效大小。

另请参阅 sizeHintForRow() 和sizeHintForColumn()。

[virtual] int QAbstractItemView::sizeHintForRow(int row) const

返回指定row 的高度尺寸提示，如果没有模型，则返回-1。

返回的高度是使用给定row'项的尺寸提示计算得出的，也就是说，返回值是各项中的最大高度。请注意，要控制行的高度，必须重新实现QAbstractItemDelegate::sizeHint() 函数。

该函数用于带有垂直标题的视图，根据给定的row 内容查找标题部分的尺寸提示。

另请参阅 sizeHintForColumn()。

[virtual protected] void QAbstractItemView::startDrag(Qt::DropActions supportedActions)

使用给定的supportedActions 调用 drag->exec()，开始拖动。

[protected] QAbstractItemView::State QAbstractItemView::state() const

返回项目视图的状态。

另请参阅 setState()。

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

重实现：QObject::timerEvent(QTimerEvent *event)。

当定时器事件发送到 widget 时，使用给定的event 调用该函数。

另请参阅 QObject::timerEvent().

[slot] void QAbstractItemView::update(const QModelIndex &index)

更新给定index 所占的区域。

[virtual protected slot] void QAbstractItemView::updateGeometries()

更新视图子部件的几何图形。

[pure virtual protected] int QAbstractItemView::verticalOffset() const

返回视图的垂直偏移量。

在基类中，这是一个纯虚函数。

另请参见 horizontalOffset()。

[signal] void QAbstractItemView::viewportEntered()

当鼠标光标进入视口时会发出该信号。需要启用鼠标跟踪功能才能使用此功能。

另请参阅 entered().

[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)

重实现：QAbstractScrollArea::viewportEvent(QEvent *event)。

如果给定的event 是QEvent::ToolTip 或QEvent::WhatsThis ，该函数用于处理工具提示和 "这是什么？"模式。它将所有其他事件传递给基类 viewportEvent() 处理程序。

如果event 已被识别并处理，则返回true ；否则，返回false 。

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

重实现：QAbstractScrollArea::viewportSizeHint() const.

[pure virtual] QRect QAbstractItemView::visualRect(const QModelIndex &index) const

返回位于index 的项目在视口中所占的矩形区域。

如果项目显示在多个区域中，那么 visualRect 应返回包含索引的主要区域，而不是索引可能包含、触碰或导致绘制的整个区域。

在基类中，这是一个纯虚函数。

另请参阅 indexAt() 和visualRegionForSelection()。

[pure virtual protected] QRegion QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const

返回selection 中项的视口区域。

在基类中，这是一个纯虚函数。

另请参阅 visualRect() 和selectedIndexes()。