记录 PyQt6 / PySide 6 自定义边框窗口的 Bug 及可能可行的解决方案：窗口抖动和添加 DWM 环绕阴影的大致原理

本文主要是介绍记录 PyQt6 / PySide 6 自定义边框窗口的 Bug 及可能可行的解决方案：窗口抖动和添加 DWM 环绕阴影的大致原理，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

前言：

本篇文章将要讨论我在前不久发表的关于 PyQt6 / PySide6 自定义边框窗口代码及内容中的问题：

（终）PyQt6 / PySide 6 + Pywin32 自定义标题栏窗口 + 完全还原 Windows 原生窗口边框特效_pyside6 win32 无边框窗口-CSDN博客https://blog.csdn.net/2402_84665876/article/details/141535937?spm=1001.2014.3001.5501

问题：

1. 窗口右边框和下边框的抖动问题：

这算是 FramelessWindowHint 的通病，在 UI 基于 Qt 的应用程序中，大多数去掉系统边框的应用都会发生在拖拽窗口顶部，右上方或左侧调整大小时窗口右侧和底部发生抖动的情况，比如 123 云盘的 Windows 客户端，OpenShot 和 QtFramelessWindow 第三方库，这是我推测的调整大小的信号传输步骤：

无论如何，当你调整一个自定义窗口的大小时，NativeEvent 和 resizeEvent 事件在同时进行，但由于两个事件不是平级关系，NativeEvent 将比 resizeEvent 先一步收到系统通知，这导致窗口调整大小时会出现延迟现象。

2.添加 DWM 阴影不等于窗口绘制：

在【前言】所提到的文章中，我曾备注过这样一段话：

注：使用此方法给窗口添加 DWM 阴影实际上就是新建了一个空白的带阴影的窗口，再将自己创建的窗口绘制到该窗口上（覆盖原有标题栏），所以修改后的窗口拖动和改变大小时占用的 CPU 和内存资源大概是未添加阴影时的 2~3 倍甚至更多，当系统刚启动时或外部应用占用的 CPU 和内存资源过多时，拖动和缩放窗口会出现明显的卡顿。

其实这种说法是错误的，窗口图形的 ”边界“ 和系统给窗口的 ”边框“ 并不是一回事，添加阴影的原理是利用 Windows 的桌面窗口管理器 (DWM) 来扩展窗口的框架区域，使得阴影效果能够显示在窗口周围。这种效果是 DWM 在窗口外框绘制阴影，而不是实际改变窗口本身的边界或形状。

问题原因和可能可行的解决方案：

* 这篇文章并没有给出解决问题后的代码，因为我也正在尝试用此方法解决问题。

** 答案来源：ChatGPT 4

原问题: 为什么给窗口设置 `FramelessWindowHint` 后，调整大小时窗口的右侧或底部边界会发生“抖动”？有没有办法解决这个问题？

当设置 `FramelessWindowHint` 时，Qt 窗口会失去原生的 Windows 标题栏和边框。此时，Qt 本身负责处理窗口的边界调整和绘制。这可能导致调整大小时的抖动问题，尤其是在应用 `DwmExtendFrameIntoClientArea` 时，因为这会修改窗口的视觉区域。

抖动的原因：抖动问题通常由以下几个原因导致：
- 不一致的窗口区域更新：DWM 扩展区域和 Qt 本身的窗口边界之间可能出现同步问题。DWM 更新边界时，窗口内容有时可能会滞后于实际的框架阴影扩展，导致“抖动”或闪烁。
- 多线程或异步绘制冲突：窗口边界调整和重新绘制过程中的线程不安全操作或异步更新可能导致这种抖动。
解决方法：
- 同步更新：确保 DwmExtendFrameIntoClientArea 和窗口大小调整同步。你可以在大小调整事件中调用 DwmExtendFrameIntoClientArea 来重新设置边界。
- 使用 Win32 API 的原生调整大小：使用 Windows API 的原生窗口调整大小处理，而不是 Qt 的事件。你可以捕获窗口的 WM_NCHITTEST 消息来处理拖动和调整大小区域，从而保留原生行为。
- 避免频繁调用 DWM 扩展：在窗口大小调整过程中，避免频繁调用 DwmExtendFrameIntoClientArea。可以尝试只在初始化时调用一次。