QItemSelectionModel Class

成员函数文档

[explicit] QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model = nullptr)

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

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

构建一个选择模型，在指定的项目model 上运行parent 。

[virtual noexcept] QItemSelectionModel::~QItemSelectionModel()

破坏选择模型。

[virtual slot] void QItemSelectionModel::clear()

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

[virtual slot] void QItemSelectionModel::clearCurrentIndex()

清除当前索引。发出currentChanged().

[slot] void QItemSelectionModel::clearSelection()

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

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

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

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

每当当前项目发生变化时，就会发出该信号。previous 模型的项目索引将被current 索引取代，成为选择的当前项目。

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

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

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

如果current 项目发生变化，且其列与previous 当前项目的列不同，则会发出此信号。

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

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

QModelIndex QItemSelectionModel::currentIndex() const

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

另请参见 setCurrentIndex()。

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

如果current 项目发生变化，且其行与previous 当前项目的行不同，则会发出此信号。

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

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

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

比较newSelection 和oldSelection 这两个选择项，并将取消选择和选择的项目发送到selectionChanged() 中。

bool QItemSelectionModel::hasSelection() const

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

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

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

请注意，该函数通常比对同一列中的所有项目调用isSelected() 更快，而且不可选项目将被忽略。

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

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

请注意，该函数通常比对同一行中的所有项目调用isSelected() 更快，而且不可选项目将被忽略。

[invokable] bool QItemSelectionModel::isSelected(const QModelIndex &index) const

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

QAbstractItemModel *QItemSelectionModel::model()

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

另请参阅 setModel()。

const QAbstractItemModel *QItemSelectionModel::model() const

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

[signal] void QItemSelectionModel::modelChanged(QAbstractItemModel *model)

使用setModel() 成功设置model 时，会发出该信号。

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

[virtual slot] void QItemSelectionModel::reset()

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

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

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

[virtual slot] void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)

使用指定的command 选择项目selection ，并发出selectionChanged() 。

另请参阅 QItemSelectionModel::SelectionFlag 。

[virtual slot] void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

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

另请参阅 QItemSelectionModel::SelectionFlags 。

[invokable] QModelIndexList QItemSelectionModel::selectedColumns(int row = 0) const

返回row 中所有行都被选中的列的索引。

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

QModelIndexList QItemSelectionModel::selectedIndexes() const

返回所有选定模型项索引的列表。该列表不包含重复内容，也不排序。

[invokable] QModelIndexList QItemSelectionModel::selectedRows(int column = 0) const

返回column 中所有列均被选中的行的索引。

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

const QItemSelection QItemSelectionModel::selection() const

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

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

每当选择项发生变化时，就会发出该信号。选中项的变化表现为deselected 项的选中项和selected 项的选中项。

请注意，当前索引的变化与选区无关。还要注意的是，重置项目模型时不会发出该信号。

保持选中状态但索引发生变化的项目不包括在selected 和deselected 中。因此，如果只有选中项的索引发生变化，在selected 和deselected 都为空的情况下，此信号可能会被发出。

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

[virtual slot] void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)

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

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

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

void QItemSelectionModel::setModel(QAbstractItemModel *model)

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

另请参阅 model() 和modelChanged()。