macOS下Qt全屏模式Widget接收鼠标事件延迟原因及优化咨询

在普通屏幕模式下，Qt Widget创建后可立即接收鼠标事件；但在macOS的全屏模式下，Widget需等待较长时间才能开始接收这类事件。经测试，全屏模式下Widget接收首个鼠标事件平均耗时约700ms，而普通模式仅约30ms。请问该延迟产生的原因是什么？是否有办法让Qt更早接收这些事件？

测试演示：

测试源码 #

main.cpp #

/**
 * main.cpp
 */

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

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

mainwindow.h #

/**
 * mainwindow.h
 */

#pragma once

#include "popupwindow.h"
#include <QWidget>
#include <QPushButton>

class MainWindow : public QWidget
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);

private slots:
    void handleFullScreenButton();
    void handleNormalScreenButton();

private:
    PopupWindow* m_fullScreenWindow;
    QPushButton* m_fullScreenButton;
    QPushButton* m_normalScreenButton;
    PopupWindow* m_normalScreenWindow;
};

popupwindow.h #

/**
 * popupwindow.h
 */

#pragma once

#include <QWidget>
#include <QLabel>

class PopupWindow : public QWidget
{
    Q_OBJECT

public:
    explicit PopupWindow(QWidget* parent = nullptr);

protected:
    void mouseMoveEvent(QMouseEvent *event) override;
    void mousePressEvent(QMouseEvent *event) override;

private:
    void showText(const QString &text);
    QLabel* m_text;
    qint64 m_creationTimestamp;
    bool m_eventReceived;
};

mainwindow.cpp #

/**
 * mainwindow.cpp
 */

#include "mainwindow.h"
#include <QDebug>
#include <QVBoxLayout>

MainWindow::MainWindow(QWidget *parent)
    : m_normalScreenWindow(nullptr)
    , m_fullScreenWindow(nullptr)
{
    auto *layout = new QVBoxLayout(this);
    m_normalScreenButton = new QPushButton("Popup screen");
    m_fullScreenButton = new QPushButton("Popup full screen");
    connect(m_normalScreenButton, &QPushButton::released, this, &MainWindow::handleNormalScreenButton);
    connect(m_fullScreenButton, &QPushButton::released, this, &MainWindow::handleFullScreenButton);
    layout->addWidget(m_normalScreenButton);
    layout->addWidget(m_fullScreenButton);
}

void MainWindow::handleNormalScreenButton() {
    m_normalScreenWindow = new PopupWindow(this);
    m_normalScreenWindow->show();
    m_normalScreenWindow->activateWindow();
    m_normalScreenWindow->raise();
}

void MainWindow::handleFullScreenButton() {
    m_fullScreenWindow = new PopupWindow(this);
    m_fullScreenWindow->showFullScreen();
    m_fullScreenWindow->activateWindow();
    m_fullScreenWindow->raise();
}

popupwindow.cpp #

/**
 * popupwindow.cpp
 */

#include "popupwindow.h"
#include <QDateTime>
#include <QDebug>
#include <QHBoxLayout>

PopupWindow::PopupWindow(QWidget *parent)
    : m_creationTimestamp(QDateTime::currentMSecsSinceEpoch())
    , m_eventReceived(false)
    , m_text(nullptr)
{
    setAttribute(Qt::WA_DeleteOnClose);
    setMouseTracking(true);
}

void PopupWindow::mouseMoveEvent(QMouseEvent *event) {
    if (m_eventReceived) {
        return;
    }
    auto deltaTimeMs = QDateTime::currentMSecsSinceEpoch() - m_creationTimestamp;
    showText(QString("First mouse event received after %1 ms.").arg(deltaTimeMs));
    m_eventReceived = true;
}

void PopupWindow::mousePressEvent(QMouseEvent *event) {
    showNormal();
    close();
}

void PopupWindow::showText(const QString &text) {
    m_text = new QLabel(text);
    m_text->setStyleSheet("font: 26pt;");
    auto *layout = new QVBoxLayout(this);
    layout->addWidget(m_text, Qt::AlignCenter);
}

问题分析与解决方案 #

延迟原因 #

1. macOS系统全屏动画机制：macOS原生全屏窗口会触发过渡动画（如淡入、缩放效果），系统在动画执行期间会暂时拦截鼠标事件，直到动画完成才传递给窗口，这是核心延迟来源。
2. Qt全屏初始化流程：Qt调用showFullScreen()后，需向macOS窗口服务器申请全屏资源、调整窗口层级、初始化GPU渲染上下文，这些操作比普通窗口更复杂，耗时更长。
3. 窗口状态确认延迟：Qt需要等待系统确认窗口已进入全屏状态后，才会开始处理鼠标事件，这个等待过程进一步增加了延迟。

解决办法 #

1. 禁用全屏过渡动画：在PopupWindow构造函数中添加Qt针对macOS的专属属性，关闭系统全屏动画：

   PopupWindow::PopupWindow(QWidget *parent)
       : m_creationTimestamp(QDateTime::currentMSecsSinceEpoch())
       , m_eventReceived(false)
       , m_text(nullptr)
   {
       setAttribute(Qt::WA_DeleteOnClose);
       setMouseTracking(true);
       // 禁用macOS全屏过渡动画
       setAttribute(Qt::WA_MacFullScreenAnimation, false);
   }
   

2. 提前初始化窗口：不在用户点击按钮时才创建全屏窗口，提前在MainWindow构造函数中创建并隐藏，需要时直接调用showFullScreen()：

   MainWindow::MainWindow(QWidget *parent)
       : m_normalScreenWindow(nullptr)
       , m_fullScreenWindow(new PopupWindow(this))
   {
       m_fullScreenWindow->hide();
       // 其他初始化代码...
   }
   
   void MainWindow::handleFullScreenButton() {
       m_fullScreenWindow->showFullScreen();
       m_fullScreenWindow->activateWindow();
       m_fullScreenWindow->raise();
   }
   

3. 优化窗口内容初始化：将PopupWindow的布局和控件初始化提前到构造函数，避免在首个鼠标事件时才创建，减少事件处理延迟：

   PopupWindow::PopupWindow(QWidget *parent)
       : m_creationTimestamp(QDateTime::currentMSecsSinceEpoch())
       , m_eventReceived(false)
   {
       setAttribute(Qt::WA_DeleteOnClose);
       setMouseTracking(true);
       setAttribute(Qt::WA_MacFullScreenAnimation, false);
       // 提前创建布局和标签
       auto *layout = new QVBoxLayout(this);
       m_text = new QLabel();
       m_text->setStyleSheet("font: 26pt;");
       layout->addWidget(m_text, Qt::AlignCenter);
       m_text->hide();
   }
   
   void PopupWindow::showText(const QString &text) {
       m_text->setText(text);
       m_text->show();
   }
   

4. 调用原生API进入全屏：绕过Qt封装，直接调用macOS的NSWindow API实现全屏，减少中间层延迟（需引入Objective-C代码）：

   #include <QtMacExtras/QMacNativeWidget>
   #include <objc/objc.h>
   
   void MainWindow::handleFullScreenButton() {
       m_fullScreenWindow = new PopupWindow(this);
       m_fullScreenWindow->show();
       // 获取原生NSWindow指针
       NSWindow *nativeWindow = reinterpret_cast<NSWindow*>(m_fullScreenWindow->winId());
       // 调用原生方法进入全屏
       [nativeWindow toggleFullScreen:nil];
       m_fullScreenWindow->activateWindow();
       m_fullScreenWindow->raise();
   }
   

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