Qt中如何阻止Shift+Tab切换控件焦点？

核心原因 #

Qt默认将Shift+Tab绑定为控件焦点切换的全局快捷键，优先级高于编辑器的按键事件，导致自定义缩进逻辑无法触发。之前的方案无效是因为未正确拦截Shift+Tab组合键，且全局notify的写法存在风险。

推荐解决方案：子类化QPlainTextEdit重写按键事件 #

直接在编辑器控件层面拦截按键事件，优先级更高，且不会影响其他控件的焦点操作：

#include <QPlainTextEdit>
#include <QKeyEvent>
#include <QTextCursor>
#include <QTextBlockFormat>

class CodeEditor : public QPlainTextEdit
{
    Q_OBJECT
protected:
    void keyPressEvent(QKeyEvent *event) override
    {
        // 拦截Shift+Tab组合键
        if (event->key() == Qt::Key_Tab && (event->modifiers() & Qt::ShiftModifier))
        {
            QTextCursor cursor = textCursor();
            if (cursor.hasSelection())
            {
                // 处理多行选中的减少缩进
                cursor.beginEditBlock();
                QTextBlock startBlock = document()->findBlock(cursor.selectionStart());
                QTextBlock endBlock = document()->findBlock(cursor.selectionEnd());
                
                for (QTextBlock block = startBlock; block != endBlock.next(); block = block.next())
                {
                    QTextBlockFormat format = block.blockFormat();
                    int currentIndent = format.indent();
                    if (currentIndent > 0)
                    {
                        format.setIndent(currentIndent - 1);
                        QTextCursor blockCursor(document());
                        blockCursor.setPosition(block.position());
                        blockCursor.setBlockFormat(format);
                    }
                }
                cursor.endEditBlock();
            }
            else
            {
                // 处理单行无选中的减少缩进
                QTextBlock currentBlock = cursor.block();
                QTextBlockFormat format = currentBlock.blockFormat();
                int currentIndent = format.indent();
                if (currentIndent > 0)
                {
                    format.setIndent(currentIndent - 1);
                    cursor.setBlockFormat(format);
                }
            }
            // 标记事件已处理，阻止后续传递（包括焦点切换）
            event->accept();
            return;
        }
        // 其他按键交给父类默认处理
        QPlainTextEdit::keyPressEvent(event);
    }
};

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

如果不想子类化控件，可给目标QPlainTextEdit安装事件过滤器：

// 在主窗口类中实现事件过滤器
bool MainWindow::eventFilter(QObject *watched, QEvent *event)
{
    QPlainTextEdit* editor = qobject_cast<QPlainTextEdit*>(watched);
    if (editor && event->type() == QEvent::KeyPress)
    {
        QKeyEvent* keyEvent = static_cast<QKeyEvent*>(event);
        if (keyEvent->key() == Qt::Key_Tab && (keyEvent->modifiers() & Qt::ShiftModifier))
        {
            // 复制上面的缩进处理代码
            QTextCursor cursor = editor->textCursor();
            // ... 多行/单行缩进逻辑 ...
            keyEvent->accept();
            return true;
        }
    }
    return QMainWindow::eventFilter(watched, event);
}

// 在主窗口构造函数中安装过滤器
ui->plainTextEdit->installEventFilter(this);

为什么之前的方案无效？ #

1. 重写的notify方法仅拦截了Tab键，未判断ShiftModifier，根本没处理Shift+Tab组合键；
2. 全局notify中调用focusWidget()可能在事件传递过程中导致空指针，引发崩溃；
3. 直接return false会阻止事件传递给目标控件，但未正确处理按键逻辑，且全局拦截风险高。

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