QSpinBox无障碍特性致Windows放大镜光标移动时聚焦错误屏幕

当Windows放大镜处于激活并放大状态时，它应跟随QSpinBox内的光标移动。该功能在单屏环境下可正常工作，但在双屏环境中，若QSpinBox位于第二屏幕，放大镜会移动到第一屏幕的对应位置，导致QSpinBox从视野中消失，无障碍体验变差。这似乎是Qt未正确使用虚拟桌面坐标导致的问题。

疑问 #

1. 如何在多屏环境下让该功能稳定正常工作？
2. 如何在QSpinBox级别或必要时在应用级别禁用无障碍特性？

from PyQt6.QtWidgets import QApplication, QSpinBox, QWidget, QVBoxLayout
from PyQt6.QtCore import Qt
# import os

# QCoreApplication.setAttribute(Qt.ApplicationAttribute.AA_MSWindowsDisableUIA, True) # not available in PyQt6
# os.environ["QT_ACCESSIBILITY"] = "0" # not effective

class MySpinBox(QSpinBox):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # self.setAttribute(Qt.WidgetAttribute.WA_NativeWindow, True) # not effective
        # self.lineEdit().setAttribute(Qt.WidgetAttribute.WA_NativeWindow, True) # not effective
        # self.lineEdit().setAttribute(Qt.WA_AccessibilityIgnore, True) # not available in PyQt6
    def wheelEvent(self, event):
        # suppress Magnifier movement triggered by wheel event 
        event.ignore()

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout(self)
        self.spinbox = MySpinBox(self)
        layout.addWidget(self.spinbox)
        self.setLayout(layout)

if __name__ == "__main__":
    import sys
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

1. 修复多屏环境下放大镜跟随问题 #

问题核心是Qt上报控件位置给Windows辅助功能框架时，可能使用屏幕相对坐标而非虚拟桌面全局坐标，可通过以下方式修复：

• 自定义无障碍接口返回全局坐标：为QSpinBox内部的QLineEdit实现自定义QAccessibleInterface，确保返回的位置是全局虚拟桌面坐标：

from PyQt6.QtGui import QAccessibleInterface, QAccessible, QRect
from PyQt6.QtWidgets import QLineEdit

class AccessibleSpinBoxLineEdit(QAccessibleInterface):
    def __init__(self, line_edit):
        super().__init__(line_edit)
        self.line_edit = line_edit

    def rect(self):
        # 转换为全局虚拟桌面坐标
        global_pos = self.line_edit.mapToGlobal(self.line_edit.rect().topLeft())
        return QRect(global_pos, self.line_edit.rect().size())

    # 实现其他必需的接口方法（返回默认值）
    def interface_cast(self, t):
        return None
    def object(self):
        return self.line_edit
    def parent(self):
        return QAccessible.queryAccessibleInterface(self.line_edit.parent())
    def child(self, index):
        return None
    def childCount(self):
        return 0
    def indexOfChild(self, child):
        return -1
    def text(self, t):
        return ""
    def role(self):
        return QAccessible.Role.EditableText
    def state(self):
        return QAccessible.State()

class MySpinBox(QSpinBox):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 为内部LineEdit注册自定义无障碍接口
        line_edit = self.lineEdit()
        QAccessible.installFactory(lambda obj, iface: AccessibleSpinBoxLineEdit(obj) if obj is line_edit else None)

• 强制使用原生窗口句柄：给主窗口和QSpinBox都设置WA_NativeWindow属性，确保Windows能正确获取控件的全局位置：

class MySpinBox(QSpinBox):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setAttribute(Qt.WidgetAttribute.WA_NativeWindow, True)
        self.lineEdit().setAttribute(Qt.WidgetAttribute.WA_NativeWindow, True)

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setAttribute(Qt.WidgetAttribute.WA_NativeWindow, True)
        layout = QVBoxLayout(self)
        self.spinbox = MySpinBox(self)
        layout.addWidget(self.spinbox)
        self.setLayout(layout)

2. 禁用无障碍特性 #

应用级别禁用 #

• 设置环境变量：必须在创建QApplication之前设置QT_ACCESSIBILITY=0：

if __name__ == "__main__":
    import sys
    import os
    os.environ["QT_ACCESSIBILITY"] = "0"
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

若该方法无效，可尝试通过ctypes禁用Windows UI自动化初始化：

if __name__ == "__main__":
    import sys
    import os
    from ctypes import windll
    # 初始化COM时使用多线程模型，阻止UI自动化加载
    windll.ole32.CoInitializeEx(0, 0x00000010)
    os.environ["QT_ACCESSIBILITY"] = "0"
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

控件级别禁用 #

重写控件的accessibleInterface()方法返回None，让系统忽略该控件的无障碍支持：

class MySpinBox(QSpinBox):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 禁用内部LineEdit的无障碍
        self.lineEdit().setAccessibleInterface(None)

    def accessibleInterface(self):
        return None

注意：此操作会影响该控件的其他辅助功能，仅在必要时使用。

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