禁用原生标题栏后系统按钮失效，需手动补全交互：重写mousePressEvent等实现拖动，nativeEvent中处理WM_NCHITTEST以支持双击最大化、边缘缩放及任务栏预览，按钮须关闭WA_TransparentForMouseEvents并正确连接信号。
Qt 窗口禁用原生标题栏后，系统按钮失效怎么办
直接调用 setWindowFlags(Qt::FramelessWindowHint) 会彻底去掉标题栏和系统控制区，此时 showMinimized()、showMaximized()、close() 仍可调用，但窗口不再响应双击标题栏最大化、拖拽边框调整大小、Alt+Space 菜单等系统级交互。必须手动补全这些行为。
关键不是“画几个按钮”，而是让自定义区域承担原生标题栏的底层职责：捕获鼠标事件做窗口移动/缩放、拦截系统快捷键、同步窗口状态（如最大化时禁用最大化按钮图标）。
- 必须重写
mousePressEvent()、mouseMoveEvent()、mouseReleaseEvent()实现拖动 —— 仅靠QTitleBar类无法自动绑定 - 最大化/还原需调用
showNormal()或showMaximized()，并手动切换按钮图标与 tooltip - Windows 下需额外处理
nativeEvent()拦截WM_NCHITTEST，否则右键任务栏预览、Aero Snap（拖到屏幕边缘自动贴边）会失效
怎么让自定义标题栏支持双击最大化和拖拽边缘缩放
Qt 默认不将鼠标事件转发给无边框窗口的非客户区，所以双击或拖拽边缘不会触发任何动作。必须在 nativeEvent() 中主动处理 Windows 消息，或在 eventFilter() 中拦截 QEvent::NonClientAreaMouseButtonDblClick（仅 Qt 6.5+ 支持）。
最兼容的做法是：在主窗口类中重写 nativeEvent(const QByteArray &eventType, void *message, long *result)，对 WM_NCHITTEST 返回 HTCAPTION（让系统认为点击的是标题栏）、HTMAXBUTTON、HTMINBUTTON、HTCLOSE 等值，再配合 QApplication::setAttribute(Qt::AA_DontCreateNativeWidgetSiblings) 避免子控件干扰。
立即学习“C++免费学习笔记（深入）”；
- 返回
HTLEFT/HTRIGHT/HTTOP/HTBOTTOM可启用边缘缩放，但需确保自定义标题栏高度固定、不随内容变化 - 双击标题栏最大化：在
mouseDoubleClickEvent()中判断点击位置是否在标题栏区域，再调用isMaximized() ? showNormal() : showMaximized() - Linux/X11 下需用
X11Functions::xcb_connection()手动发 _NET_WM_STATE 消息，macOS 则依赖NSWindow的私有 API，跨平台建议优先适配 Windows + Linux Wayland（通过qApp->platformName()分支处理）
最小化/最大化/关闭按钮点击没反应？检查信号连接和事件传播
常见错误是把按钮放在 QHBoxLayout 里，但父布局容器未设置 setMouseTracking(true)，或按钮本身被 setFocusPolicy(Qt::NoFocus) 拦截了鼠标事件；更隐蔽的问题是：自定义标题栏 QWidget 设置了 setAttribute(Qt::WA_TransparentForMouseEvents)（用于透传点击），却忘了在按钮上显式关闭该属性。
- 每个按钮必须独立调用
button->setAttribute(Qt::WA_TransparentForMouseEvents, false) - 避免在标题栏 widget 上安装事件过滤器时无条件返回
true，这会吞掉所有子控件事件；应只对非按钮区域返回true - 使用
QPushButton::setFlat(true)去除边框，但必须手动设置setStyleSheet("QPushButton:hover { background: #e0e0e0; }")提供视觉反馈，否则用户无法感知可点击 - 关闭按钮建议连接
QApplication::quit()而非close()，防止主窗口被QMainWindow的QCloseEvent拦截后静默退出
Qt 6.7+ 推荐用 QWindow + QGuiApplication 替代 QWidget 吗
不推荐。虽然 QWindow 更底层、能完全绕过平台原生窗口管理器，但代价是失去 QVBoxLayout、QPainter 绘图、样式表支持等核心便利性。绝大多数业务场景下，用 QWidget + Qt::FramelessWindowHint + nativeEvent 就足够稳定。
真正需要 QWindow 的只有两类情况：一是实现异形窗口（如圆形、带镂空区域）、二是嵌入 OpenGL/Vulkan 渲染上下文且要求零延迟。普通自定义标题栏反而因 QWindow 缺少 widget 生命周期管理，容易导致按钮悬停状态残留、焦点丢失后无法恢复等问题。
- Qt 6.7 新增的
QQuickWindow::setFlag(Qt::FramelessWindowHint)仅适用于 QML 场景，C++ 侧无对应简化接口 - 如果项目已用 Qt Quick Controls 3，可考虑用
Window+FramelessWindow模块，但需放弃 QWidget 生态下的成熟控件库（如 QtitanRibbon） - 最终上线前务必在 Windows 10/11 高 DPI 缩放（125%、150%）下测试按钮热区是否偏移 —— 这是最常被忽略的兼容性点
