QItemSelection Class
QItemSelection 类管理有关模型中选定项的信息。更多
| Header： | #include <QItemSelection> |
| CMake.QItemSelection 类 | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
| 继承： | QList |
公共函数
| QItemSelection() | |
| QItemSelection(const QModelIndex &topLeft, const QModelIndex &bottomRight) | |
| bool | contains(const QModelIndex &index) const |
| QModelIndexList | indexes() const |
| void | merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command) |
| void | select(const QModelIndex &topLeft, const QModelIndex &bottomRight) |
静态公共成员
| void | split(const QItemSelectionRange &range, const QItemSelectionRange &other, QItemSelection *result) |
详细描述
QItemSelection 描述了模型中被用户选中的项目。QItemSelection 基本上是一个选择范围列表，请参见QItemSelectionRange 。它提供了用于创建和操作选择以及从模型中选择项目范围的函数。
QItemSelection 类是模型/视图类之一，是 Qt模型/视图框架的一部分。
一个项目选择可以被构造和初始化，以包含现有模型中的一系列项目。topLeft下面的示例构建了一个选择项，它包含了从给定的model 开始，到bottomRight 结束的一系列项目。
QItemSelection *selection = new QItemSelection(topLeft, bottomRight);
可以构建一个空的项目选择，然后根据需要进行填充。因此，如果在构建项目选择时模型不可用，我们可以按以下方式重写上述代码：
QItemSelection *selection = new QItemSelection(); ... selection->select(topLeft, bottomRight);
QItemSelection 通过处理选择范围而不是为选择中的每个项目记录模型项目索引来节省内存和避免不必要的工作。一般来说，该类的实例将包含一个非重叠选择范围的列表。
使用merge() 可以将一个项目选择合并到另一个项目选择中，而不会产生重叠范围。使用split() 可以根据另一个选择范围将一个选择范围分割成更小的范围。
另请参阅 模型/视图编程和QItemSelectionModel 。
成员函数文档
[noexcept default] QItemSelection::QItemSelection()
构造一个空选区。
QItemSelection::QItemSelection(const QModelIndex &topLeft, const QModelIndex &bottomRight)
构建一个项目选择，从topLeft 索引指定的左上方模型项目延伸到bottomRight 指定的右下方项目。
bool QItemSelection::contains(const QModelIndex &index) const
如果选择包含给定的index ，则返回true ；否则返回false 。
QModelIndexList QItemSelection::indexes() const
返回与所选项目相对应的模型索引列表。
void QItemSelection::merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command)
使用给定的command 将other 选区与此QItemSelection 选区合并。此方法可确保没有范围重叠。
请注意，只支持QItemSelectionModel::Select 、QItemSelectionModel::Deselect 和QItemSelectionModel::Toggle 。
另请参阅 split().
void QItemSelection::select(const QModelIndex &topLeft, const QModelIndex &bottomRight)
将从topLeft 索引指定的左上角模型项到bottomRight 指定的右下角项的范围内的项目添加到列表中。
注意： topLeft 和bottomRight 的父节点必须相同。
[static] void QItemSelection::split(const QItemSelectionRange &range, const QItemSelectionRange &other, QItemSelection *result)
使用other 范围分割range 中的选择项。从range 中删除other 中的所有项目，并将结果放入result 。这可以与集合的减法操作的语义进行比较。
另请参阅 merge() 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
