Qt设置无边框窗口后如何恢复窗口最大化/最小化/关闭等动画效果

我之前也踩过这个坑！用Qt.WindowType.FramelessWindowHint去掉默认窗口框架后，Windows自带的最大化、最小化、关闭动画直接消失了，体验感瞬间下降。你尝试用WinAPI修改窗口样式的思路是对的，但应该是细节没处理到位才导致效果怪异，我来给你捋捋正确的做法：

首先得明白为什么动画会消失：FramelessWindowHint本质上是移除了窗口的WS_CAPTION和WS_THICKFRAME这些系统样式，而Windows的窗口动画是依赖这些样式来识别“标准窗口”的，所以去掉后动画就失效了。我们要做的就是偷偷补回这些样式，但不让Qt显示默认的窗口框架。

下面是具体的实现步骤，以PyQt5为例：

1. 先定义好需要的WinAPI常量 #

很多人踩坑就是因为常量定义不对，先把这些基础的常量写好：

import ctypes
from ctypes import wintypes
from PyQt5.QtWidgets import QMainWindow
from PyQt5.QtCore import Qt

# 初始化WinAPI相关常量和函数
user32 = ctypes.WinDLL('user32', use_last_error=True)

GWL_STYLE = -16
WS_CAPTION = 0x00C00000       # 窗口标题栏样式（用于触发系统动画）
WS_THICKFRAME = 0x00040000    # 可调整大小的边框样式
WS_MINIMIZEBOX = 0x00020000   # 最小化按钮（可选，根据需求添加）
WS_MAXIMIZEBOX = 0x00010000   # 最大化按钮（可选）

# SetWindowPos的参数常量
SWP_NOMOVE = 0x0002
SWP_NOSIZE = 0x0001
SWP_FRAMECHANGED = 0x0020     # 强制窗口刷新框架样式，关键！

2. 在窗口类中正确修改样式 #

重点是要在窗口显示之后再修改WinAPI样式，比如在showEvent方法里处理，因为窗口未显示时，winId()还没绑定到有效的Windows句柄，修改了也不会生效：

class CustomFramelessWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 先设置Qt的无边框标志
        self.setWindowFlags(Qt.WindowType.FramelessWindowHint | Qt.Window)
        
        # 这里写你的自定义窗口框架初始化代码，比如自定义标题栏、按钮等
        self.init_ui()

    def init_ui(self):
        # 示例：设置窗口大小和标题
        self.setGeometry(100, 100, 800, 600)
        self.setWindowTitle("自定义无边框窗口")

    def showEvent(self, event):
        super().showEvent(event)
        # 获取当前窗口的Windows句柄
        hwnd = wintypes.HWND(int(self.winId()))
        # 获取当前窗口的样式
        current_style = user32.GetWindowLongW(hwnd, GWL_STYLE)
        # 补回需要的系统样式
        new_style = current_style | WS_CAPTION | WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX
        # 应用新样式
        user32.SetWindowLongW(hwnd, GWL_STYLE, new_style)
        # 强制窗口刷新框架，这一步是解决你之前效果怪异的核心
        user32.SetWindowPos(hwnd, None, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_FRAMECHANGED)

关键细节说明 #

• 为什么要在showEvent里修改？：窗口刚初始化时，Qt还没完成和Windows窗口句柄的绑定，这时候修改样式不会被系统识别，必须等窗口显示后再操作。
• SWP_FRAMECHANGED的作用：这个标志会告诉Windows重新计算窗口的非客户区布局，确保我们修改的样式正确生效，不加的话很容易出现边框错位、动画卡顿或者样式不生效的问题。
• 可选样式调整：如果你不需要最小化/最大化按钮，可以去掉WS_MINIMIZEBOX和WS_MAXIMIZEBOX，只保留WS_CAPTION和WS_THICKFRAME也能恢复动画效果。

额外提示 #

补回WS_THICKFRAME后，Windows可能会默认允许通过边框调整窗口大小，如果你的自定义框架已经实现了自己的大小调整逻辑，可能需要额外处理鼠标事件来覆盖默认行为，避免冲突。

内容来源于stack exchange