如何在PyQt List Widget中实现多行选中项的同时上下移动

核心思路 #

• self.listWidget.selectedItems()返回的是QListWidgetItem实例，调用self.listWidget.row(item)即可获取对应条目的行号，不需要仅通过文本匹配定位
• 移动多选条目时要注意处理顺序，避免先移动的条目导致后续待处理条目的行号偏移出错
• 直接操作QListWidgetItem实例而非仅提取文本，可以保留条目的图标、自定义数据、样式等附加属性，比你原有单条移动的实现兼容性更强

前置配置 #

需要先开启列表的多选模式，示例：

from PyQt6.QtWidgets import QListWidget, QItemSelectionModel

# 初始化时设置选择模式，ExtendedSelection支持按Ctrl/Shift多选
self.listWidget.setSelectionMode(QListWidget.SelectionMode.ExtendedSelection)

完整实现代码 #

多选上移 #

def move_selected_items_up(self):
    # 收集选中条目的行号，升序排序（从上到下处理）
    selected_rows = sorted([self.listWidget.row(item) for item in self.listWidget.selectedItems()])
    # 边界判断：无选中项 或 最顶部选中项已在第一行，直接返回
    if not selected_rows or selected_rows[0] == 0:
        return
    new_selected_rows = []
    for row in selected_rows:
        # 取出当前条目实例
        current_item = self.listWidget.takeItem(row)
        # 插入到上一行位置
        self.listWidget.insertItem(row - 1, current_item)
        new_selected_rows.append(row - 1)
    # 恢复选中状态
    self.listWidget.clearSelection()
    for row in new_selected_rows:
        self.listWidget.setCurrentRow(row, QItemSelectionModel.SelectionFlag.Select)

多选下移 #

def move_selected_items_down(self):
    # 收集选中条目的行号，降序排序（从下到上处理）
    selected_rows = sorted([self.listWidget.row(item) for item in self.listWidget.selectedItems()], reverse=True)
    max_row = self.listWidget.count() - 1
    # 边界判断：无选中项 或 最底部选中项已在最后一行，直接返回
    if not selected_rows or selected_rows[0] == max_row:
        return
    new_selected_rows = []
    for row in selected_rows:
        current_item = self.listWidget.takeItem(row)
        self.listWidget.insertItem(row + 1, current_item)
        new_selected_rows.append(row + 1)
    # 恢复选中状态
    self.listWidget.clearSelection()
    for row in new_selected_rows:
        self.listWidget.setCurrentRow(row, QItemSelectionModel.SelectionFlag.Select)

注意事项 #

• 上移操作采用升序处理行号：先移动位置靠上的条目，不会影响下方待处理条目的行号
• 下移操作采用降序处理行号：先移动位置靠下的条目，不会影响上方待处理条目的行号
• 操作完成后重新选中移动后的条目，保持操作体验一致

内容的提问来源于stack exchange，提问作者Jack Zero