setlayeredwindowattributes是最轻量、兼容性最好的窗口透明方案，适用于win2000及以上系统，需窗口具备ws_ex_layered样式且为顶层窗口，alpha值范围为0–255，支持lwa_alpha（整体透明）和lwa_colorkey（颜色键透明）及其组合。
Windows平台用SetLayeredWindowAttributes设置窗口透明
直接调用 SetLayeredWindowAttributes 是最轻量、兼容性最好的方式，适用于 Win2000 及以上系统，不需要启用 DWM 或依赖 UWP。关键前提是窗口必须带 WS_EX_LAYERED 扩展样式，且不能是子窗口（即必须是顶层窗口或弹出式窗口）。
常见错误是：创建窗口时没加 WS_EX_LAYERED，或者之后用 SetWindowLong 动态添加但没触发重绘；也有人误传 alpha 值为 0–100 范围，实际应为 0–255。
- 创建窗口时在
CreateWindowEx的第一个参数传入WS_EX_LAYERED - 调用
SetLayeredWindowAttributes(hWnd, 0, 150, LWA_ALPHA)即可让整个窗口半透明（alpha=150） - 若想按颜色键（如纯绿背景）透明，用
LWA_COLORKEY，第三个参数填 RGB 值（如RGB(0,255,0)），注意需确保窗口内容不含该色，否则文字/控件也会被抠掉 - 混合使用
LWA_ALPHA | LWA_COLORKEY是允许的，但某些旧显卡驱动下可能表现异常
用UpdateLayeredWindow实现逐像素Alpha（支持PNG贴图）
当需要非矩形窗口、阴影、渐变边缘或 PNG 图像作为窗口外观时，UpdateLayeredWindow 是唯一可靠选择。它绕过 GDI 绘制流程，直接提交带 Alpha 通道的位图到桌面合成器，但代价是：必须自己管理图像缓冲区、每次更新都要重传整张图、无法响应标准 WM_PAINT。
典型失败场景：传入的 BLENDFUNCTION 中 AlphaFormat 设为 0（即未设 AC_SRC_ALPHA），导致透明通道被忽略；或位图格式不是 PIXELFORMAT::PF_RGB32（即每像素 4 字节，BGRA 排列）。
- 位图数据必须是 BGRA 格式（蓝、绿、红、Alpha），Windows 不接受 RGBA
-
BLENDFUNCTION中SourceConstantAlpha设为 255 表示完全使用图像自身 Alpha；设为 128 则整体再压暗一层 - 频繁调用
UpdateLayeredWindow会明显影响性能，建议只在内容变更时调用，不要放进定时器循环 - 如果窗口有子控件（如按钮），它们不会自动跟随透明效果——必须用无边框子窗口模拟，或改用 DWM 的
DwmExtendFrameIntoClientArea
启用DWM后用DwmExtendFrameIntoClientArea做“毛玻璃”式透明
这是 Vista 及以后系统才支持的方式，本质是把客户区“扩展”进原本属于标题栏的区域，并由 DWM 自动应用模糊渲染。它不控制窗口整体透明度，而是让客户区背景呈现高斯模糊效果，适合现代 UI 场景。
容易被忽略的是：即使启用了 DWM，若窗口没有正确设置 WS_CAPTION 或 WS_SYSMENU，DwmExtendFrameIntoClientArea 可能静默失败；另外，模糊效果在远程桌面或禁用 AERO 的系统上会退化为纯黑或纯白背景。
- 调用前先检查
DwmIsCompositionEnabled返回 TRUE - 传入的
MARGINS结构体中四个值全设为 -1 表示“扩展全部客户区”，设为 0 表示不扩展 - 必须配合
WS_CLIPCHILDREN | WS_CLIPSIBLINGS风格，否则子控件绘制会错位 - 此方法无法和
SetLayeredWindowAttributes混用——一旦启用 DWM 扩展，LWA_ALPHA就失效
Qt或wxWidgets等框架里怎么安全启用透明
跨平台框架通常封装了底层 API，但默认不开启透明支持，因为涉及渲染路径切换和事件穿透逻辑。比如 Qt 的 setAttribute(Qt::WA_TranslucentBackground) 必须配合 setWindowFlags(Qt::FramelessWindowHint)，否则在 Windows 上会被忽略；而 wxWidgets 的 SetTransparent() 在非 Windows 平台行为差异极大（GTK 下仅支持整窗 alpha，macOS 下需 NSView 层级支持）。
最大陷阱是：框架内部可能用双缓冲绘图，若未重写 paintEvent 并手动填充透明背景（如用 fillRect(rect(), Qt::transparent)），窗口仍显示为灰色或黑色。
- Qt 中务必在
paintEvent里用QPainter::fillRect清空背景，否则透明无效 - wxWidgets 调用
SetTransparent(128)后，需确保窗口没有wxCLIP_CHILDREN样式干扰重绘 - 所有框架下，透明窗口默认不接收鼠标事件（尤其
LWA_COLORKEY区域），需额外处理WS_EX_TRANSPARENT或重写HitTest - 调试时可用 Windows 自带的
WinSpy++查看窗口实际样式和扩展属性是否生效
真正难的不是调哪个函数，而是搞清当前窗口的层级关系、DWM 状态、GDI 渲染路径是否被框架劫持——很多“透明失效”问题，根源是窗口被父容器裁剪、被 DPI 缩放打乱像素对齐，或是多显示器缩放不一致导致 Alpha 通道解析错位。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
