Qt怎么隐藏标题栏但保留系统阴影-C++-PHP中文网

Qt无边框窗口启用DWM系统阴影需调用DwmExtendFrameIntoClientArea并设置负边距，同时拦截WM_NCHITTEST确保拖拽响应，否则仅靠Qt::FramelessWindowHint会因non-client area清空导致阴影丢失。

qt怎么隐藏标题栏但保留系统阴影

Qt 默认用 Qt::FramelessWindowHint 隐藏标题栏后，系统阴影会一并消失——这不是 bug，而是 Windows/DWM 的设计逻辑：无边框窗口（non-client area 为空）不触发 DWM 的默认阴影渲染。想“隐藏标题栏但保留系统阴影”，必须绕过纯 Qt 设置，主动向 DWM 请求启用阴影。

为什么 setWindowFlags(Qt::FramelessWindowHint) 会丢阴影

Windows 的窗口阴影由 DWM（Desktop Window Manager）自动添加，前提是窗口有非客户区（non-client area），比如标题栏、边框。一旦设为 Qt::FramelessWindowHint，整个 non-client area 被清空，DWM 就认为“这窗口不需要系统级装饰”，直接跳过阴影绘制。

常见错误现象：
– 窗口看起来“贴在桌面”上，边缘发虚或完全无层次感
– QGraphicsDropShadowEffect 可以模拟，但缩放/拖动时明显延迟或闪烁
– 全屏切换后阴影丢失，且无法恢复

Qt 自带的 QGraphicsDropShadowEffect 是客户端渲染，和 DWM 阴影不是一回事
WA_TranslucentBackground 必须配合 FramelessWindowHint 使用，但它本身不触发 DWM 阴影
仅靠样式表（border-radius + background）无法唤起 DWM 的非客户区处理

Win32 层调用 DwmExtendFrameIntoClientArea 启用系统阴影

核心是让 DWM 把阴影区域“延伸进客户区”，同时保持顶部留出透明空间供自定义标题栏使用。这需要在窗口创建后、显示前调用 Win32 API。

实操建议：

在 show() 之前或 nativeEvent() 中首次收到 WM_CREATE 时调用
传入的 margin 值决定阴影范围，推荐用负值“向内收缩”客户区，例如 {-1, -1, -1, -1}
必须确保窗口已设置 Qt::FramelessWindowHint 且背景透明（setAttribute(Qt::WA_TranslucentBackground)）

关键代码片段（C++）：

// 在 QWidget 子类中重写 nativeEvent
bool MyWindow::nativeEvent(const QByteArray &eventType, void *message, long *result)
{
    if (eventType == "windows_generic_MSG") {
        MSG *msg = static_cast<msg>(message);
        if (msg->message == WM_CREATE) {
            HWND hwnd = reinterpret_cast<hwnd>(winId());
            MARGINS margins = {-1, -1, -1, -1};
            DwmExtendFrameIntoClientArea(hwnd, &margins);
        }
    }
    return QWidget::nativeEvent(eventType, message, result);
}
</hwnd></msg>

PyQt/PySide 中调用 DwmExtendFrameIntoClientArea 的注意事项

Python 侧没有直接封装该 API，需通过 ctypes 调用 dwmapi.dll。容易踩的坑比 C++ 更多：

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

必须在窗口 show() 之后再调用，否则 winId() 可能返回 0 或无效句柄
PyQt5/6 的 winId() 返回类型不同：PyQt5 是 int，PyQt6 是 QNativeInterface::QWindowsWindow，需先调用 handle()
忘记加载 dwmapi.dll 或函数签名错误会导致 AttributeError 或静默失败

最小可用示例（PyQt5）：

import ctypes
from ctypes import wintypes
<p>dwmapi = ctypes.WinDLL("dwmapi")
DwmExtendFrameIntoClientArea = dwmapi.DwmExtendFrameIntoClientArea
DwmExtendFrameIntoClientArea.argtypes = [wintypes.HWND, ctypes.POINTER(ctypes.c_int * 4)]
DwmExtendFrameIntoClientArea.restype = wintypes.LONG</p><p>def enable_dwm_shadow(widget):
hwnd = int(widget.winId())
margins = (ctypes.c_int * 4)(-1, -1, -1, -1)
DwmExtendFrameIntoClientArea(hwnd, margins)
</p>

调用时机建议放在 widget.show() 后加 QTimer.singleShot(0, lambda: enable_dwm_shadow(widget))，避免句柄未就绪。