PyQt5中如何实现点击tableWidget外部区域取消表格行选中

问题说明 #

当前获取选中行的代码如下：

row = self.table.currentRow()

默认逻辑下，点击tableWidget控件外部区域时，控件会始终保留最后一次记录的currentRow值，不会自动清空选中状态，不符合交互预期。需要实现点击tableWidget外部任意位置时，currentRow值重置为-1、同时取消对应行选中状态的效果。

实现逻辑 #

核心是监听tableWidget的焦点移出事件：用户点击控件外部区域时，tableWidget会失去输入焦点，此时触发清空选中、重置当前行的逻辑即可。以下提供两种可直接落地的实现方式：

方式1：子类化重写焦点事件（稳定性最高） #

自定义QTableWidget子类，重写focusOutEvent方法，在焦点移出时执行重置逻辑：

# 按你使用的Qt绑定调整导入，PyQt5/PyQt6/PySide2/PySide6逻辑通用
from PyQt5.QtWidgets import QTableWidget, QApplication

class ClearOnFocusOutTable(QTableWidget):
    def focusOutEvent(self, event):
        # 先执行父类原有焦点事件逻辑
        super().focusOutEvent(event)
        # 特殊场景过滤：焦点落在表头、滚动条等table自带子部件时不触发清空
        focus_target = QApplication.focusWidget()
        if self.isAncestorOf(focus_target):
            return
        # 清空所有选中高亮
        self.clearSelection()
        # 重置当前选中行/列，调用currentRow()时会返回-1
        self.setCurrentCell(-1, -1)

把UI里原有tableWidget替换/提升为该自定义类即可生效，不会影响排序、右键菜单等table自带功能的正常使用。

方式2：事件过滤器实现（无需子类化） #

如果不想自定义控件类，可以直接给目标tableWidget安装事件过滤器，在窗口类中直接处理焦点移出逻辑，适合快速修改存量代码：

# 在窗口类的__init__初始化方法中，给table绑定事件过滤器
self.table.installEventFilter(self)

# 在窗口类中重写eventFilter监听方法
def eventFilter(self, watched, event):
    from PyQt5.QtCore import QEvent
    if watched == self.table and event.type() == QEvent.FocusOut:
        focus_target = QApplication.focusWidget()
        if not self.table.isAncestorOf(focus_target):
            self.table.clearSelection()
            self.table.setCurrentCell(-1, -1)
    return super().eventFilter(watched, event)

效果验证 #

逻辑生效后，点击table外部任意可聚焦区域时，调用self.table.currentRow()会直接返回-1，原有行的选中高亮也会同步取消。

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