Tab键遍历到QTableWidget最后一项时，如何让焦点返回初始按钮

我自定义了一个对话框，按下Tab键时焦点会从按钮切换至QTableWidget。希望遍历完QTableWidget的所有项后，焦点能回到初始按钮。尝试重写focusNextPrevChild函数但未生效，焦点进入QTableWidget后无法移出。以下是最小复现示例：

#include <QApplication>
#include <QPushButton>
#include <QTableWidget>
#include <QVBoxLayout>

class Widget : public QWidget
{
public:
    explicit Widget()
    {
        setLayout(&vl);

        tw.setRowCount(1);
        tw.setColumnCount(3);

        vl.addWidget(&btn);
        vl.addWidget(&tw);
    }

    bool focusNextPrevChild(bool next)
    {
        QWidget* focusWidget = this->focusWidget();

        if (focusWidget == &tw)
        {
            int currentRow = tw.currentRow();
            int currentCol = tw.currentColumn();
            int lastRow = tw.rowCount() - 1;
            int lastCol = tw.columnCount() - 1;

            if (next && currentRow == lastRow && currentCol == lastCol)
            {
                tw.clearFocus();
                return true;
            }
        }

        return QWidget::focusNextPrevChild(next);
    }
    
private:
    QPushButton btn;
    QTableWidget tw;
    QVBoxLayout vl;
};

int main(int argc, char* argv[])
{
    QApplication a(argc, argv);

    Widget w;
    w.show();

    return a.exec();
}

问题分析 #

原代码的核心问题是：QTableWidget的焦点实际落在内部的单元格部件上，而非QTableWidget本身，所以focusWidget() == &tw的判断永远不成立；另外仅清除QTableWidget的焦点，没有主动将焦点转移到按钮，导致焦点丢失后无法正确流转。

解决方案 #

修改focusNextPrevChild函数，针对单元格焦点做判断，到达边界时主动将焦点设置回按钮，同时支持正向Tab和反向Shift+Tab的焦点循环：

#include <QApplication>
#include <QPushButton>
#include <QTableWidget>
#include <QVBoxLayout>

class Widget : public QWidget
{
public:
    explicit Widget()
    {
        setLayout(&vl);

        tw.setRowCount(1);
        tw.setColumnCount(3);

        vl.addWidget(&btn);
        vl.addWidget(&tw);
    }

    bool focusNextPrevChild(bool next) override
    {
        // 判断焦点是否在QTableWidget的单元格上
        QWidget* currentFocus = focusWidget();
        if (currentFocus == tw.currentWidget()) {
            int currentRow = tw.currentRow();
            int currentCol = tw.currentColumn();
            int lastRow = tw.rowCount() - 1;
            int lastCol = tw.columnCount() - 1;

            if (next) {
                // 正向Tab：最后一个单元格时，焦点切回按钮
                if (currentRow == lastRow && currentCol == lastCol) {
                    btn.setFocus();
                    return true;
                }
            } else {
                // 反向Shift+Tab：第一个单元格时，焦点切回按钮
                if (currentRow == 0 && currentCol == 0) {
                    btn.setFocus();
                    return true;
                }
            }
        }
        // 其他情况交给父类默认逻辑处理
        return QWidget::focusNextPrevChild(next);
    }
    
private:
    QPushButton btn;
    QTableWidget tw;
    QVBoxLayout vl;
};

int main(int argc, char* argv[])
{
    QApplication a(argc, argv);

    Widget w;
    w.show();

    return a.exec();
}

关键修改点 #

• 替换焦点判断逻辑：用tw.currentWidget()获取实际拥有焦点的单元格部件，替代原有的&tw判断。
• 主动设置焦点：到达边界单元格时，直接调用btn.setFocus()将焦点转移到按钮，而非仅清除QTableWidget的焦点。
• 补充反向焦点处理：支持Shift+Tab从第一个单元格回到按钮，完善焦点循环的完整性。

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