QTableWidget的cellEntered信号绑定问题：需实现单元格聚焦回调

问题分析 #

你遇到的核心问题：

• cellEntered仅响应鼠标移动到单元格的动作，与焦点切换无关，键盘导航（方向键、Tab）不会触发该信号
• cellClicked仅响应鼠标点击，无法覆盖键盘操作场景
• 需要一个能监听**所有焦点切换动作（鼠标/键盘）**的信号来触发回调

解决方案 #

使用QTableWidget的currentCellChanged信号，该信号会在当前选中单元格发生变化时触发，无论变化是由鼠标点击、方向键切换还是Tab键导航引起的。

修改后的示例代码 #

from PyQt5.QtWidgets import QApplication, QTableWidget, QTableWidgetItem
from PyQt5.QtCore import Qt
import sys


class TableWidget(QTableWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()

    def init_ui(self):
        self.setRowCount(3)
        self.setColumnCount(3)
        # 显式设置焦点策略，确保表格能正常接收键盘焦点
        self.setFocusPolicy(Qt.StrongFocus)

        for row in range(self.rowCount()):
            for column in range(self.columnCount()):
                item = QTableWidgetItem(f"({row}, {column})")
                self.setItem(row, column, item)

        # 绑定currentCellChanged信号，参数为(前一行, 前一列, 当前行, 当前列)
        self.currentCellChanged.connect(self.handle_cell_focus_changed)

    def handle_cell_focus_changed(self, prev_row, prev_col, current_row, current_col):
        # 获取当前单元格对象，避免空指针异常
        current_item = self.item(current_row, current_col)
        if current_item:
            print(f"焦点切换到单元格 ({current_row}, {current_col})，内容：{current_item.text()}")
        else:
            print(f"焦点切换到空单元格 ({current_row}, {current_col})")


if __name__ == '__main__':
    app = QApplication(sys.argv)
    table_widget = TableWidget()
    table_widget.show()
    sys.exit(app.exec_())

关键说明 #

1. currentCellChanged信号特性：
   • 触发时机：当前选中单元格发生变化时（覆盖鼠标点击、方向键切换、Tab/Shift+Tab导航等所有场景）
   • 参数直接提供目标单元格的行/列，无需依赖currentItem()，避免出现返回None的情况
2. 焦点策略设置：setFocusPolicy(Qt.StrongFocus)确保表格能正常接收键盘焦点，避免因系统或父控件设置导致的焦点丢失问题
3. 空单元格兼容：增加单元格对象的非空判断，处理无内容单元格的焦点切换场景

额外补充 #

如果需要在单元格进入编辑模式时触发回调（比如双击或按Enter），可以绑定cellDoubleClicked或itemChanged信号；但如果仅需监听焦点切换，currentCellChanged是最优选择。

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