如何在macOS上创建始终置顶且不抢占焦点的Qt窗口？

在macOS上仅靠Qt的跨平台属性无法完全实现「置顶且不抢焦点」的需求，需要结合Qt属性设置与macOS原生API调整，以下是可行的步骤：

1. 配置Qt窗口核心属性 #

先通过Qt的内置属性奠定基础，确保窗口的基本行为符合预期：

• 组合设置窗口标志：Qt::WindowStaysOnTopHint | Qt::Tool，前者保证窗口置顶，后者标记为工具窗口（减少系统自动激活的概率）
• 添加Qt::WA_ShowWithoutActivating属性，告知Qt显示窗口时不要激活它
• 可选添加Qt::WA_MacDoNotActivate（macOS专属属性），进一步阻止窗口获取焦点
• 如果不需要系统窗口边框，可追加Qt::FramelessWindowHint，避免边框交互触发焦点抢占

2. 调用macOS原生API强制修正行为 #

由于Qt的跨层封装在macOS上可能存在兼容性问题，需要直接操作原生NSWindow对象来确保窗口不激活：

• 获取窗口对应的原生NSWindow指针（Qt 6用QNativeInterface::Mac::NSWindow，Qt 5可通过winId()转换）
• 设置窗口层级为NSFloatingWindowLevel，确保窗口始终在普通窗口之上
• 配置NSWindowCollectionBehaviorIgnoresCycle，让窗口脱离应用焦点循环
• 调用orderFrontWithoutActivating方法，强制窗口前置但不激活

完整代码示例 #

Qt 6版本 #

#include <QWidget>
#include <QApplication>
#include <QNativeInterface>

class FloatingWindow : public QWidget
{
    Q_OBJECT
public:
    FloatingWindow(QWidget *parent = nullptr) : QWidget(parent)
    {
        // 配置Qt窗口属性
        setWindowFlags(Qt::WindowStaysOnTopHint | Qt::Tool | Qt::FramelessWindowHint);
        setAttribute(Qt::WA_ShowWithoutActivating);
        setAttribute(Qt::WA_MacDoNotActivate);

        // 自定义窗口大小位置
        resize(300, 200);
        move(100, 100);
    }

    void showEvent(QShowEvent *event) override
    {
        QWidget::showEvent(event);

        // 获取原生NSWindow并调整行为
        if (auto nativeWin = nativeInterface<QNativeInterface::Mac::NSWindow>()) {
            NSWindow *nsWin = nativeWin->nativeWindow();
            if (nsWin) {
                [nsWin setLevel:NSFloatingWindowLevel];
                [nsWin setCollectionBehavior:NSWindowCollectionBehaviorIgnoresCycle];
                [nsWin orderFrontWithoutActivating];
            }
        }
    }
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    FloatingWindow w;
    w.show();
    return a.exec();
}

Qt 5版本 #

#include <QWidget>
#include <QApplication>
#include <QtMacExtras/QMacNativeWidget>

class FloatingWindow : public QWidget
{
    Q_OBJECT
public:
    FloatingWindow(QWidget *parent = nullptr) : QWidget(parent)
    {
        setWindowFlags(Qt::WindowStaysOnTopHint | Qt::Tool | Qt::FramelessWindowHint);
        setAttribute(Qt::WA_ShowWithoutActivating);
        setAttribute(Qt::WA_MacDoNotActivate);

        resize(300, 200);
        move(100, 100);
    }

    void showEvent(QShowEvent *event) override
    {
        QWidget::showEvent(event);

        NSWindow *nsWin = reinterpret_cast<NSWindow*>(winId());
        if (nsWin) {
            [nsWin setLevel:NSFloatingWindowLevel];
            [nsWin setCollectionBehavior:NSWindowCollectionBehaviorIgnoresCycle];
            [nsWin orderFrontWithoutActivating];
        }
    }
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    FloatingWindow w;
    w.show();
    return a.exec();
}

注意事项 #

• 项目配置：在.pro文件中添加LIBS += -framework AppKit，确保链接macOS的AppKit框架
• 测试验证：打开其他应用并保持激活状态，再显示此窗口，确认焦点不会被抢占
• 边框处理：如果保留系统窗口边框，可能需要额外处理标题栏的交互逻辑，避免触发焦点激活

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