如何实现按下Tab键时禁用QTreeWidgetItem的编辑功能？

我开发了一个使用QTreeWidget和QTreeWidgetItem的应用程序。右键点击添加新项后，可在“Header 1”列编辑内容；按下Tab键，焦点会跳转到“Header 0”列且仍可编辑。期望按下Tab键后该QTreeWidgetItem变为不可编辑。尝试重写自定义CTreeWidgetItem类的keyPressEvent捕获Tab键事件，但未成功。

问题复现步骤：

• 运行脚本；
• 右键点击→添加项；
• 输入内容；
• 按下Tab键→焦点跳转至其他列且仍可编辑（允许焦点跳转，但项需变为不可编辑）。

原代码：

from PyQt5 import QtCore, QtGui, QtWidgets

class CTreeWidgetItem(QtWidgets.QTreeWidgetItem):
    def __init__(self, parent=None):
        QtWidgets.QTreeWidgetItem.__init__(self, parent)

    def keyPressEvent(self, event):
        if event.key() == QtCore.Qt.Key_Tab:
            self.setFlags(self.flags() | ~QtCore.Qt.ItemIsEditable)
            print('not working')
    
def create_treeWidget():
    treeWidget = QtWidgets.QTreeWidget()

    treeWidget.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
    treeWidget.customContextMenuRequested.connect(openContextMenu)
    
    treeWidget.setSelectionBehavior(QtWidgets.QAbstractItemView.SelectRows)
    treeWidget.setSelectionMode(QtWidgets.QAbstractItemView.ExtendedSelection)
    treeWidget.setTabKeyNavigation(True)
    
    treeWidget.headerItem().setText(0, "Header 0")
    treeWidget.headerItem().setText(1, "Header 1")
    treeWidget.headerItem().setText(2, "Header 2")
        
    return treeWidget

def openContextMenu(event):
    menu = QtWidgets.QMenu()
    action = menu.addAction('add item', addItem)
    menu.exec_(tree.mapToGlobal(event))

def addItem():
    item = CTreeWidgetItem(tree)
    item.setFlags(item.flags() | QtCore.Qt.ItemIsEditable)
    tree.editItem(item, 1)

if __name__ == "__main__":
    import sys

    app = QtWidgets.QApplication(sys.argv)
    app.setStyle("fusion")
    tree = create_treeWidget()
    tree.show()
    sys.exit(app.exec_())

QTreeWidgetItem不是QObject子类，本身不参与Qt事件循环，重写它的keyPressEvent方法不会被触发。按键事件实际由编辑项的编辑器（如QLineEdit）或QTreeWidget本身处理，这是原代码无效的核心原因。

通过给QTreeWidget添加事件过滤器，捕获编辑器的Tab按键事件，触发Tab时移除当前项的可编辑标志，同时保留Tab的焦点跳转功能。

修改后的代码：

from PyQt5 import QtCore, QtGui, QtWidgets

class CTreeWidgetItem(QtWidgets.QTreeWidgetItem):
    def __init__(self, parent=None):
        super().__init__(parent)

class CustomTreeWidget(QtWidgets.QTreeWidget):
    def eventFilter(self, obj, event):
        # 捕获编辑器的按键事件
        if event.type() == QtCore.QEvent.KeyPress:
            if event.key() == QtCore.Qt.Key_Tab:
                current_item = self.currentItem()
                if current_item:
                    # 移除可编辑标志
                    current_item.setFlags(current_item.flags() & ~QtCore.Qt.ItemIsEditable)
        # 让事件继续传递，保证Tab焦点跳转正常
        return super().eventFilter(obj, event)
    
def create_treeWidget():
    treeWidget = CustomTreeWidget()

    treeWidget.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
    treeWidget.customContextMenuRequested.connect(openContextMenu)
    
    treeWidget.setSelectionBehavior(QtWidgets.QAbstractItemView.SelectRows)
    treeWidget.setSelectionMode(QtWidgets.QAbstractItemView.ExtendedSelection)
    treeWidget.setTabKeyNavigation(True)
    
    treeWidget.headerItem().setText(0, "Header 0")
    treeWidget.headerItem().setText(1, "Header 1")
    treeWidget.headerItem().setText(2, "Header 2")
        
    return treeWidget

def openContextMenu(event):
    menu = QtWidgets.QMenu()
    action = menu.addAction('add item', addItem)
    menu.exec_(tree.mapToGlobal(event))

def addItem():
    item = CTreeWidgetItem(tree)
    item.setFlags(item.flags() | QtCore.Qt.ItemIsEditable)
    # 启动编辑后给编辑器安装事件过滤器
    editor = tree.editItem(item, 1)
    if editor:
        editor.installEventFilter(tree)

if __name__ == "__main__":
    import sys

    app = QtWidgets.QApplication(sys.argv)
    app.setStyle("fusion")
    tree = create_treeWidget()
    tree.show()
    sys.exit(app.exec_())

1. 自定义CustomTreeWidget类，重写eventFilter方法捕获编辑器的Tab按键事件；
2. 在addItem函数中，启动编辑后获取编辑器实例并安装事件过滤器；
3. 按下Tab键时，移除当前项的ItemIsEditable标志，同时调用父类eventFilter让事件继续传递，保证Tab焦点跳转功能正常。

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