Qt无边框窗口还原状态下无法显示调整大小手柄问题求助

要解决无边框窗口还原状态下看不到调整手柄的问题，核心是让系统识别窗口的边缘区域，同时处理好窗口状态切换逻辑，以下是具体实现步骤：

关键处理点 #

• 设置正确的窗口属性
  初始化窗口时，保留可调整大小的基础属性，同时启用无边框：

  setWindowFlags(Qt::FramelessWindowHint | Qt::Window | Qt::WindowMinMaxButtonsHint);
  setMinimumSize(400, 300); // 设置最小尺寸，避免窗口缩至异常大小
  

• 重写nativeEvent处理系统消息（Windows平台）
  通过处理Windows的WM_NCHITTEST消息，让系统识别窗口边缘，自动显示系统自带的调整手柄：

  bool YourFramelessWindow::nativeEvent(const QByteArray &eventType, void *message, long *result)
  {
      if (eventType == "windows_generic_MSG") {
          MSG *msg = static_cast<MSG*>(message);
          if (msg->message == WM_NCHITTEST && !isMaximized()) { // 仅还原状态下触发
              *result = 0;
              const LONG borderWidth = 8; // 边缘触发区域宽度，可按需调整
              RECT winRect;
              GetWindowRect(reinterpret_cast<HWND>(winId()), &winRect);
              LONG x = GET_X_LPARAM(msg->lParam) - winRect.left;
              LONG y = GET_Y_LPARAM(msg->lParam) - winRect.top;
  
              // 检测四个角
              if (x <= borderWidth && y <= borderWidth) { *result = HTTOPLEFT; return true; }
              if (x >= (winRect.right - winRect.left) - borderWidth && y <= borderWidth) { *result = HTTOPRIGHT; return true; }
              if (x <= borderWidth && y >= (winRect.bottom - winRect.top) - borderWidth) { *result = HTBOTTOMLEFT; return true; }
              if (x >= (winRect.right - winRect.left) - borderWidth && y >= (winRect.bottom - winRect.top) - borderWidth) { *result = HTBOTTOMRIGHT; return true; }
  
              // 检测四条边
              if (x <= borderWidth) { *result = HTLEFT; return true; }
              if (x >= (winRect.right - winRect.left) - borderWidth) { *result = HTRIGHT; return true; }
              if (y <= borderWidth) { *result = HTTOP; return true; }
              if (y >= (winRect.bottom - winRect.top) - borderWidth) { *result = HTBOTTOM; return true; }
          }
      }
      return QWidget::nativeEvent(eventType, message, result);
  }
  

• 状态切换时的逻辑处理
  自定义最大化/还原按钮时，确保状态切换正确，最大化时禁用边缘调整触发：

  void YourFramelessWindow::onMaximizeBtnClicked()
  {
      if (isMaximized()) {
          showNormal();
      } else {
          showMaximized();
      }
  }
  

跨平台注意事项 #

• Linux：系统默认不会显示调整手柄，需通过重写mouseMoveEvent手动切换光标样式，结合resize()实现拖拽调整，或依赖桌面环境的窗口管理支持。
• macOS：可通过QWindow::setContentMargins设置边缘触发区域，重写鼠标事件处理，或调用原生API添加NSResizableWindowMask属性。

内容的提问来源于stack exchange，提问作者Lalit Meena