如何创建Qt Popup widget：点击按钮弹出、等宽且随主窗口附着移动

完全匹配三个核心需求：点击按钮触发弹出、弹窗宽度和触发按钮等宽、主窗口拖动时弹窗持续附着在按钮下边缘。

具体实现流程 #

• 配置Popup基础窗口属性
  先给Popup设置匹配交互特性的窗口标志，避免自己实现多余的交互逻辑：

  m_dropdownPopup = new QWidget();
  // 核心窗口标志：无边框、点击外部自动关闭、保持层级正确
  m_dropdownPopup->setWindowFlags(Qt::Popup | Qt::FramelessWindowHint | Qt::NoDropShadowWindowHint);
  m_dropdownPopup->setAttribute(Qt::WA_ShowWithoutActivating); // 弹窗弹出时不抢主窗口输入焦点
  

• 绑定按钮点击的弹出逻辑
  点击触发按钮时，完成宽度匹配、位置计算后再弹出：

  connect(m_triggerBtn, &QPushButton::clicked, this, [=](){
      // 强制弹窗宽度和触发按钮完全一致
      m_dropdownPopup->setFixedWidth(m_triggerBtn->width());
      // 计算全局坐标：把按钮左下角的屏幕位置，作为弹窗的左上角位置
      QPoint popupGlobalPos = m_triggerBtn->mapToGlobal(m_triggerBtn->rect().bottomLeft());
      m_dropdownPopup->move(popupGlobalPos);
      m_dropdownPopup->show();
  });
  

• 实现主窗口拖动时的自动跟随
  通过给应用事件循环装过滤器，监听主窗口的移动、尺寸调整事件，弹窗可见时同步更新位置和宽度：

  // 初始化阶段安装事件过滤器
  qApp->installEventFilter(this);
  
  // 重写类的eventFilter方法
  bool MainWindow::eventFilter(QObject *watched, QEvent *event)
  {
      // 仅在弹窗可见时响应主窗口的位置/尺寸变化
      if (watched == this && m_dropdownPopup->isVisible()) {
          if (event->type() == QEvent::Move || event->type() == QEvent::Resize) {
              // 重新计算弹窗位置，保持贴在按钮下边缘
              QPoint popupGlobalPos = m_triggerBtn->mapToGlobal(m_triggerBtn->rect().bottomLeft());
              m_dropdownPopup->move(popupGlobalPos);
              // 同步匹配按钮宽度，适配主窗口拉伸导致的按钮尺寸变化
              m_dropdownPopup->setFixedWidth(m_triggerBtn->width());
          }
      }
      return QMainWindow::eventFilter(watched, event);
  }
  

开发注意事项 #

• 不要把Popup的父控件设置为触发按钮本身，否则按钮被Popup遮挡时会触发按钮的重绘失效，导致Popup跟着被隐藏，父对象可直接设置为顶层主窗口
• 优先用Qt::Popup窗口类型，不要替换为Qt::Tool：Qt::Popup自带点击外部区域自动关闭、不抢焦点的特性，自己实现很容易出现点击外部不关闭、焦点混乱的问题
• 多显示器、高DPI场景下，一定要用mapToGlobal做坐标转换，硬编码相对坐标会出现弹窗偏移的问题
• 如果需要给弹窗加悬浮阴影，避免使用QGraphicsDropShadowEffect，该特效会导致弹窗重绘卡顿，建议在Popup的paintEvent中手动绘制九宫格阴影

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