Qt如何实现按回车键或右箭头键将焦点切换到QListWidget首项

核心思路是通过重写父控件的事件过滤器，全局拦截回车键、小键盘确认键和右方向键事件，拦截后主动切换焦点到列表首项，同时避免按键事件被文本框捕获触发换行。

具体改动 #

1. 在控件初始化阶段给父控件、文本框、列表控件统一安装事件过滤器，确保所有控件的按键事件都能被捕获
2. 重写eventFilter方法，匹配目标按键后直接执行焦点切换逻辑，返回True表示事件已被消费，不再向下传递到子控件
3. 操作列表前先判断列表项数量，适配动态添加列表项的场景

完整可运行代码 #

import sys
from PyQt5 import QtWidgets, QtCore

class launchiiwidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        layout = QtWidgets.QVBoxLayout(self)

        self.textbox = QtWidgets.QTextEdit(self)
        self.textbox.setLineWrapMode(QtWidgets.QTextEdit.NoWrap)
        self.textbox.setAlignment(QtCore.Qt.AlignCenter)   
        self.textbox.setFixedSize(QtCore.QSize(600, 100))
        self.textbox.setVerticalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
        self.textbox.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOff)
        
        layout.addWidget(self.textbox)

        font = self.textbox.font()
        font.setPointSize(80)
        self.textbox.setFont(font)

        self.listwidget = QtWidgets.QListWidget(self)
        self.listwidget.addItem("Red")
        self.listwidget.addItem("Blue") 
        layout.addWidget(self.listwidget)

        # 新增：给所有控件安装事件过滤器
        self.installEventFilter(self)
        self.textbox.installEventFilter(self)
        self.listwidget.installEventFilter(self)

    # 新增：重写事件过滤器处理按键逻辑
    def eventFilter(self, obj, event):
        if event.type() == QtCore.QEvent.KeyPress:
            # 匹配大键盘回车、小键盘确认、右方向键
            if event.key() in (QtCore.Qt.Key_Return, QtCore.Qt.Key_Enter, QtCore.Qt.Key_Right):
                if self.listwidget.count() > 0:
                    # 选中第一个列表项
                    self.listwidget.setCurrentItem(self.listwidget.item(0))
                    # 切换焦点到列表控件
                    self.listwidget.setFocus()
                # 消费事件，避免子控件处理（比如文本框换行）
                return True
        return super().eventFilter(obj, event)

if __name__ == "__main__":
    app = QtWidgets.QApplication([])

    widget = launchiiwidget()
    widget.setWindowFlags(QtCore.Qt.FramelessWindowHint)
    widget.resize(600, 200)
    widget.show()

    sys.exit(app.exec())

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