禁用状态下QLineEdit设置Qt.ForbiddenCursor光标无效问题排查

我尝试为动态启用/禁用的QLineEdit设置Qt.ForbiddenCursor样式光标，但完全不起作用。需求背景是存在一种专家模式，激活后可解锁特定输入字段，该模式通过UI中的单选按钮组触发。我的目标是：当专家模式未激活时，需专家权限的输入框处于“禁用”状态，同时通过光标样式及提示告知用户需激活专家模式才可修改这些字段。

相关代码如下：

from PySide6.QtCore import Qt
from PySide6.QtGui import QCursor

def toggle_line_edit(self, switch_type: SwitchType):
    match switch_type:
        case SwitchType.One:
            self.ui.line_edit.setCursor(QCursor(Qt.ForbiddenCursor))
            self.ui.line_edit.setDisabled(True)
        case SwitchType.Two:
            self.ui.line_edit.setCursor(QCursor(Qt.IBeamCursor))
            self.ui.line_edit.setDisabled(False)

问题原因 #

当QLineEdit被setDisabled(True)标记为禁用后，它会停止接收所有鼠标事件，此时系统会自动应用全局的禁用状态光标（样式由系统主题控制），你通过setCursor()设置的自定义光标会被直接忽略。

解决方法 #

提供两种实用方案，可根据你的需求选择：

方案1：用只读状态替代禁用状态

将输入框设置为setReadOnly(True)，既限制用户编辑，又保留鼠标事件响应能力，自定义光标就能正常生效。还可以通过样式表让只读状态的视觉效果接近禁用状态：

from PySide6.QtCore import Qt
from PySide6.QtGui import QCursor

def toggle_line_edit(self, switch_type: SwitchType):
    match switch_type:
        case SwitchType.One:
            self.ui.line_edit.setCursor(QCursor(Qt.ForbiddenCursor))
            self.ui.line_edit.setReadOnly(True)
            # 可选：设置只读样式，贴近禁用视觉效果
            self.ui.line_edit.setStyleSheet("QLineEdit:read-only { background-color: #eeeeee; border: 1px solid #cccccc; }")
            self.ui.line_edit.setToolTip("需激活专家模式才可修改此字段")
        case SwitchType.Two:
            self.ui.line_edit.setCursor(QCursor(Qt.IBeamCursor))
            self.ui.line_edit.setReadOnly(False)
            self.ui.line_edit.setStyleSheet("")  # 恢复默认样式
            self.ui.line_edit.setToolTip("")

方案2：通过事件过滤器强制设置光标

如果必须使用setDisabled(True)，可以给QLineEdit安装事件过滤器，拦截鼠标进入/离开事件，手动切换光标：

from PySide6.QtCore import Qt, QEvent
from PySide6.QtGui import QCursor
from PySide6.QtWidgets import QApplication

# 在类的初始化方法中安装事件过滤器
def __init__(self):
    # ...其他初始化逻辑
    self.ui.line_edit.installEventFilter(self)

def eventFilter(self, obj, event):
    if obj == self.ui.line_edit:
        if event.type() == QEvent.MouseMove:
            if self.ui.line_edit.isDisabled():
                QApplication.setOverrideCursor(QCursor(Qt.ForbiddenCursor))
            else:
                QApplication.restoreOverrideCursor()
        elif event.type() == QEvent.Leave:
            QApplication.restoreOverrideCursor()
    return super().eventFilter(obj, event)

# 原切换函数修改为：
def toggle_line_edit(self, switch_type: SwitchType):
    match switch_type:
        case SwitchType.One:
            self.ui.line_edit.setDisabled(True)
            self.ui.line_edit.setToolTip("需激活专家模式才可修改此字段")
        case SwitchType.Two:
            self.ui.line_edit.setDisabled(False)
            self.ui.line_edit.setCursor(QCursor(Qt.IBeamCursor))
            self.ui.line_edit.setToolTip("")

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