QT/C++：无边框窗口如何保留系统默认打开/关闭动画

我之前也碰到过一模一样的困扰——自定义标题栏后，系统自带的缩放+淡入淡出动画就凭空消失了，自己写的动画总达不到原生的流畅度和兼容性。后来摸索出几个依赖Windows DWM（桌面窗口管理器）原生API的解决方案，完美保留了系统原生动画：

方法一：通过DWM扩展框架隐藏标题栏（推荐） #

别直接用Qt::FramelessWindowHint，而是通过DWM API来隐藏默认标题栏和边框，这样能保留窗口与DWM的关联，系统动画自然会生效。

步骤与代码示例： #

1. 先设置窗口标志，保留基础窗口属性同时允许自定义：

setWindowFlags(Qt::CustomizeWindowHint | Qt::WindowTitleHint | Qt::WindowMinMaxButtonsHint); // 可根据需求保留最小化/最大化按钮

2. 在窗口的showEvent中调用DWM API修改窗口属性：

#include <windows.h>
#include <dwmapi.h>
#pragma comment(lib, "dwmapi.lib") // 链接DWM库

void YourCustomWindow::showEvent(QShowEvent *event)
{
    QMainWindow::showEvent(event); // 调用父类方法

    HWND hwnd = reinterpret_cast<HWND>(winId()); // 获取Qt窗口对应的Win32句柄

    // 启用DWM非客户区渲染，确保系统动画能识别窗口
    DWMNCRENDERINGPOLICY renderPolicy = DWMNCRP_ENABLED;
    DwmSetWindowAttribute(hwnd, DWMWA_NCRENDERING_POLICY, &renderPolicy, sizeof(renderPolicy));

    // 让DWM扩展框架到整个客户区，隐藏默认标题栏和边框
    MARGINS margins = {0};
    margins.cxLeftWidth = -1; // -1表示扩展覆盖整个窗口区域
    DwmExtendFrameIntoClientArea(hwnd, &margins);
}

操作后默认标题栏会被隐藏，你可以在窗口客户区自由绘制自定义标题栏（关闭按钮、标题文本、主题样式等），同时系统的窗口打开/关闭动画完全保留。

方法二：修复已使用Qt::FramelessWindowHint的窗口动画 #

如果已经基于Qt::FramelessWindowHint开发，可以通过手动恢复DWM的动画属性找回系统动画：

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

    HWND hwnd = reinterpret_cast<HWND>(winId());

    // 强制启用DWM过渡动画
    BOOL disableTransitions = FALSE;
    DwmSetWindowAttribute(hwnd, DWMWA_TRANSITIONS_FORCEDISABLED, &disableTransitions, sizeof(disableTransitions));

    // 恢复标准窗口样式（Frameless会把窗口设为WS_POPUP，系统动画更适配WS_OVERLAPPEDWINDOW）
    LONG windowStyle = GetWindowLongPtr(hwnd, GWL_STYLE);
    windowStyle |= WS_OVERLAPPEDWINDOW;
    SetWindowLongPtr(hwnd, GWL_STYLE, windowStyle);
}

这个方法适合已有Frameless窗口开发基础的场景，能快速找回动画效果。

关键原理 #

Windows的窗口动画由DWM负责管理，当Qt设置Qt::FramelessWindowHint时，会将Win32窗口样式改为WS_POPUP，并关闭DWM的非客户区渲染，导致DWM不再为该窗口提供动画。上面的方法都是通过重新建立窗口与DWM的关联，让系统认为这是一个标准窗口，从而保留原生动画的流畅度和兼容性，完全不需要自己实现动画逻辑。

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