PyQt5 QItemSelection类使用小结_C/C++

qitemselection 是 pyqt5 模型/视图框架中用于管理多个项目选择范围的类，常用于处理用户在多选操作（如表格、列表的多选）中的选中状态。它通过存储多个 qitemselectionrange 对象来记录复杂的选择区域，支持跨行、跨列或任意单元格组合的选择。

核心功能

多范围选择：支持存储多个独立的选择区域（如非连续选中的行或单元格）。
索引操作：合并、拆分或查询选择范围。
与模型交互：与 qitemselectionmodel 配合，管理视图组件的选中状态。

常用方法

方法	说明	返回值
append(range: qitemselectionrange)	添加一个选择范围到当前选中区域	none
merge(other: qitemselection)	合并另一个 qitemselection 到当前实例	none
split(range: qitemselectionrange)	将指定范围拆分成更小的范围	qitemselection
contains(index: qmodelindex)	判断某个索引是否在选中范围内	bool
count()	返回选中范围的数量	int
clear()	清空所有选择范围	none

关键代码示例

1. 创建并操作选择范围

from pyqt5.qtcore import qitemselection, qitemselectionrange, qmodelindex

# 假设存在模型索引 index1 和 index2（如表格中的单元格）
index1 = qmodelindex()  # 实际使用时需从模型获取有效索引
index2 = qmodelindex()  # 例如: model.index(0, 0), model.index(2, 2)

# 创建选择范围（从 index1 到 index2 的矩形区域）
range1 = qitemselectionrange(index1, index2)

# 初始化 qitemselection 并添加范围
selection = qitemselection()
selection.append(range1)

# 检查索引是否被选中
print("是否包含 index1:", selection.contains(index1))  # true

2. 合并两个选择区域

# 创建另一个选择范围
range2 = qitemselectionrange(model.index(3, 0), model.index(3, 2))
selection2 = qitemselection()
selection2.append(range2)

# 合并到第一个选择区域
selection.merge(selection2)
print("合并后的范围数量:", selection.count())  # 2

与 qitemselectionmodel 结合使用

qitemselectionmodel 是管理视图（如 qtableview）中选中状态的核心类。通过信号 selectionchanged 可以捕获用户的选中操作。

from pyqt5.qtwidgets import qtableview, qapplication
from pyqt5.qtcore import qitemselectionmodel

class mytableview(qtableview):
    def __init__(self):
        super().__init__()
        # 初始化模型（假设已设置）
        self.setmodel(...)
        
        # 获取选择模型并连接信号
        self.selectionmodel().selectionchanged.connect(self.handle_selection)

    def handle_selection(self, selected: qitemselection, deselected: qitemselection):
        # 处理新增选中区域
        for range in selected:
            top_left = range.topleft()
            bottom_right = range.bottomright()
            print(f"选中范围: 行 {top_left.row()}-{bottom_right.row()}, 列 {top_left.column()}-{bottom_right.column()}")

app = qapplication([])
window = mytableview()
window.show()
app.exec_()