QItemSelectionModel 类

成员函数文档

[显式] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = nullptr)

构建一个操作指定项目 model 的选择模型。

[显式] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)

构建一个操作指定项目 model 的选择模型，并带有 parent。

[虚函数 noexcept] QItemSelectionModel::~QItemSelectionModel()

销毁选择模型。

[虚槽] void QItemSelectionModel::clear()

清除选择模型。触发 selectionChanged() 和 currentChanged()。

[虚槽] void QItemSelectionModel::clearCurrentIndex()

清除当前索引。触发 currentChanged()。

[槽] void QItemSelectionModel::clearSelection()

清除选择模型中的选择。触发 selectionChanged()。

[可调用] bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent = QModelIndex()) const

如果在给定 parent 的 column 中有选择的项目，则返回 true。

[信号] void QItemSelectionModel::currentChanged(const QModelIndex &current, const QModelIndex &previous)

此信号在当前项更改时发出。原来的模型项索引由 current 索引替换，成为选择项的当前项。

请注意，当项目模型重置时，此信号不会被发出。

另请参阅currentIndex()，setCurrentIndex() 和 selectionChanged()。

[信号] void QItemSelectionModel::currentColumnChanged(const QModelIndex &current, const QModelIndex &previous)

如果当前项更改且其列与旧当前项的列不同，则发出此信号。

请注意，当项目模型重置时，此信号不会被发出。

另请参阅currentChanged()，currentRowChanged()，currentIndex() 和 setCurrentIndex()。

QModelIndex QItemSelectionModel::currentIndex() const

返回当前项的模型项索引，如果没有当前项则返回无效索引。

另请参阅setCurrentIndex()。

[信号] void QItemSelectionModel::currentRowChanged(const QModelIndex &current, const QModelIndex &previous)

如果当前项改变且其行与上一当前项的行不同，则发出此信号。

请注意，当项目模型重置时，此信号不会被发出。

另请参阅currentChanged()，currentColumnChanged()，currentIndex() 和 setCurrentIndex()。

[保护] void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection, const QItemSelection &oldSelection)

比较两个选择 newSelection 和 oldSelection，并使用已取消选择和选择的项目发出 selectionChanged()。

bool QItemSelectionModel::hasSelection() const

如果选择模型包含任何选定的项，则返回 true，否则返回 false。

[可调用] bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent = QModelIndex()) const

如果给定 parent 的 column 中所有项都被选中，则返回 true。

请注意，此函数通常比在相同列的所有项上调用 isSelected() 更快，且不可选项目被忽略。

[可调用] bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent = QModelIndex()) const

如果给定 parent 的 row 中的所有项目都被选中，则返回 true。

请注意，此函数通常比在相同行的所有项上调用 isSelected() 更快，且不可选项目被忽略。

[可调用] bool QItemSelectionModel::isSelected(const QModelIndex &index) const

如果给定的模型项 index 被选中，则返回 true。

const QAbstractItemModel *QItemSelectionModel::model() const

返回由选择模型操作的项目模型。

另请参阅 setModel().

QAbstractItemModel *QItemSelectionModel::model()

返回由选择模型操作的项目模型。

[信号] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

设置模型成功时发出此信号，使用 setModel。

另请参阅 model() 和 setModel().

[虚拟槽] void QItemSelectionModel::reset()

清除选择模型。不发出任何信号。

[虚拟槽] bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent = QModelIndex()) const

如果给定 parent 的 row 中有任何选中的项，则返回 true。

[虚拟槽] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

使用指定的 command 选中模型项 index，并发出 selectionChanged。

另请参阅 QItemSelectionModel::SelectionFlags.

[虚拟槽] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

使用指定的 command 选中项 selection，并发出 selectionChanged。

另请参阅QItemSelectionModel::SelectionFlag.

[可调用的] QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

返回给定行中所有行都选中的列的索引。

另请参阅selectedIndexes() 和 selectedRows().

QModelIndexList QItemSelectionModel::selectedIndexes() const

返回所有选中模型项索引的列表。列表中不含重复项，且未排序。

[可调用的] QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

返回给定列中所有列都选中的行的索引。

另请参阅selectedIndexes() 和 selectedColumns().

const QItemSelection QItemSelectionModel::selection() const

返回存储在选定模型中的选定范围。

[信号] void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

该信号在selection更改时发出。更改的selection被表示为选中的items和未选中的items的项目选择。

请注意当前index更改与选择独立。还请注意，当item模型被重置时，该信号不会发出。

那些保持选中但更改其index的项目不包含在< i translate="no">selected和deselected中。因此，在只有选中项目的索引发生更改的情况下，可能会同时发出包含空< i translate="no">selected和< i translate="no">deselected的信号。

另请参阅select() 和 currentChanged().

[虚拟槽] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

设置模型项index为当前项，并发出currentChanged(). 当前项目用于键盘导航和焦点指示；它与任何选定的项无关，即使选定的项也可以是当前项。

根据指定的command，index也可成为当前选择的一部分。

另请参阅currentIndex() 和 select().

void QItemSelectionModel::setModel(QAbstractItemModel *model)

将模型设置为model。将发出modelChanged()信号。

另请参阅 model() 和 modelChanged。