如何以编程方式触发Qt/C++无框窗口的最大化动画？

嗨，我完全懂你的困扰——无框窗口确实会丢掉Windows系统默认的不少交互反馈，比如你说的顶部拖拽时的蓝色波浪预览动画。这个动画其实是Windows DWM（桌面窗口管理器）Snap Assist功能的一部分，标准窗口因为自带框架，系统会自动处理，但无框窗口得我们手动对接系统API才能实现。下面是具体的解决方案：

核心思路 #

Qt的Qt::FramelessWindowHint会移除窗口的标准风格（比如WS_CAPTION和WS_THICKFRAME），导致DWM没法识别它是支持Snap操作的窗口。我们要做两件关键的事：

1. 恢复必要的窗口风格，让DWM把它当成可交互的标准窗口
2. 告诉系统窗口顶部区域是“拖拽标题栏”区域，触发系统的Snap逻辑

具体实现步骤 #

1. 添加必要的窗口风格 #

在主窗口的构造函数里，通过Win32API给窗口补上WS_CAPTION和WS_THICKFRAME风格（这俩是DWM识别Snap的前提，即使是无框窗口也需要）：

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

YourMainWindow::YourMainWindow(QWidget *parent) : QMainWindow(parent)
{
    setWindowFlags(Qt::FramelessWindowHint); // 保留你的无框设置

    // 获取窗口的HWND句柄
    HWND hwnd = reinterpret_cast<HWND>(winId());
    // 读取当前窗口风格
    LONG windowStyle = GetWindowLong(hwnd, GWL_STYLE);
    // 添加必要的风格标记
    windowStyle |= WS_CAPTION | WS_THICKFRAME;
    SetWindowLong(hwnd, GWL_STYLE, windowStyle);

    // 启用DWM非客户端区域渲染
    DWMNCRENDERINGPOLICY renderPolicy = DWMNCRP_ENABLED;
    DwmSetWindowAttribute(hwnd, DWMWA_NCRENDERING_POLICY, &renderPolicy, sizeof(renderPolicy));
}

2. 处理WM_NCHITTEST消息，标记顶部区域为标题栏 #

系统只有识别到用户拖拽的是标题栏区域，才会触发Snap动画。我们重写Qt的nativeEvent来处理Win32的WM_NCHITTEST消息，把窗口顶部区域标记为标题栏：

bool YourMainWindow::nativeEvent(const QByteArray &eventType, void *message, long *result)
{
    MSG* winMsg = static_cast<MSG*>(message);

    if (winMsg->message == WM_NCHITTEST)
    {
        *result = 0;
        POINT mousePos = { LOWORD(winMsg->lParam), HIWORD(winMsg->lParam) };
        // 把屏幕坐标转成窗口客户端坐标
        ScreenToClient(winMsg->hwnd, &mousePos);

        // 定义顶部拖拽区域（比如顶部20像素，你可以根据自己的UI调整高度）
        const int titleBarHeight = 20;
        if (mousePos.y <= titleBarHeight)
        {
            // 告诉系统这是标题栏区域，触发拖拽相关的系统逻辑
            *result = HTCAPTION;
            return true;
        }

        // 可选：如果你的无框窗口需要支持resize，这里可以添加边缘识别逻辑
        // 比如左侧边缘：
        if (mousePos.x <= 5) {
            *result = HTLEFT;
            return true;
        }
        // 右侧、底部等边缘同理...
    }

    // 其他消息交给Qt默认处理
    return QMainWindow::nativeEvent(eventType, message, result);
}

3. 验证效果 #

现在你按住窗口顶部区域拖拽到屏幕顶部时，Windows系统应该会自动弹出蓝色波浪的预览动画，松开鼠标后窗口就会最大化——和标准窗口的行为完全一致。

注意事项 #

• 确保程序在支持DWM的Windows版本上运行（Windows Vista及以上）
• 如果你的窗口有自定义标题栏，记得调整titleBarHeight的值匹配实际高度
• 要是不需要resize功能，可以只保留WS_CAPTION风格，但WS_THICKFRAME能让resize逻辑更顺畅（即使你隐藏了边缘）

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