在QTableWidget对项的操作支持选中多个项的情况下,可以通过方法selectedRanges返回选中矩形的列表,通过方法setRangeSelected将指定矩形范围的项选中或去选中。相关方法调用语法如下:
- list[QTableWidgetSelectionRange] selectedRanges()
- setRangeSelected( QTableWidgetSelectionRange range, bool select)
注:
- QTableWidgetSelectionRange描述一个基于逻辑项位置连续的矩形范围,其矩形范围的左上角坐标为该范围内左上角逻辑项的逻辑行号和列号,右下角为右下角逻辑项的逻辑行号和列号。注意这里是指逻辑项而不是可见项
- 由于选中的项可能不连续,因此selectedRanges返回的可能是多个QTableWidgetSelectionRange矩形的列表,每个矩形内是一个连续的选中范围
- 关于逻辑项请参考《PyQt学习随笔:QTableWidget的visualRow、visualColumn、logicalRow、logicalColumn(可见行、逻辑行、可见列、逻辑列)相关概念及方法探究》
案例:
为了说明矩形内的项是逻辑项连续,我们来看一个案例:
上图中的行3和行4通过如下语句交互了可见位置,同时设定选择范围为(1,1)->(2,2):
self.tableWidget.verticalHeader().moveSection(3,2) #将第4行移动到第3行
rect = QtWidgets.QTableWidgetSelectionRange(1, 1, 2, 2) #定义矩形范围为逻辑行为1,列为1(即第二行第二列)到第3逻辑行3逻辑列的项
self.tableWidget.setRangeSelected(rect, True)
通过范围选择后,选中的范围从界面上看却不是连续的,但实际上逻辑项是连续的。
我们通过如下语句输出选中范围:
def showSelectRect(self):
selectRect = self.tableWidget.selectedRanges()
for r in selectRect:
print(f'({r.topRow()},{r.leftColumn()})-->({r.bottomRow()},{r.rightColumn()})')
针对上图输出的信息如下:
(1,1)-->(2,2)
如果针对上图通过鼠标改变选中范围,如图:
界面上看起来可见项是连续的,输出矩形选中范围结果如下:
(1,1)-->(1,2)
(3,1)-->(3,2)
显示为两个矩形,不是连续的范围。