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 中选中了任何具有给定parent 的项，则返回true 。

[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 中所有项目均被选中（且符合给定的parent ），则返回true 。

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

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

如果row 中所有项目均被选中（且满足给定的parent 条件），则返回true 。

请注意，此函数通常比对同一行中的所有项目分别调用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 中存在任何符合给定parent 的已选项，则返回true 。

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

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QItemSelection &selection, QItemSelectionModel::SelectionFlags command) { receiver->select(selection, command); });

另请参阅 QItemSelectionModel::SelectionFlag 。

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

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        itemSelectionModel, qOverload(&QItemSelectionModel::select));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        itemSelectionModel, [receiver = itemSelectionModel](const QModelIndex &index, QItemSelectionModel::SelectionFlags command) { receiver->select(index, command); });

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