PySide6(6.6.1)：如何处理Designer生成的QTableView鼠标事件？

核心思路 #

Designer生成的UI类不可直接修改，正确做法是通过自定义继承类或信号绑定实现事件逻辑，下面以右键上下文菜单为例给出两种可行方案。

方案一：自定义TableView类（推荐） #

适合需要多类自定义事件的场景，灵活性更高：

1. 编写自定义TableView类
   继承QTableView，重写contextMenuEvent处理右键事件：

from PySide6.QtWidgets import QTableView, QMenu, QAction
from PySide6.QtCore import Qt

class CustomTableView(QTableView):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setContextMenuPolicy(Qt.CustomContextMenu)

    def contextMenuEvent(self, event):
        index = self.indexAt(event.pos())
        if index.isValid():
            row = index.row()
            # 创建上下文菜单
            menu = QMenu(self)
            view_action = QAction("查看详情", self)
            edit_action = QAction("编辑行", self)
            delete_action = QAction("删除行", self)
            # 绑定菜单项触发逻辑
            view_action.triggered.connect(lambda: self.handle_view(row))
            edit_action.triggered.connect(lambda: self.handle_edit(row))
            delete_action.triggered.connect(lambda: self.handle_delete(row))
            # 显示菜单
            menu.addAction(view_action)
            menu.addAction(edit_action)
            menu.addAction(delete_action)
            menu.exec(event.globalPos())
        super().contextMenuEvent(event)

    # 自定义业务逻辑槽函数
    def handle_view(self, row):
        print(f"查看第{row}行数据")
    def handle_edit(self, row):
        print(f"编辑第{row}行")
    def handle_delete(self, row):
        print(f"删除第{row}行")

2. 替换Designer生成的TableView
   记住Designer中TableView的objectName（比如tableView），在业务代码中替换控件：

from PySide6.QtWidgets import QMainWindow
from ui_mainwindow import Ui_MainWindow  # Designer生成的UI类

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        # 移除原控件并替换为自定义类
        self.tableView.deleteLater()
        self.tableView = CustomTableView(self)
        # 重新添加到布局（若原控件在布局中）
        layout = self.centralWidget().layout()
        layout.addWidget(self.tableView)
        # 后续可设置数据模型等操作

方案二：直接绑定菜单信号（快速实现） #

仅需右键菜单时，可直接通过信号绑定实现：

from PySide6.QtWidgets import QMainWindow, QMenu, QAction
from ui_mainwindow import Ui_MainWindow
from PySide6.QtCore import Qt

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        # 开启自定义上下文菜单支持
        self.tableView.setContextMenuPolicy(Qt.CustomContextMenu)
        # 绑定菜单触发信号
        self.tableView.customContextMenuRequested.connect(self.show_context_menu)

    def show_context_menu(self, pos):
        index = self.tableView.indexAt(pos)
        if index.isValid():
            row = index.row()
            menu = QMenu(self)
            view_action = QAction("查看详情", self)
            edit_action = QAction("编辑行", self)
            delete_action = QAction("删除行", self)
            
            view_action.triggered.connect(lambda: self.handle_view(row))
            edit_action.triggered.connect(lambda: self.handle_edit(row))
            delete_action.triggered.connect(lambda: self.handle_delete(row))
            
            menu.addAction(view_action)
            menu.addAction(edit_action)
            menu.addAction(delete_action)
            # 转换为全局坐标显示菜单
            menu.exec(self.tableView.mapToGlobal(pos))

    def handle_view(self, row):
        print(f"查看第{row}行数据")
    def handle_edit(self, row):
        print(f"编辑第{row}行")
    def handle_delete(self, row):
        print(f"删除第{row}行")

键盘事件处理方法 #

如果需要处理键盘事件（比如按Delete键删行），可在自定义TableView类中重写keyPressEvent：

class CustomTableView(QTableView):
    # ... 其他代码 ...
    def keyPressEvent(self, event):
        if event.key() == Qt.Key_Delete:
            selected_rows = self.selectionModel().selectedRows()
            if selected_rows:
                for index in selected_rows:
                    print(f"删除行：{index.row()}")
        # 保留默认键盘行为（如上下箭头切换选中行）
        super().keyPressEvent(event)

内容的提问来源于stack exchange，提问作者Frank C.