如何让QListWidget按下向下键时从最后一项跳转至第一项？

嗨，这个需求我之前做项目时刚好遇到过！QListWidget本身并没有内置的配置开关让它实现“到最后一项后按向下键跳转到第一项”的循环逻辑，得咱们自己动手实现，不过步骤很简单，下面给你两种常用的方案：

方案一：子类化QListWidget并重写按键事件 #

这种方式比较封装，适合你需要在多个地方用到这个循环列表的场景：

你可以创建一个继承自QListWidget的子类，重写它的keyPressEvent方法，在里面处理向下和向上按键的循环逻辑：

class CircularListWidget : public QListWidget
{
    Q_OBJECT
public:
    explicit CircularListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

protected:
    void keyPressEvent(QKeyEvent *event) override
    {
        // 先判断列表有没有项，避免空列表出错
        if (count() == 0) {
            QListWidget::keyPressEvent(event);
            return;
        }

        if (event->key() == Qt::Key_Down) {
            int currentRow = currentRow();
            int lastRow = count() - 1;
            // 如果当前是最后一项，跳转到第一项
            if (currentRow == lastRow) {
                setCurrentRow(0);
                event->accept(); // 标记事件已处理，阻止父类重复处理
                return;
            }
        } else if (event->key() == Qt::Key_Up) {
            // 顺便实现向上到第一项后跳转到最后一项的逻辑（可选）
            int currentRow = currentRow();
            if (currentRow == 0) {
                setCurrentRow(count() - 1);
                event->accept();
                return;
            }
        }
        // 其他按键交给父类的默认逻辑处理
        QListWidget::keyPressEvent(event);
    }
};

之后在你的GUI里直接使用这个CircularListWidget代替原来的QListWidget就可以了。

方案二：使用事件过滤器（无需子类化） #

如果不想修改原有QListWidget的类结构，事件过滤器是更灵活的选择，你可以在窗口类里给目标QListWidget安装过滤器：

首先在窗口的构造函数里安装事件过滤器：

// 假设你的QListWidget对象是ui->listWidget
ui->listWidget->installEventFilter(this);

然后重写窗口类的eventFilter方法，处理按键事件：

bool YourMainWindow::eventFilter(QObject *watched, QEvent *event)
{
    // 判断是不是目标QListWidget的按键事件
    if (watched == ui->listWidget && event->type() == QEvent::KeyPress) {
        QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
        QListWidget *listWidget = qobject_cast<QListWidget*>(watched);
        
        if (listWidget->count() == 0) {
            return QWidget::eventFilter(watched, event);
        }

        if (keyEvent->key() == Qt::Key_Down) {
            int currentRow = listWidget->currentRow();
            if (currentRow == listWidget->count() - 1) {
                listWidget->setCurrentRow(0);
                return true; // 拦截事件，不再传递给QListWidget的默认处理
            }
        } else if (keyEvent->key() == Qt::Key_Up) {
            int currentRow = listWidget->currentRow();
            if (currentRow == 0) {
                listWidget->setCurrentRow(listWidget->count() - 1);
                return true;
            }
        }
    }
    // 其他情况交给父类的事件过滤器处理
    return QWidget::eventFilter(watched, event);
}

两种方案都能实现你要的循环选中效果，选哪种就看你的项目结构和需求啦～

内容的提问来源于stack exchange，提问作者Daniel Viaño