如何在PySide6的QListView中禁用/启用选中项？

核心思路 #

QListView的项本身没有内置禁用状态，要实现该功能，需通过自定义QStyledItemDelegate控制项的交互性与显示样式，同时在模型中用自定义角色存储项的启用状态。

实现步骤 #

1. 为模型添加启用状态存储 #

使用QStandardItemModel时，通过Qt::UserRole为每个项绑定启用状态：

# 初始化list1的项时，默认设置为启用状态
item = QStandardItem("示例项1")
item.setData(True, Qt.UserRole + 1)  # 用自定义角色存储启用状态
list1_model.appendRow(item)

2. 自定义项代理（控制交互与样式） #

重写代理的editorEvent和paint方法，实现禁用项的交互拦截与视觉区分：

from PyQt5.QtWidgets import QStyledItemDelegate, QStyle
from PyQt5.QtGui import QPalette
from PyQt5.QtCore import Qt

class DisableItemDelegate(QStyledItemDelegate):
    def editorEvent(self, event, model, option, index):
        # 获取项的启用状态，禁用项直接拦截交互事件
        is_enabled = model.data(index, Qt.UserRole + 1)
        if not is_enabled:
            return True  # 返回True表示事件已处理，阻止后续交互
        return super().editorEvent(event, model, option, index)
    
    def paint(self, painter, option, index):
        is_enabled = model.data(index, Qt.UserRole + 1)
        if not is_enabled:
            # 设置禁用项的样式：灰色文本，取消启用状态标记
            option.state &= ~QStyle.State_Enabled
            option.palette.setColor(QPalette.Text, option.palette.color(QPalette.Disabled, QPalette.Text))
        super().paint(painter, option, index)

3. 为list1绑定代理 #

将自定义代理应用到list1，使项的禁用规则生效：

delegate = DisableItemDelegate()
list1.setItemDelegate(delegate)

4. 完善按钮逻辑 #

• Disable按钮：复制选中项到list2后，修改list1对应项的启用状态：

def on_disable_btn_clicked():
    selected_indexes = list1.selectedIndexes()
    for index in selected_indexes:
        # 复制项到list2
        item_text = index.data(Qt.DisplayRole)
        list2_model.appendRow(QStandardItem(item_text))
        # 禁用list1中的该项
        list1_model.setData(index, False, Qt.UserRole + 1)
    # 刷新视图，确保样式更新
    list1.viewport().update()

• Enable按钮：移除list2选中项后，启用list1中匹配的项：

def on_enable_btn_clicked():
    selected_indexes = list2.selectedIndexes()
    # 先收集要恢复的项文本，避免迭代时修改模型出错
    target_texts = [index.data(Qt.DisplayRole) for index in selected_indexes]
    # 移除list2中的选中项
    for index in reversed(selected_indexes):
        list2_model.removeRow(index.row())
    # 启用list1中对应的项
    for row in range(list1_model.rowCount()):
        item = list1_model.item(row)
        if item.text() in target_texts:
            item.setData(True, Qt.UserRole + 1)
    # 刷新视图
    list1.viewport().update()

关键注意点 #

• 必须使用UserRole存储启用状态，Qt内置角色无专门的启用状态字段
• 修改状态后需调用viewport().update()刷新视图，确保样式即时生效
• 处理list2项移除时，需反向迭代索引，避免因模型行数变化导致索引失效

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