Qt for Mac：实现点击复选框时文本框失焦及全局焦点配置

问题背景 #

在Mac平台下，Qt默认点击复选框不会使同一窗口中的文本框失去焦点，但Windows平台默认此行为生效。需要实现Mac平台与Windows一致的焦点行为，且避免逐个设置控件的setFocusPolicy或暴力遍历窗口控件的解决方案。

测试代码如下：

#include "mainwindow.h"
#include <QVBoxLayout>
#include <QTextEdit>
#include <QCheckBox>

MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
    //ui->setupUi(this);
    QWidget* pCentral = new QWidget(this);
    setCentralWidget(pCentral);
    pCentral->setLayout(new QVBoxLayout());

    QTextEdit* pText = new QTextEdit();
    pCentral->layout()->addWidget(pText);

    QCheckBox* pCheck = new QCheckBox();
    pCheck->setText("test checkbox");
    pCentral->layout()->addWidget(pCheck);
}

已知可以通过setFocusPolicy(Qt::StrongFocus)单独设置复选框的焦点策略，但希望全局默认对所有复选框类控件启用该策略。

优雅解决方案：使用QProxyStyle全局修改焦点策略 #

通过自定义QProxyStyle并重写styleHint方法，可以全局指定特定控件的默认焦点策略，无需逐个修改控件或遍历窗口元素。

步骤1：自定义代理样式类 #

创建一个继承自QProxyStyle的类，在styleHint中针对QCheckBox返回Qt::StrongFocus的焦点策略提示：

#include <QProxyStyle>
#include <QCheckBox>

class MacFocusFixStyle : public QProxyStyle
{
public:
    int styleHint(StyleHint hint, const QStyleOption* option = nullptr, const QWidget* widget = nullptr, QStyleHintReturn* returnData = nullptr) const override
    {
        // 针对QCheckBox，强制设置默认焦点策略为StrongFocus
        if (qobject_cast<const QCheckBox*>(widget) && hint == QStyle::SH_Widget_FocusPolicy) {
            return Qt::StrongFocus;
        }
        // 其他样式提示沿用系统默认
        return QProxyStyle::styleHint(hint, option, widget, returnData);
    }
};

步骤2：在应用启动时设置自定义样式 #

在main函数中为QApplication设置该自定义样式，即可全局生效：

#include <QApplication>
#include "mainwindow.h"
#include "MacFocusFixStyle.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    // 应用自定义样式，全局修改复选框的默认焦点行为
    a.setStyle(new MacFocusFixStyle);
    MainWindow w;
    w.show();
    return a.exec();
}

方案优势 #

• 全局生效：所有QCheckBox控件（包括后续动态创建的）都会自动应用Qt::StrongFocus，无需额外代码
• 侵入性低：无需修改现有控件的创建逻辑，也无需遍历窗口控件
• 可扩展性强：如果需要对其他控件（如QRadioButton）做相同处理，只需在styleHint中添加对应的类型判断即可

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